Export uptimerobot.com monitor results as prometheus.io metrics
Project description
This packages exports Uptime Robot monitor results as Prometheus metrics.
Usage
Configure API key
You’ll need to provide the API key of your uptimerobot.com account using a configuration file:
[default] 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_CONFIG /path/to/config # SetEnv PROMETHEUS_UPTIMEROBOT_LOGFILE /path/to/log # optional, for debugging </Location>
Configure Prometheus
scrape_configs: - job_name: 'uptimerobot' scrape_interval: 300s static_configs: - targets: ['localhost:9429']
The following metrics are exported, each with labels {monitor_name="example.com",monitor_type="http",monitor_url="https://example.com"}:
uptimerobot_up gauge (1=up, 0=down)
uptimerobot_status gauge
uptimerobot_responsetime gauge
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.
CHANGES
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
Hashes for ws.prometheus_uptimerobot-1.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 79874459748b1a2e310e619524f0c8f642dea6cec47ec5b23193f02ebdd647e2 |
|
MD5 | 58bdc37f8c9fffa63d8c8b5ce206d4fe |
|
BLAKE2b-256 | 2b1315c28431e08a50149cf7757033d8344e8d38ef44b5bdcb30daaa8d52f538 |