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
- Ouvrez Paramètres dans la barre latérale et choisissez l’onglet API.
- 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.
- 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.