Single web front end for jsonstats.

• Only requires Python (w/ simplejson if 2.4 or 2.5)
• Python 2.4+ compatible
• Simple filesystem based caching
• Access and application logging
• JSON based configuration
• Bookmarkable hosts
• host and environment REST endpoints
• Ajaxy
• Unit tested
• Optional reload of standalone server on configuration update

Use ./setup.py test from the main directory to execute unittests.

Configuration of the server is done in JSON and is by default kept in the current directories config.json file. You can override the location by setting TALOOK_CONFIG_FILE environment variable or using the -c/--config switch on the all in one server.

{
    "hosts": {
        "somehost.example.com": "prod",
        "another.host.example.com": "prod",
        "aqasystem.example.com": "qa",
        "127.0.0.1": "dev"
    },

    "extranotes": "http://munin.mysite.com/%s.html",
    "endpoint": "http://%s:8008/",
    "templatedir": "/var/www/talook/templates/",
    "logdir": "/var/logs/talook/",
    "staticdir": "/srv/www/talook/static/",
    "timeout": 3
}

{
    "hosts": {
        "somehost.example.com": "prod",
        "another.host.example.com": "prod",
        "aqasystem.example.com": "qa",
        "127.0.0.1": "dev"
    },

    "extranotes": "http://munin.mysite.com/%s.html",
    "endpoint": "http://%s:8008/",
    "templatedir": "/var/www/talook/templates/",
    "cachedir": "/var/cache/talook/",
    "cachetime": {"hours": 1},
    "logdir": "/var/logs/talook/",
    "staticdir": "/srv/www/talook/static/",
    "timeout": 3
}

Index page. What a user will interact with.

Returns JSON data listing all configured hosts.

Returns JSON data listing all configured environments.

Returns stats for a specific host in JSON format. Cache is used if available.

Returns a static file from the static directory.

Returns stats for a specific host in the UI. This is helpful for bookmarking hosts.

There are two log file which are produced by a running instance.

• talook_access.log: Access log similar to apache's access log.
• talook_app.log: Application level logging which logs some logic results.

1. Edit the configuration file
2. Check to see what options you want to use with --help
3. python server.py --listen 0.0.0.0 --port 8008 --config ./config.json

$ ./server.py --help
Usage: server.py [options]

Options:
  -h, --help            show this help message and exit
  -c CONFIG, --config=CONFIG
                        Config file to read (Default: config.json
  -p PORT, --port=PORT  Port to listen on. (Default: 8080)
  -l LISTEN, --listen=LISTEN
                        Address to listen on. (Default: 0.0.0.0)
  -r, --reload          Enable reloading on config change. (Default: False)

mod_wsgi can be used with Apache to mount talook. While the standalone server will work just fine for some environments it's important to remember it's single threaded and won't perform well under some conditions. There are example files in contrib/apache/ which can help set an instance up. Note that the wsgi process owner will need to be able to write and/or read from the locations listed in the config.json just like in the standalone server!

• talook.wsgi: The WSGI file that mod_wsgi will use.
• talook.conf: The configuration file which mounts the WSGI application.

One or both may be needed when using mod_wsgi on Apache if SELinux is enabled.

• setsebool -P httpd_can_network_connect 1
• semanage port -a -t http_port_t -p tcp 8008

To generate an RPM issue the following command:

$ make rpm

You'll then be able to install and run talook as a system service.