Skip to main content

logalizer

Export Kibana logs as CSV from the command line — via the Kibana 7.17 Reporting API. No third-party dependencies (pure Python stdlib).

logalizer authenticates to Kibana with basic auth, submits a CSV reporting job, polls until it completes, and writes the result to stdout or a file. It is built for both humans and scripts: clean exit codes and a strict stdout/stderr separation so logalizer ... > out.csv always yields only CSV on stdout.

Install

pip install logalizer

Requires Python 3.10+.

Configure

logalizer --init

Interactive wizard that validates your credentials and lets you pick a space and index pattern from live lists. Or set environment variables:

export KIBANA_URL=https://...
export KIBANA_USERNAME=...
export KIBANA_PASSWORD=...

Usage

# test connectivity and configuration
logalizer --ping

# discover what's available
logalizer --list-spaces
logalizer --list-indices --space <space>
logalizer --list-fields --index '<pattern>'

# export logs as CSV
logalizer -i '<index-pattern>' --query 'level:error' --last 24h \
    --fields '@timestamp,level,msg' -o errors.csv

Run logalizer --help for the full reference and logalizer --help-json for a machine-readable flag schema.

Release

Publishing is automated via GitHub Actions Trusted Publishing.

One-time setup on PyPI: project settings → Publishing → add a "pending publisher" with owner isdmx, repository logalizer, workflow publish.yml, environment pypi.

To cut a release, either use the GitHub Actions UI (Actions → "Release" → "Run workflow", enter a version like 0.1.0) or from a local checkout:

git tag v0.1.0
git push --tags

Either way, CI builds the sdist + wheel and uploads them to PyPI automatically.

License

MIT

Download files

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

Source Distribution

logalizer-0.1.0.tar.gz (21.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

logalizer-0.1.0-py3-none-any.whl (15.9 kB view details)

Uploaded Python 3

File details

Details for the file logalizer-0.1.0.tar.gz.

File metadata

  • Download URL: logalizer-0.1.0.tar.gz
  • Upload date:
  • Size: 21.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for logalizer-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0d7ad900fef0fc9ac8206547f090e3c0441bbccbe66119a695751f596f946aab
MD5 87a195c5c92bb0c58bd053e5b522ab07
BLAKE2b-256 c1c34b600b68ce14a37930c166425ebc6bf4d64e85b6752571fcac0854611f43

See more details on using hashes here.

Provenance

The following attestation bundles were made for logalizer-0.1.0.tar.gz:

Publisher: publish.yml on isdmx/logalizer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file logalizer-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: logalizer-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for logalizer-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d914425ce11b2a64c19e1273f7396a1ff8f75eacb0cd65c466198341ffd5f595
MD5 61328e0436a1c93563ee8e70c70f6405
BLAKE2b-256 2aa7f743e74e1a11968b5a15789f59f951841017baa7c24654d478f0252ebf33

See more details on using hashes here.

Provenance

The following attestation bundles were made for logalizer-0.1.0-py3-none-any.whl:

Publisher: publish.yml on isdmx/logalizer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.0

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page