Skip to main content

No project description provided

Project description

This package exports metrics about Bugsnag error events as Prometheus metrics.

Usage

Configure API token

You’ll need to provide an API token to access the Bugsnag Data Access API. See the Bugsnag documentation for details.

Start HTTP service

Start the HTTP server like this:

$ BUGSNAG_APITOKEN=MYTOKEN bugsnag_exporter --host=127.0.0.1 --port=9642

Pass --ttl=SECONDS to cache Bugsnag API results for the given time or -1 to disable (default is 600). Prometheus considers metrics stale after 300s, so that’s the highest scrape_interval one should use. However it’s usually unnecessary to hit the API that often, since the vulnerability alert information does not change that rapidly.

You can pass –buckets with a comma-separated list to define the upper bucket bounds that are used to generate the histogram metric.

Configure Prometheus

scrape_configs:
  - job_name: 'bugsnag'
    scrape_interval: 300s
    static_configs:
      - targets: ['localhost:9642']

We export one metric, a histogram called bugsnag_events, with labels {project="MyProject", release_stage="production"}.

A typical alerting PromQL query might be bugsnag_events_bucket{le="+Inf",release_stage="production"} - ignoring (le) bugsnag_events_bucket{le="1000.0",release_stage="production"} > 0

Additionally, a bugsnag_scrape_duration_seconds gauge is exported.

CHANGES

1.2.0 (2021-10-15)

  • Add sort=unsorted parameter to handle potentially large result sets

1.1.1 (2021-05-07)

  • Throttle paginated requests to avoid hitting the rate limit.

1.1.0 (2019-10-02)

  • Use default prometheus histograms with “le” buckets

1.0.0 (2019-09-09)

  • First release.

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

bugsnag_exporter-1.2.0.tar.gz (6.1 kB view details)

Uploaded Source

File details

Details for the file bugsnag_exporter-1.2.0.tar.gz.

File metadata

  • Download URL: bugsnag_exporter-1.2.0.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/51.1.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.7

File hashes

Hashes for bugsnag_exporter-1.2.0.tar.gz
Algorithm Hash digest
SHA256 e4126fdb9e82bd673463fd211083899df240fffdb0299cc7cb1d12872ea2abbb
MD5 99425392ee5b8f7a942b0047955d9556
BLAKE2b-256 fdbdb35b384d77b536543025c7959e561918efaade34945b3d0d23c05638e461

See more details on using hashes here.

Supported by

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