- Accueil
- Intégrations
- Prometheus
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
-
Créez une clé API dans Paramètres › API. Lecture seule suffit.
-
Ajoutez un job de scrape dans
prometheus.yml: cibleapp.uptimecheck.com, schémahttps, chemin des métriques/api/v1/metricset la clé comme jeton Bearer. -
Réglez
scrape_intervalsur60sou 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
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.
Fonctionne avec
Toutes les intégrations-
API REST
Moniteurs, incidents, maintenance et mises à jour de statut, avec un document OpenAPI. Lire la suite : API REST -
Webhooks
Chaque alerte en JSON signé vers votre propre endpoint, avec nouvelles tentatives. Comment ça marche : Webhooks -
Serveur MCP
Laissez Claude, Cursor ou VS Code consulter l’état et gérer les moniteurs avec une clé API. Comment ça marche : Serveur MCP
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