- Inicio
- Integraciones
- Prometheus
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
-
Crea una clave de API en Ajustes › API. Con Solo lectura basta.
-
Añade un job de scrape en
prometheus.yml: objetivoapp.uptimecheck.com, esquemahttps, ruta de métricas/api/v1/metricsy la clave como bearer token. -
Pon
scrape_intervalen60so 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
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.
Funciona bien con
Todas las integraciones-
API REST
Monitores, incidentes, mantenimiento y actualizaciones de estado, con un documento OpenAPI. Leer más : API REST -
Webhooks
Cada alerta como JSON firmado a tu propio endpoint, con reintentos. Cómo funciona : Webhooks -
Servidor MCP
Deja que Claude, Cursor o VS Code consulten el estado y gestionen monitores con una clave de API. Cómo funciona : Servidor MCP
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