Tailon

From Amahi Wiki
Jump to: navigation, search

Overview

Tailon is an application that tails log files in the web browser. User authentication is required by default to prevent unauthorized access.

The application is preconfigured with many log files, but can be customized for addditional log files if needed.

Configuration

File Location: /var/hda/web-apps/tailon/html

The configuration file (tailon.yaml)can be modified to add or remove log files as needed. Currently, it provides for several log files. Only files that exist will be displayed in the web browser.

The default configuration is shown below (NOTE: recommend not making any changed to lines 1, 3, or 4 as it could break the application):

bind: 0.0.0.0:5000          # address and port to bind on
allow-transfers: true       # allow log file downloads
follow-names: false         # allow tailing of not-yet-existent files
relative-root: /            # web app root path (default: '')
commands: [tail, grep, awk] # allowed commands
tail-lines: 10              # number of lines to tail initially
wrap-lines: true            # initial line-wrapping state

files:
  - 'Amahi':                # it's possible to add sub-sections
      - '/var/log/amahi-app-installer.log'
      - '/var/log/greyhole.log'
      - '/var/log/amahi-sync.log'
      - '/var/log/amahi-anywhere.log'
      - '/var/log/hda-updates.log'
      - '/var/hda/platform/html/log/production.log'
  - 'Apache':
      - '/var/log/httpd/*_log'
  - 'Samba':
      - '/var/log/samba/?mbd.log'
  - 'MariaDB':
      - '/var/log/mariadb/mariadb.log'      
  - 'System':
      - '/var/log/boot.log'
      - '/var/log/cron'
      - '/var/log/dnf.log'
      - '/var/log/maillog'
      - '/var/log/messages'
      - '/var/log/monit.log'
      - '/var/log/openvpn-status.log'
      - '/var/log/secure'
  - 'Tailon':
      - '/var/log/tailon.log'
  
http-auth: basic            # enable authentication (optional)
users:                      # password access (optional)
  admin: admin

Log Files

Log files can be added, removed, or changed by updating the configuration file. Optionally, logs can be grouped together using sub-sections. By grouping, it determines the order they appear in the application. If grouping is not used, logs will appear in the drop down list in alphabetical order.

To include new log files, follow the format as follows (grouped; indent 2 spaces for the group and 4 for the log):

  - 'MyLog':
    - 'path/to/log/name'

or (ungrouped; indent 2 spaces for the log)

  - 'path/to/log/name'

Once complete, restart the service:

sudo systemctl restart tailon

Authentication

Users/Passwords can be added, removed, or changed by modifying the configuration file. Follow the format for the default user/password.

If no authentication is desired, comment out the following lines as such (precede line with #):

#http-auth: basic            # enable authentication (optional)
#users:                      # password access (optional)
#  admin: admin

Restart the service to apply the changes:

sudo systemctl restart tailon

Troubleshooting

If you have any issues, recommend you verify there are no errors in the configuration file. Most often a missing, incorrect, or stray operand is the culprit.