Tailon

From Amahi Wiki
Jump to: navigation, search
Msgbox-WOPr.png Work In Progress
This article is currently undergoing major expansion or restructuring. You are welcome to assist by editing it as well. If this article has not been edited in several days, please remove this template.


Overview

Tailon is an application that tails log files in the web browser.

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

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. They can be grouped together using sub-sections. By grouping, it determines the order they appear in the application.

To include new log files (grouped), follow the format as follows:

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

or (ungrouped)

  - '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