Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Configuration
= Overview =
[https://www.amahi.org/apps/tailon Tailon] is an application that ''tails'' log files in the web browser. User authentication is required by default to prevent unauthorized access.
= Configuration =
'''Configuration File Location:''' ''/var/hda/web-apps/tailon/html/tailon.yaml''
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 DO NOT making any changed changes to lines 1, 3, or 4 as it could will break the application):
<pre>
bind: 0.0.0.0:5000 # address and port to bind onallow-transfers: true # allow log file downloadsfollow-names: false # allow tailing of not-yet-existent filesrelative-root: / # web app root path (default: '')commands: [tail, grep, awk, sed] # allowed commandstail-lines: 10 # number of lines to tail initiallywrap-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/boot.log'
- '/var/log/cron'
- '/var/log/dnf.rpm.log'
- '/var/log/maillog'
- '/var/log/messages'
- '/var/log/tailon.log'
http-auth: basic # enable authentication (optional)users: # password access (optional)
admin: admin
</pre>
== Log Files ==
Log files can be added, removed, or changed by updating the configuration file. They 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 (grouped), follow the format as follows(grouped; indent 2 spaces for group, 4 for the log):
<pre>
- 'MyLog':
- 'path/to/log/namefilename'
</pre>
or (ungrouped; indent 2 spaces for the log)
<pre>
- 'path/to/log/namefilename'
</pre>
Once complete, restart the service:
sudo systemctl restart tailon
Check the service status to ensure there are no errors:
sudo systemctl status tailon
== Authentication ==
Restart the service to apply the changes:
sudo systemctl restart tailon
Check the service status to ensure there are no errors:
sudo systemctl status 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.
