Intégration · Développeurs

Vos moniteurs dans Prometheus

Scrapez un seul endpoint avec une clé API et obtenez l’état, le temps de réponse et la disponibilité sur 24 heures de chaque moniteur en métriques Prometheus, à côté du reste de votre infrastructure.

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

Ce que vous obtenez

  • Chaque moniteur, un seul scrape

    Disponible ou non, en pause, le dernier temps de réponse, l’heure de la dernière vérification et la part des dernières 24 heures où il était disponible, pour chaque moniteur de l’espace de travail.

  • Des labels pour filtrer

    Chaque série porte monitor_id, name, type et project, pour regrouper par projet client ou type de moniteur dans PromQL.

  • Des règles dans votre stack

    Écrivez des règles d’alerte sur uptimecheck_monitor_up ou uptimecheck_open_incidents à côté de celles que vous avez déjà. Les alertes d’Uptimecheck continuent de fonctionner comme avant.

  • Graphiques dans Grafana

    Avec Prometheus comme source de données, affichez les temps de réponse et la disponibilité dans Grafana à côté de vos propres métriques.

Comment connecter Prometheus

  1. Créez une clé API dans Paramètres › API. Lecture seule suffit.

  2. Ajoutez un job de scrape dans prometheus.yml : cible app.uptimecheck.com, schéma https, chemin des métriques /api/v1/metrics et la clé comme jeton Bearer.

  3. Réglez scrape_interval sur 60s ou plus, rechargez Prometheus et vérifiez que la nouvelle cible est joignable.

L’endpoint est décrit dans la référence de l’API.

Sur Professional et Business, avec une clé API créée dans Paramètres › API. Une clé en lecture seule suffit.

Ce qui est mesuré

uptimecheck_monitor_up
1 si la dernière vérification a réussi, 0 si elle a échoué
uptimecheck_monitor_paused
1 tant que le moniteur est en pause
uptimecheck_monitor_response_ms
Temps de réponse de la dernière vérification, en millisecondes
uptimecheck_monitor_last_check_timestamp_seconds
Heure de la dernière vérification, en temps Unix
uptimecheck_monitor_uptime_ratio
Part des dernières 24 heures où il était disponible, de 0 à 1
uptimecheck_open_incidents
Incidents ouverts en ce moment dans l’espace de travail

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 et une partie de ce qu’il récupère, au format texte de Prometheus. Chaque moniteur de l’espace de travail a sa propre série.

Questions

Quelles métriques sont disponibles ?

uptimecheck_monitor_up (1 ou 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio sur les dernières 24 heures, et uptimecheck_open_incidents pour l’espace de travail. Les métriques des moniteurs portent les labels monitor_id, name, type et project.

À quelle fréquence Prometheus doit-il scraper ?

Toutes les 60 secondes ou moins souvent. Vous restez ainsi dans la limite de l’API de 120 requêtes par minute et par clé, partagée avec les autres usages de la clé.

Pourquoi un moniteur manque-t-il dans uptimecheck_monitor_up ?

Les moniteurs en pause et ceux qui n’ont pas encore été vérifiés sont absents de uptimecheck_monitor_up et du temps de réponse. Un moniteur en pause affiche 1 dans uptimecheck_monitor_paused.

Quels forfaits l’incluent ?

Professional et Business, comme l’API REST. Toute clé API fonctionne, y compris en lecture seule.

Puis-je les afficher dans Grafana ?

Oui, via Prometheus : ajoutez votre Prometheus comme source de données dans Grafana et affichez les métriques uptimecheck_ comme les autres.

Apprenez-le par nous, pas par vos clients.

Explorez la démo en direct sans compte, ou lancez votre essai et ajoutez votre premier moniteur.

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