En Professional y Business, el provider de Uptimecheck para Terraform, uptimecheck-com/uptimecheck en el Terraform Registry, gestiona monitores, proyectos, canales de alertas y páginas de estado como código. Funciona a través de la API REST con una clave de API.
Crea una clave de API
- Abre Ajustes en la barra lateral y elige la pestaña API.
- Elige Nueva clave de API, ponle un nombre según dónde se usa, por ejemplo «Terraform», y elige Lectura y escritura. El provider crea y modifica cosas, así que una clave de solo lectura no basta.
- Elige Crear clave y cópiala. Es la única vez que se muestra la clave.
Añade el provider
Añade el provider a tu configuración:
terraform {
required_providers {
uptimecheck = {
source = "uptimecheck-com/uptimecheck"
}
}
}
provider "uptimecheck" {}
Ejecuta terraform init, que descarga el provider del Terraform Registry. Después pon la clave en la variable de entorno UPTIMECHECK_API_KEY, por ejemplo con export UPTIMECHECK_API_KEY=uc_your_api_key, o como secreto en tu sistema de CI. El provider también acepta un argumento api_key, pero la variable de entorno mantiene la clave fuera de tus archivos.
Añade un monitor
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
})
}
typees uno dehttp,tcp,ping,dns,domain,heartbeat,server,vendor,crawlyflow. Si lo cambias, el monitor se sustituye.configcontiene los ajustes del tipo en JSON, con las mismas claves que la referencia de la API. Solo se gestionan las claves que escribes, así que los valores por defecto de la app para el resto no aparecen como cambios.interval_secondses cada cuánto se comprueba, de 60 a 3600 segundos (30 en un plan que lo permita); si lo omites, 300.channel_idselige los canales de alertas,project_idel proyecto, ypaused = truepausa el monitor.
Ejecuta terraform plan para ver qué va a cambiar y luego terraform apply. El monitor aparece en la app al momento.
Un cron job y su 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
}
La URL de ping está en heartbeat_url, marcada como sensible. Léela con terraform output -raw backup_ping_url y añádela al job.
Proyectos, canales de alertas y páginas de estado
uptimecheck_project: un proyecto, por ejemplo un cliente, con unnamey uncolor. Si lo eliminas, sus monitores y páginas de estado se quedan sin proyecto; sus informes de cliente y el acceso de clientes se eliminan con él.uptimecheck_alert_channel: email, Slack mediante incoming webhook, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover y webhooks. La dirección o la clave van enconfig, que la API nunca devuelve, así que un cambio hecho en la app no se ve como drift.delay_minutes(5, 10, 15, 30 o 60) lo convierte en un paso de escalado. El secreto de firma de un webhook está enwebhook_secrety solo se devuelve cuando se crea el canal.uptimecheck_status_page: una página de estado con su título, su aspecto y suscomponents, los monitores que ven los visitantes, en orden y opcionalmente agrupados. Su contraseña, su lista de acceso por email y el CSS personalizado se configuran en la app y no se tocan. Si la eliminas, se eliminan sus suscriptores, las actualizaciones escritas y las estadísticas de visitas.- Los data sources
uptimecheck_alert_channels,uptimecheck_projectsyuptimecheck_status_pageslistan lo que existe. Usa el primero para los canales de SMS, Telegram, push y Add to Slack, que se configuran en la app.
Trae lo que ya tienes
Los monitores, proyectos, canales de alertas y páginas de estado creados en la app se pueden importar por su 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_...
La dirección de un canal de alertas importado y el secreto de firma de un webhook no se leen de vuelta. Todos los recursos y atributos están documentados en el Terraform Registry. Más sobre la integración con Terraform, las claves de API y la API REST.