Skip to main content

promesque is a configurable Prometheus exporter for results of Elasticsearch queries.

Installation

pip3 install promesque

Usage

promesque path/to/some/config.yml --log-level info

Refer to exporter_es.yml as an example for such a config. The supported fields are explained below.

Configuration File

Configuration file is in a yaml format with single configuration scope (metrics).

Each item in metrics scope define a metric and must have following attributes:

  • description: description of a metric (what it does)

  • data_path: jsonpath to data buckets in Elasticsearch response to build metrics from (default: $)

  • value_path: jsonpath to metric value within data bucket

  • labels: inner scope with name: reference for each metric:
    • name: name of label exposed by exporter

    • reference: jsonpath to label value within data bucket

  • url: url to Elasticsearch cluster (include index)

  • query: query in json format; must
    • either be inclosed in single quotes (e.g. '{ "query": {...} }')

    • or written in YAML block notation with proper indentation, e.g.,

      es_query: |
        {
          "query": {
            ...
          }
        }

Release files for promesque 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for promesque 0.0.3
File Interpreter ABI Platform
promesque-0.0.3-py3-none-any.whl Python 3 none any Details

Release files / promesque-0.0.3-py3-none-any.whl

Download URL promesque-0.0.3-py3-none-any.whl
Size 5.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a0bf03f5e1104b416e25e11e629b410749104f1d26364528bba015ffa07764f4
BLAKE2b-256 checksum
How to use checksums
48ca94bc63a089eeb9c4e4b346aea3c98626db9d11c080227059abbcd5e7a22e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/2.7.10

Release history Release notifications | RSS feed

This release

0.0.3 This release

1 release file

0.0.2

2 release files

0.0.1

2 release 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