Sur Professional et Business, le provider Uptimecheck pour Terraform, uptimecheck-com/uptimecheck dans le Terraform Registry, gère moniteurs, projets, canaux d’alerte et pages de statut en code. Il passe par l’API REST avec une clé API.
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 « Terraform », et choisissez Lecture et écriture. Le provider crée et modifie des éléments, une clé en lecture seule ne suffit donc pas.
- Choisissez Créer la clé et copiez-la. C’est la seule fois où la clé s’affiche.
Ajouter le provider
Ajoutez le provider à votre configuration :
terraform {
required_providers {
uptimecheck = {
source = "uptimecheck-com/uptimecheck"
}
}
}
provider "uptimecheck" {}
Lancez terraform init, qui télécharge le provider depuis le Terraform Registry. Placez ensuite la clé dans la variable d’environnement UPTIMECHECK_API_KEY, par exemple avec export UPTIMECHECK_API_KEY=uc_your_api_key, ou en secret dans votre système de CI. Le provider accepte aussi un argument api_key, mais la variable d’environnement garde la clé hors de vos fichiers.
Ajouter un moniteur
resource "uptimecheck_monitor" "checkout" {
type = "http"
name = "Checkout"
target = "https://shop.example.com/checkout"
interval_seconds = 60
config = jsonencode({
expectedStatus = "200-299"
keyword = { value = "Add to cart", mode = "contains" }
slowMs = 1500
})
}
typevauthttp,tcp,ping,dns,domain,heartbeat,server,vendor,crawlouflow. Le changer remplace le moniteur.configcontient les réglages du type en JSON, avec les mêmes clés que la référence API. Seules les clés que vous écrivez sont gérées : les valeurs par défaut de l’app pour le reste n’apparaissent pas comme des changements.interval_secondsfixe la fréquence des vérifications, de 60 à 3600 secondes (30 sur un forfait qui le permet), 300 si vous l’omettez.channel_idschoisit les canaux d’alerte,project_idle projet, etpaused = truemet le moniteur en pause.
Lancez terraform plan pour voir ce qui va changer, puis terraform apply. Le moniteur apparaît aussitôt dans l’app.
Une tâche cron et son URL de ping
resource "uptimecheck_monitor" "backup" {
type = "heartbeat"
name = "Nightly backup"
config = jsonencode({
schedule = { cron = "0 3 * * *", timeZone = "Europe/Stockholm" }
graceSeconds = 900
maxRunSeconds = 3600
})
}
output "backup_ping_url" {
value = uptimecheck_monitor.backup.heartbeat_url
sensitive = true
}
L’URL de ping se trouve dans heartbeat_url, marquée comme sensible. Lisez-la avec terraform output -raw backup_ping_url et ajoutez-la à la tâche.
Projets, canaux d’alerte et pages de statut
uptimecheck_project: un projet, par exemple un client, avec unnameet unecolor. Le supprimer laisse ses moniteurs et pages de statut sans projet ; ses rapports client et accès client sont supprimés avec lui.uptimecheck_alert_channel: e-mail, Slack par webhook entrant, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover et webhooks. L’adresse ou la clé va dansconfig, que l’API ne renvoie jamais : une modification faite dans l’app n’est donc pas vue comme une dérive.delay_minutes(5, 10, 15, 30 ou 60) en fait une étape d’escalade. Le secret de signature d’un webhook se trouve danswebhook_secret, renvoyé uniquement à la création du canal.uptimecheck_status_page: une page de statut avec son titre, son apparence et sescomponents, les moniteurs que voient les visiteurs, dans l’ordre et éventuellement regroupés. Son mot de passe, sa liste d’accès par e-mail et son CSS personnalisé se règlent dans l’app et restent intacts. La supprimer supprime ses abonnés, ses mises à jour publiées et ses statistiques de visite.- Les sources de données
uptimecheck_alert_channels,uptimecheck_projectsetuptimecheck_status_pageslistent ce qui existe. Utilisez la première pour les canaux SMS, Telegram, push et Add to Slack, configurés dans l’app.
Reprendre l’existant
Les moniteurs, projets, canaux d’alerte et pages de statut créés dans l’app s’importent par leur ID :
terraform import uptimecheck_monitor.checkout mon_...
terraform import uptimecheck_project.acme prj_...
terraform import uptimecheck_alert_channel.slack ch_...
terraform import uptimecheck_status_page.public sp_...
L’adresse d’un canal d’alerte importé et le secret de signature d’un webhook ne sont pas relus. Chaque ressource et chaque attribut sont documentés dans le Terraform Registry. Pour aller plus loin : l’intégration Terraform, les clés API et l’API REST.