sintonia/docs/manual/the-airtime-log-command/index.md
Lucas Bickel 187afcb206 Add converted 2.5.x manual on top of pro manual
I tried to only merge what makes sense for us, there is still quite some cleanup needed, this commit tries to preserve the 2.5 manual as much as possible while still keeping the rare new stuff from pro.
2017-03-05 13:17:49 +01:00

2.2 KiB

The airtime-log command provides convenient access to the logging output from the services which make up the Airtime system: media-monitor, recorder, playout, liquidsoap and web.

Using this command requires root privileges (sudo on Ubuntu). Entering the command without any options returns a list of options that you can specify:

sudo airtime-log

Usage: airtime-log [options]

--view|-v <string> Display log file
        media-monitor|recorder|playout|liquidsoap|web

--dump|-d <string> Collect all log files and compress into a tarball
        media-monitor|recorder|playout|liquidsoap|web (ALL by default)

--tail|-t <string> View any new entries appended to log files in real-time
        media-monitor|recorder|playout|liquidsoap|web (ALL by default)

For example, to view the media-monitor log, you could use the command:

sudo airtime-log -v media-monitor

Use the PageUp and PageDown keys on your keyboard to navigate through the log file, or press the q key to quit the viewer.

To dump all log files and compress them into a tarball placed in the working directory, you could add the -d switch to the command:

sudo airtime-log -d

Creating Airtime logs tgz file at /root/logs/airtime-log-all-2012-11-14-16-22-02.tgz

To view just the Liquidsoap log output in real-time, you could enter the command:

sudo airtime-log -t liquidsoap

Tail liquidsoap log 2012/11/14 15:47:20 [server:3] New client: localhost.
2012/11/14 15:47:20 [server:3] Client localhost disconnected.
2012/11/14 15:47:20 [server:3] New client: localhost.
2012/11/14 15:47:20 [lang:3] dynamic_source.get_id
2012/11/14 15:47:20 [server:3] Client localhost disconnected.
2012/11/14 16:17:20 [server:3] New client: localhost.
2012/11/14 16:17:20 [server:3] Client localhost disconnected.
2012/11/14 16:17:20 [server:3] New client: localhost.
2012/11/14 16:17:20 [lang:3] dynamic_source.get_id
2012/11/14 16:17:20 [server:3] Client localhost disconnected.

Press the Ctrl+C keys to interrupt the real-time log output and return to the server console.