Skip to main content

A Prometheus exporter for APScheduler metrics

Project description

uv Ruff Checked with mypy

APScheduler Exporter

A Prometheus exporter for APScheduler metrics

Usage

Basic Example

from apscheduler_metrics import APSchedulerExporter

scheduler_exporter = APSchedulerExporter(scheduler=your_scheduler)
scheduler_exporter.start_http_server()

Parameters :

Disable metrics collecter for certain jobs

  • Considered as private/dummy (with "_" prefix)
from apscheduler.schedulers.background import BackgroundScheduler
from apscheduler_metrics import APSchedulerExporter

def task():
    pass

scheduler = BackgroundScheduler()

scheduler.add_job(task, 'interval', seconds=10, id='_your_task')

scheduler_exporter = APSchedulerExporter(scheduler=scheduler)
scheduler_exporter.start_http_server()
  • By ids (explicitly)
from apscheduler.schedulers.background import BackgroundScheduler
from apscheduler_metrics import APSchedulerExporter

def task():
    pass

scheduler = BackgroundScheduler()

scheduler.add_job(task, 'interval', seconds=10, id='your_task')

scheduler_exporter = APSchedulerExporter(scheduler=scheduler, excluded_jobs_by_id=['your_task'])
scheduler_exporter.start_http_server()

Configuration

  • port (default value: 8888)
  • listen address (default value: '0.0.0.0')

Metrics

Name Description Type
apscheduler_job_done_total Sent when a job is done. Counter
apscheduler_job_errors_total Sent when a job is failed. Counter
apscheduler_job_missed_total Sent when a job is missed. Counter
apscheduler_job_last_duration_seconds The runtime (seconds) for the last job execution. Gauge

Dashboard

See Grafana Dashboard to import the example dashboard in your instance apscheduler-exporter-dashboard-example

Project details


Download files

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

Source Distribution

apscheduler_exporter-0.2.4.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

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

apscheduler_exporter-0.2.4-py3-none-any.whl (3.7 kB view details)

Uploaded Python 3

File details

Details for the file apscheduler_exporter-0.2.4.tar.gz.

File metadata

  • Download URL: apscheduler_exporter-0.2.4.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for apscheduler_exporter-0.2.4.tar.gz
Algorithm Hash digest
SHA256 3e41bdee7a2998e3076792f0c95fc6d62e7b3b5a9757fc3196e1ba75ac9cf722
MD5 829f61506387919cc0071c85b937ffaa
BLAKE2b-256 866a9387ead635daac8d3269afe7ac7259360d56eea49bf3724e9e866dc4a15e

See more details on using hashes here.

File details

Details for the file apscheduler_exporter-0.2.4-py3-none-any.whl.

File metadata

  • Download URL: apscheduler_exporter-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 3.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for apscheduler_exporter-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 b4ea15288313a7d89daa550866632548e978462af143ebdb4d8909b0d48e4c5d
MD5 35d79a33c5e7670f55e12c99cd85338f
BLAKE2b-256 a9c6cff049e9ea4fbf30dd117c1be5e0fbb8a2a97686e212329ff8a87d9ad78e

See more details on using hashes here.

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