Skip to main content

Export monitor results as metrics

Project description

This packages exports Uptime Robot monitor results as Prometheus metrics.


Configure API key

You’ll need to provide the API key of your account using a configuration file:

api_key = 123456789

See the Uptime Robot API documentation for details.

Set up HTTP service

Then you need to set up an HTTP server, either with a dedicated process:

$ uptimerobot_exporter --host localhost --port 9429 --config /path/to/config

or as a CGI script, if you have infrastructure for that set up anyway. Here’s an example apache configuration snippet to do this:

ScriptAlias /metrics/uptimerobot /path/to/uptimerobot_exporter_cgi
<Location /metrics/uptimerobot>
  # SetEnv PROMETHEUS_UPTIMEROBOT_LOGFILE /path/to/log  # optional, for debugging

Configure Prometheus

  - job_name: 'uptimerobot'
    scrape_interval: 300s
      - targets: ['localhost:9429']

The following metrics are exported, each with labels {monitor_name="",monitor_type="http",monitor_url=""}:

  • uptimerobot_up gauge (1=up, 0=down)

  • uptimerobot_status gauge

  • uptimerobot_responsetime gauge

  • uptimerobot_ssl_expire gauge (unix timestamp), if applicable

See the Uptime Robot API documentation section “Parameters” for details on the possible status values. The monitor_type is translated from its numeric code to one of http, http keyword, ping, or port.

Additionally, a uptimerobot_scrape_duration_seconds gauge is exported.


1.2.0 (2021-10-22)

  • Update to current prometheus_client API

1.1.0 (2018-09-17)

  • Add ssl expiration metrics

1.0.1 (2018-04-02)

  • Support pagination of API results.

1.0.0 (2018-04-01)

  • 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

ws.prometheus_uptimerobot-1.2.0.tar.gz (7.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page