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

Assign the plugin to a service application in Imbi. The following options and credentials are available.

Options

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

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