Cómo hacer scrape de las métricas de Uptimecheck con Prometheus

Actualizado el 15 de noviembre de 2026 2 min de lectura

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

  1. Abre Ajustes en la barra lateral y elige la pestaña API.
  2. 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.
  3. 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.

¿Te ha resultado útil este artículo?

Pruébalo en tu propio espacio de trabajo

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

¿Sigues atascado?

Escribe a support@uptimecheck.com y te responderemos en 24 horas.

¿Quieres automatizarlo? La Referencia de la API cubre la API REST, los webhooks, los pings de tareas cron y MCP.