Professional- ja Business-paketeissa Uptimecheckin Terraform-provider, uptimecheck-com/uptimecheck Terraform Registryssä, hallitsee valvontakohteita, projekteja, hälytyskanavia ja tilasivuja koodina. Se käyttää REST APIa API-avaimella.
Luo API-avain
- Avaa sivupalkista Asetukset ja valitse välilehti API.
- Valitse Uusi API-avain, nimeä se käyttöpaikan mukaan, esimerkiksi ”Terraform”, ja valitse Luku ja kirjoitus. Provider luo ja muuttaa asioita, joten vain luku -avain ei riitä.
- Valitse Luo avain ja kopioi se. Avain näytetään vain tämän kerran.
Lisää provider
Lisää provider konfiguraatioosi:
terraform {
required_providers {
uptimecheck = {
source = "uptimecheck-com/uptimecheck"
}
}
}
provider "uptimecheck" {}
Aja terraform init, joka lataa providerin Terraform Registrystä. Laita sitten avain ympäristömuuttujaan UPTIMECHECK_API_KEY, esimerkiksi komennolla export UPTIMECHECK_API_KEY=uc_your_api_key, tai salaisuudeksi CI-järjestelmääsi. Provider hyväksyy myös argumentin api_key, mutta ympäristömuuttuja pitää avaimen poissa tiedostoistasi.
Lisää valvontakohde
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
})
}
typeon jokin seuraavista:http,tcp,ping,dns,domain,heartbeat,server,vendor,crawltaiflow. Sen muuttaminen korvaa valvontakohteen.configsisältää tyypin asetukset JSON-muodossa, samoilla avaimilla kuin API-viitteessä. Vain kirjoittamiasi avaimia hallitaan, joten sovelluksen oletusarvot muille eivät näy muutoksina.interval_secondson tarkistusväli, 60–3600 sekuntia (30 paketissa, joka sen sallii), tai 300, jos jätät sen pois.channel_idsvalitsee hälytyskanavat,project_idprojektin, japaused = truekeskeyttää valvontakohteen.
Aja terraform plan nähdäksesi, mikä muuttuu, ja sitten terraform apply. Valvontakohde näkyy sovelluksessa heti.
Cron-työ ja sen ping-osoite
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
}
Ping-osoite on kentässä heartbeat_url, joka on merkitty arkaluonteiseksi. Lue se komennolla terraform output -raw backup_ping_url ja lisää se työhön.
Projektit, hälytyskanavat ja tilasivut
uptimecheck_project: projekti, esimerkiksi asiakas, jolla onnamejacolor. Kun se poistetaan, sen valvontakohteet ja tilasivut jäävät ilman projektia; sen asiakasraportit ja asiakaskäyttöoikeudet poistetaan sen mukana.uptimecheck_alert_channel: sähköposti, Slack saapuvan webhookin kautta, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover ja webhookit. Osoite tai avain annetaan kentässäconfig, jota API ei koskaan palauta, joten sovelluksessa tehtyä muutosta ei tulkita poikkeamaksi.delay_minutes(5, 10, 15, 30 tai 60) tekee kanavasta eskalointivaiheen. Webhookin allekirjoitussalaisuus on kentässäwebhook_secret, ja se palautetaan vain kanavaa luotaessa.uptimecheck_status_page: tilasivu otsikkoineen, ulkoasuineen jacomponents-luetteloineen, eli vierailijoille näkyvät valvontakohteet järjestyksessä ja halutessasi ryhmiteltyinä. Sen salasana, sähköpostipääsylista ja oma CSS asetetaan sovelluksessa, eikä niihin kosketa. Sivun poistaminen poistaa sen tilaajat, kirjoitetut päivitykset ja kävijätilastot.- Tietolähteet
uptimecheck_alert_channels,uptimecheck_projectsjauptimecheck_status_pageslistaavat olemassa olevat. Käytä ensimmäistä SMS-, Telegram-, push- ja Add to Slack -kanaville, jotka otetaan käyttöön sovelluksessa.
Tuo olemassa olevat
Sovelluksessa luodut valvontakohteet, projektit, hälytyskanavat ja tilasivut voi tuoda niiden tunnisteella:
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_...
Tuodun hälytyskanavan osoitetta ja webhookin allekirjoitussalaisuutta ei lueta takaisin. Jokainen resurssi ja attribuutti on dokumentoitu: Terraform Registry. Lisää Terraform-integraatiosta, API-avaimista ja REST APIsta.