Integración · Desarrolladores

Tus monitores en Prometheus

Haz scrape de un solo endpoint con una clave de API y obtén el estado, el tiempo de respuesta y el uptime de 24 horas de cada monitor como métricas de Prometheus, junto al resto de tu infraestructura.

Prueba gratuita de 14 días · Después, gratis con 20 monitores · Sin tarjeta de crédito

Lo que obtienes

  • Cada monitor, un solo scrape

    Disponible o caído, en pausa, el último tiempo de respuesta, cuándo se comprobó por última vez y la parte de las últimas 24 horas en que estuvo disponible, para cada monitor del espacio de trabajo.

  • Etiquetas para filtrar

    Cada serie lleva monitor_id, name, type y project, así que puedes agrupar por proyecto de cliente o tipo de monitor en PromQL.

  • Reglas en tu propio stack

    Escribe reglas de alerta sobre uptimecheck_monitor_up o uptimecheck_open_incidents junto a las que ya tienes. Las alertas de Uptimecheck siguen funcionando como antes.

  • Gráficos en Grafana

    Con Prometheus como fuente de datos, muestra tiempos de respuesta y uptime en Grafana junto a tus propias métricas.

Cómo conectar Prometheus

  1. Crea una clave de API en Ajustes › API. Con Solo lectura basta.

  2. Añade un job de scrape en prometheus.yml: objetivo app.uptimecheck.com, esquema https, ruta de métricas /api/v1/metrics y la clave como bearer token.

  3. Pon scrape_interval en 60s o más, recarga Prometheus y comprueba que el nuevo objetivo está activo.

El endpoint está descrito en la referencia de la API.

En Professional y Business, con una clave de API de Ajustes › API. Basta con una clave de solo lectura.

Qué mide

uptimecheck_monitor_up
1 si la última comprobación fue correcta, 0 si falló
uptimecheck_monitor_paused
1 mientras el monitor está en pausa
uptimecheck_monitor_response_ms
Tiempo de respuesta de la última comprobación, en milisegundos
uptimecheck_monitor_last_check_timestamp_seconds
Cuándo se comprobó el monitor por última vez, en tiempo Unix
uptimecheck_monitor_uptime_ratio
Parte de las últimas 24 horas en que estuvo disponible, de 0 a 1
uptimecheck_open_incidents
Incidencias abiertas ahora mismo en el espacio de trabajo

prometheus.yml

scrape_configs:
  - job_name: uptimecheck
    scrape_interval: 60s
    scheme: https
    metrics_path: /api/v1/metrics
    authorization:
      type: Bearer
      credentials: uc_your_api_key
    static_configs:
      - targets: ["app.uptimecheck.com"]

GET /api/v1/metrics

# HELP uptimecheck_monitor_up Whether the monitor's last check passed (1) or failed (0).
# TYPE uptimecheck_monitor_up gauge
uptimecheck_monitor_up{monitor_id="mon_9xk2m1q8w4",name="Checkout",type="http",project="Northwind"} 0
uptimecheck_monitor_up{monitor_id="mon_4hd8s2k7p1",name="Storefront",type="http",project="Northwind"} 1
# HELP uptimecheck_monitor_response_ms Response time of the last check, in milliseconds.
# TYPE uptimecheck_monitor_response_ms gauge
uptimecheck_monitor_response_ms{monitor_id="mon_4hd8s2k7p1",name="Storefront",type="http",project="Northwind"} 184
# HELP uptimecheck_monitor_uptime_ratio Share of the last 24 hours the monitor was up (0 to 1), over the time it was monitored.
# TYPE uptimecheck_monitor_uptime_ratio gauge
uptimecheck_monitor_uptime_ratio{monitor_id="mon_9xk2m1q8w4",name="Checkout",type="http",project="Northwind"} 0.995139
uptimecheck_monitor_uptime_ratio{monitor_id="mon_4hd8s2k7p1",name="Storefront",type="http",project="Northwind"} 1
# HELP uptimecheck_open_incidents Incidents open right now in the workspace.
# TYPE uptimecheck_open_incidents gauge
uptimecheck_open_incidents 1
Un job de scrape y parte de lo que recibe, en el formato de texto de Prometheus. Cada monitor del espacio de trabajo tiene su propia serie.

Preguntas

¿Qué métricas hay?

uptimecheck_monitor_up (1 o 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio de las últimas 24 horas y uptimecheck_open_incidents para el espacio de trabajo. Las métricas de monitor llevan las etiquetas monitor_id, name, type y project.

¿Cada cuánto debe hacer scrape Prometheus?

Cada 60 segundos o con menos frecuencia. Así te mantienes dentro del límite de la API de 120 peticiones por minuto y clave, que comparten todos los usos de la clave.

¿Por qué falta un monitor en uptimecheck_monitor_up?

Los monitores en pausa y los que aún no se han comprobado no aparecen en uptimecheck_monitor_up ni en el tiempo de respuesta. Un monitor en pausa muestra 1 en uptimecheck_monitor_paused.

¿Qué planes lo incluyen?

Professional y Business, como la API REST. Sirve cualquier clave de API, también una de solo lectura.

¿Puedo verlas en Grafana?

Sí, a través de Prometheus: añade tu Prometheus como fuente de datos en Grafana y muestra las métricas uptimecheck_ como cualquier otra.

Entérate por nosotros, no por tus clientes.

Explora la demo en vivo sin cuenta, o empieza tu prueba y añade tu primer monitor.

Prueba gratuita de 14 días · Después, gratis con 20 monitores · Sin tarjeta de crédito