Prometheus Metrics

Scrape uptime and latency metrics from Nines into your Prometheus stack. The metrics endpoint is available on Pro and Business plans.

Federate endpoint

Each API key exposes a Prometheus-compatible metrics URL:

https://nines.sh/metrics/<token>

The endpoint returns metrics in the standard Prometheus text exposition format.

Scrape config

Add a job to your prometheus.yml:

scrape_configs:
  - job_name: nines
    scheme: https
    metrics_path: /metrics/<your-token>
    static_configs:
      - targets:
          - nines.sh

Replace <your-token> with the token shown on the Settings → API Keys page. No additional authentication headers are required — the token in the path is the credential.

Recommended scrape interval: 60s or longer. The underlying check data is updated at your monitor's configured interval.

Metric catalog

The following metrics are available:

Example queries

Current uptime status for a specific monitor:

check_result_up{monitor_id="<id>"}

Average response time over the last 5 minutes across all regions:

avg(check_result_response_ms{monitor_id="<id>"})

7-day rolling uptime percentage:

avg_over_time(check_result_up{monitor_id="<id>"}[7d]) * 100

Labels available on raw metrics: monitor_id, org_id, region. Recording rules aggregate across regions and drop the region label.