The airtime-log command

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

The server console will display something like the following output:

2012-10-26 11:38:42,284 INFO - [MainThread] [mm2.py : main()] : LINE 58 - Attempting to create index file:...
2012-10-26 11:38:42,285 INFO - [MainThread] [mm2.py : main()] : LINE 64 - Created index file, reloading configuration:
2012-10-26 11:38:42,287 INFO - [MainThread] [mm2.py : main()] : LINE 68 - Already tried to create index. Will not try again
2012-10-26 11:38:42,287 INFO - [MainThread] [mm2.py : main()] : LINE 73 - Attempting to set the locale...
2012-10-26 11:38:42,289 INFO - [MainThread] [watchersyncer.py : __init__()] : LINE 79 - Created timeout thread...
2012-10-26 11:38:42,302 INFO - [Thread-2] [replaygainupdater.py : run()] : LINE 69 - Runnning replaygain updater
2012-10-26 11:38:42,940 INFO - [MainThread] [api_client.py : setup_media_monitor()] : LINE 379 - Connected to Airtime Server. Json Media Storage Dir: {u'watched_dirs': [], u'stor': u'/srv/airtime/stor/'}

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.