Simply, teler can be run with:

$ [buffers] | teler -c /path/to/config/teler.yaml
# or
$ teler -i /path/to/access.log -c /path/to/config/teler.yaml

If you’ve built teler with a Docker image:

$ [buffers] | docker run -i --rm -e TELER_CONFIG=/path/to/config/teler.yaml kitabisa/teler
# or
$ docker run -i --rm -e TELER_CONFIG=/path/to/config/teler.yaml kitabisa/teler --input /path/to/access.log


$ teler -h

This will display help for the tool.

Kitabisa teler help usage

Kitabisa teler help usage

Here are all the switches it supports.



The -c flag is to specify teler configuration file.

$ tail -f /var/log/nginx/access.log | teler -c /path/to/config/teler.yaml

This is required, but if you have defined TELER_CONFIG environment you don’t need to use this flag, e.g.:

$ export TELER_CONFIG="/path/to/config/teler.yaml"
$ tail -f /var/log/nginx/access.log | teler
# or
$ tail -f /var/log/nginx/access.log | TELER_CONFIG="/path/to/config/teler.yaml" teler


Need log analysis incrementally? This -i flag is useful for that.

$ teler -i /var/log/nginx/access.log


Concurrency is the number of logs analyzed at the same time. The default value that teler provides is 20, you can change it by using -x flag.

$ teler -i /var/log/nginx/access.log -x 50

Remove Caches

It will remove all stored resources in the user-level cache directory, see cache.

$ teler --rm-cache