Cómo gestionar Uptimecheck con Terraform

Actualizado el 15 de noviembre de 2026 3 min de lectura

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

  1. Abre Ajustes en la barra lateral y elige la pestaña API.
  2. 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.
  3. 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
  })
}
  • type es uno de http, tcp, ping, dns, domain, heartbeat, server, vendor, crawl y flow. Si lo cambias, el monitor se sustituye.
  • config contiene 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_seconds es cada cuánto se comprueba, de 60 a 3600 segundos (30 en un plan que lo permita); si lo omites, 300.
  • channel_ids elige los canales de alertas, project_id el proyecto, y paused = true pausa 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 un name y un color. 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 en config, 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á en webhook_secret y solo se devuelve cuando se crea el canal.
  • uptimecheck_status_page: una página de estado con su título, su aspecto y sus components, 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_projects y uptimecheck_status_pages listan 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.

¿Te ha resultado útil este artículo?

Pruébalo en tu propio espacio de trabajo

Prueba gratuita de 14 días · Después, gratis con 20 monitores · Sin tarjeta de crédito

¿Sigues atascado?

Escribe a support@uptimecheck.com y te responderemos en 24 horas.

¿Quieres automatizarlo? La Referencia de la API cubre la API REST, los webhooks, los pings de tareas cron y MCP.