En Professional y Business, Prometheus puede hacer scrape de todos los monitores de tu espacio de trabajo desde un solo endpoint, https://app.uptimecheck.com/api/v1/metrics, con una clave de API. Obtienes el estado, el tiempo de respuesta y el uptime de 24 horas de cada monitor como métricas, listas para tus propias reglas de alerta y para gráficos en Grafana a través de Prometheus.
Crea una clave de API
- Abre Ajustes en la barra lateral y elige la pestaña API.
- Elige Nueva clave de API, ponle un nombre según dónde se usa, por ejemplo «Prometheus», y elige Solo lectura. Para leer métricas no hace falta más.
- Elige Crear clave y cópiala. Es la única vez que se muestra la clave.
Añade un job de scrape
Añade un job en prometheus.yml, pon tu clave en lugar de uc_your_api_key y recarga Prometheus:
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"]
Mantén scrape_interval en 60 segundos o más: la API permite 120 peticiones por minuto y clave, compartidas con todo lo demás que use la clave. Para no dejar la clave en el archivo, usa credentials_file con la ruta de un archivo que la contenga en lugar de credentials. El nuevo objetivo debería aparecer como activo en la página de targets de Prometheus en menos de un minuto.
Qué obtienes
uptimecheck_monitor_up: 1 si la última comprobación fue correcta, 0 si falló. Los monitores en pausa y los que aún no se han comprobado no aparecen.uptimecheck_monitor_paused: 1 mientras el monitor está en pausa.uptimecheck_monitor_response_ms: el 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: la parte de las últimas 24 horas en que el monitor estuvo disponible, de 0 a 1.uptimecheck_open_incidents: las incidencias abiertas ahora mismo en el espacio de trabajo.
Cada métrica de monitor lleva las etiquetas monitor_id, name, type y project, así que puedes filtrar por el proyecto de un cliente o por tipo de monitor.
Alerta con ellas
Una regla de Prometheus que salta cuando un monitor lleva dos minutos caído:
groups:
- name: uptimecheck
rules:
- alert: UptimecheckMonitorDown
expr: uptimecheck_monitor_up == 0
for: 2m
labels:
severity: critical
annotations:
summary: "{{ $labels.name }} is down"
Uptimecheck sigue enviando sus propias alertas a tus canales de alerta, así que reglas como esta son un añadido, no un sustituto. Más sobre la integración con Prometheus, las claves de API y la API REST.