imbi-plugin-logzio

Logz.io provider for the Imbi project logs tab, surfacing relevant logs without requiring search knowledge.

Installation

pip install imbi-plugin-logzio

Configuration

Create a Logz.io Integration in Imbi and enable its Logs capability. Connection settings and the API token live on the Integration; the query-shaping settings are scoped to the Logs capability.

Integration Options

Name Label Default Description
region Region us Logz.io account region. One of us, eu, uk, au, ca.
timeout_seconds Request Timeout 15 Per-request timeout in seconds.

Logs Capability Options

Name Label Default Description
base_query Base Query Template — Elasticsearch query_string applied as a must clause. Supports ${project_slug}, ${org_slug}, ${environment}, ${project_id}.
timestamp_field Timestamp Field @timestamp Source field containing the log timestamp.
message_field Message Field message Source field containing the log message.
level_field Level Field level Source field containing the log severity level.
environment_field Environment Field — Log field used to filter by environment. Leave blank to disable automatic environment filtering.
default_environments Default Environments — Comma-separated environments pre-selected in the UI.

Region → Hostname

Region API Host
us api.logz.io
eu api-eu.logz.io
uk api-uk.logz.io
au api-au.logz.io
ca api-ca.logz.io

Credentials

Name Description
api_token Logz.io API token with search privileges (X-API-TOKEN header).

Base Query Templates

Use ${variable} placeholders to scope log searches to a project automatically:

kubernetes.namespace_name:${project_slug} AND env:${environment}

Variables substituted at search time: project_slug, org_slug, environment, project_id. Unknown variables are rejected at configuration time.

Filter Operators

Operator Translation
eq Elasticsearch term
ne Elasticsearch bool.must_not.term
contains match_phrase on the configured message_field; non-leading wildcard (value*) on other fields
starts_with Elasticsearch prefix
regex Elasticsearch regexp (patterns starting with .*, *, or ? are rejected)

Development

# Clone alongside imbi-common
git clone https://github.com/AWeber-Imbi/imbi-plugin-logzio
git clone https://github.com/AWeber-Imbi/imbi-common

cd imbi-plugin-logzio
UV_CONFIG_FILE=/dev/null uv sync
UV_CONFIG_FILE=/dev/null uv run pytest tests/
UV_CONFIG_FILE=/dev/null uv run coverage run -m pytest tests/ && uv run coverage report

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.23.0)

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: Gavin M. Roy

License

BSD-3-Clause

Requires

Python >=3.14

Classifiers

Report project as malware

Download files

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

Source Distribution

imbi_plugin_logzio-2.14.1.tar.gz (111.0 kB view details)

Uploaded Source

Built Distribution

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

imbi_plugin_logzio-2.14.1-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

File details

Details for the file imbi_plugin_logzio-2.14.1.tar.gz.

File metadata

  • Download URL: imbi_plugin_logzio-2.14.1.tar.gz
  • Upload date:
  • Size: 111.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for imbi_plugin_logzio-2.14.1.tar.gz
Algorithm Hash digest
SHA256 7c09b6cd44adf12114410f8cabc8e5d24a2723f2147b9d0fa8433ac9a53b0651
MD5 8f9a82b013b4b4cbfbefef1c7e17e27c
BLAKE2b-256 b1b57480a790896e30064f0dcc528c2c2c967af131f9728f03d2f47a601d7c4d

See more details on using hashes here.

Provenance

The following attestation bundles were made for imbi_plugin_logzio-2.14.1.tar.gz:

Publisher: publish.yml on AWeber-Imbi/imbi-plugin-logzio

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

File details

Details for the file imbi_plugin_logzio-2.14.1-py3-none-any.whl.

File metadata

File hashes

Hashes for imbi_plugin_logzio-2.14.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1a62c1d90c36911358bec7c7af7ad0b4ee9bf8b053813d330d3cbf1e38d29989
MD5 0d212df5366b72269d323df69280e643
BLAKE2b-256 3bceec38339e59e446a935d8e7e49e6bbcff84a81a58dafed47e9aa1f95ee662

See more details on using hashes here.

Provenance

The following attestation bundles were made for imbi_plugin_logzio-2.14.1-py3-none-any.whl:

Publisher: publish.yml on AWeber-Imbi/imbi-plugin-logzio

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

Supported by

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