Skip to main content

Package to count usage statistics from ELK logs.

Project description


Build Status Maintainability Test Coverage PyPI version PyPI - Python Version

Vuakhter is validation tool to test API to conform our API guide. But it can be used to generate statistics of web-application by its logs.

Principles of work

Vuakhter scans access log for specified period, filters log entries by path prefixes and passes each entry for statistics generation.

Base class AccessLog returns an iterator of log entries. Class ElasticAccessLog scans elastic indices for log entries.

StatisticsMetrics gets AccessEntry records and forms array of statistics data. -> str returns statistics report for the metrics.

HttpAnalyzer uses access_log: AccessLog and array of StatisticsMetrics.

Only one metric SchemaValidatorCounter is passing to HttpAnalyzer in main script vuakhter. It uses request_log: RequestLog to validate API responses.

Class ElasticRequestLog: RequestLog scans elastic indices requests by request_id and returns array of RequestEntry. SchemaValidatorCounter checks all responses bodies and counts valid API calls.


pip install vuakhter


vuakhter [--es-user ES_USER] [--es-pass ES_PASS] [--es-host ES_HOST] [--es-port ES_PORT
[--start-date START_DATE] [--end-date END_DATE] prefixes [prefixes ...]

By default end_date is current date and time if not specified. And start_date defaults to day ago end_date.

All connection parameters may be specified in .env file.

ES_USER=elastic ES_PASS=pasword ES_HOST=localhost vuakhter /api/

Using in code

import datetime

from elasticsearch import Elasticsearch

from vuakhter.analyzer import HttpAnalyzer
from vuakhter.kibana.access_log import ElasticAccessLog
from vuakhter.metrics.counters import ComplexCounter

elastic = Elasticsearch()
access_log = ElasticAccessLog(index_pattern='filebeat-*', client=elastic)

http_analyzer = HttpAnalyzer(access_log=access_log)

end_date =
start_date = end_date - datetime.timedelta(days=1)

http_analyzer.analyze(start_date, end_date)

for metric in http_analyzer.metrics:


We would love you to contribute to our project. It's simple:

  • Create an issue with bug you found or proposal you have. Wait for approve from maintainer.
  • Create a pull request. Make sure all checks are green.
  • Fix review comments if any.
  • Be awesome.

Here are useful tips:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

vuakhter-0.0.5-py3-none-any.whl (23.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page