Skip to content
🐕 An HTTP log monitoring tool for your terminal
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
akita
resources
tests
.gitignore
.travis.yml
LICENSE
MANIFEST.in
README.md
TODO.md
setup.py
version.py

README.md

pypi python travis-ci

Akita

Demo

Akita is a local HTTP log monitoring tool that runs in your terminal. With Akita, you can view a summary of you webserver's activity in real-time. All server access logs that use the Common Log Format are supported, including Apache and Nginx.

Akita is also a breed of dog originating from the mountainous northern regions of Japan. The Akita is courageous, a natural guardian of his family. Stubborn and willful, he won't back down from a challenge. [0]

Akita

Installation

Akita is available on PyPI and can be installed using pip:

# Requires python 3!
$ pip install akita

Alternatively, you can clone the repository and run the code directly:

$ git clone https://github.com/michael-lazar/Akita.git
$ cd Akita
$ python -m akita

Usage

Launch Akita by pointing it at the server access log file that you want to monitor:

$ akita /var/log/apache/access.log

You can also provide a stream via a unix pipe:

$ tail -n 1 -f /var/log/apache/access.log | akita -

If you want to try running Akita but you don't have a webserver to point it to, you can use the apache-loggen command line tool to generate fake log data.

$ gem install apache-loggen
$ apache-loggen --rate=10 | akita -

Options

$ akita --help
usage: akita [--help] [--version] FILE

       / \      _-'
     _/|  \-''- _ /
__-' { |         \
    /             \
    /      "o.  |o }        Akita - Terminal HTTP Log Monitoring
    |            \ ;
                  ',
       \_         __\
         ''-_    \.//
           / '-____'
          /
        _'
      _-'

positional arguments:
  FILE                  A log file to watch, use "-" to pipe from stdin

optional arguments:
  -h, --help            show this help message and exit
  --alert-threshold ALERT_THRESHOLD
                        High traffic alert threshold, requests/second
  --alert-window ALERT_WINDOW
                        High traffic alert window, in seconds
  -V, --version         show program's version number and exit

Testing

This repository is continuously tested on TravisCI, but you can also run the test suite locally:

$ git clone https://github.com/michael-lazar/Akita.git
$ cd Akita
$ pip install .[test]  # Installs pytest
$ env PYTHONPATH=. py.test -v

License

This project is distributed under the MIT license.

You can’t perform that action at this time.