Comment scraper les métriques d’Uptimecheck avec Prometheus

Mis à jour le 15 novembre 2026 2 min de lecture

Sur Professional et Business, Prometheus peut scraper tous les moniteurs de votre espace de travail depuis un seul endpoint, https://app.uptimecheck.com/api/v1/metrics, avec une clé API. Vous obtenez l’état, le temps de réponse et la disponibilité sur 24 heures de chaque moniteur en métriques, prêtes pour vos propres règles d’alerte et pour des graphiques dans Grafana via Prometheus.

Créer une clé API

  1. Ouvrez Paramètres dans la barre latérale et choisissez l’onglet API.
  2. Choisissez Nouvelle clé API, nommez-la d’après son usage, par exemple « Prometheus », et choisissez Lecture seule. Les métriques n’en demandent pas plus.
  3. Choisissez Créer la clé et copiez-la. C’est la seule fois où la clé s’affiche.

Ajouter un job de scrape

Ajoutez un job dans prometheus.yml, remplacez uc_your_api_key par votre clé et rechargez 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"]

Gardez scrape_interval à 60 secondes ou plus : l’API autorise 120 requêtes par minute et par clé, partagées avec tout ce qui utilise la clé. Pour garder la clé hors du fichier, utilisez credentials_file avec le chemin d’un fichier qui la contient, au lieu de credentials. La nouvelle cible devrait apparaître comme joignable sur la page des cibles de Prometheus en moins d’une minute.

Ce que vous obtenez

  • uptimecheck_monitor_up : 1 si la dernière vérification a réussi, 0 si elle a échoué. Les moniteurs en pause et ceux pas encore vérifiés sont absents.
  • uptimecheck_monitor_paused : 1 tant que le moniteur est en pause.
  • uptimecheck_monitor_response_ms : le temps de réponse de la dernière vérification, en millisecondes.
  • uptimecheck_monitor_last_check_timestamp_seconds : l’heure de la dernière vérification, en temps Unix.
  • uptimecheck_monitor_uptime_ratio : la part des dernières 24 heures où le moniteur était disponible, de 0 à 1.
  • uptimecheck_open_incidents : les incidents ouverts en ce moment dans l’espace de travail.

Chaque métrique de moniteur porte les labels monitor_id, name, type et project, pour filtrer par projet client ou par type de moniteur.

Alerter dessus

Une règle Prometheus qui se déclenche quand un moniteur est en panne depuis deux minutes :

groups:
  - name: uptimecheck
    rules:
      - alert: UptimecheckMonitorDown
        expr: uptimecheck_monitor_up == 0
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "{{ $labels.name }} is down"

Uptimecheck continue d’envoyer ses propres alertes à vos canaux d’alerte : ces règles sont un complément, pas un remplacement. En savoir plus sur l’intégration Prometheus, les clés API et l’API REST.

Cet article vous a-t-il été utile ?

Essayez-le dans votre propre espace de travail

Essai gratuit de 14 jours · Puis gratuit jusqu’à 20 moniteurs · Sans carte bancaire

Toujours bloqué ?

Écrivez à support@uptimecheck.com et nous vous répondrons sous 24 heures.

Vous automatisez ? La Référence de l’API couvre l’API REST, les webhooks, les pings de tâches cron et le MCP.