Expiring Checks

Expiring checks are temporary monitoring checks that automatically delete after a specified duration. They're perfect for deployment verification, CI/CD pipelines, and incident investigation.

Use Cases

Deployment Verification

Create a check that monitors your newly deployed service. If the deployment succeeds, the check confirms health and then cleans itself up. If it fails, you get alerted before the check expires.

curl -X POST https://api.quismon.com/v1/checks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "deploy-verify-v2.1.0",
    "type": "https",
    "config": {
      "url": "https://api.example.com/health",
      "expected_status": [200],
      "expected_body": "version:2.1.0"
    },
    "regions": ["na-east-ewr", "eu-central-fra"],
    "interval_seconds": 60,
    "expires_after_seconds": 3600
  }'

CI/CD Pipeline Monitoring

Integrate expiring checks into your deployment pipeline to verify services come up healthy after each deploy.

Incident Investigation

When investigating an issue, create temporary checks with tighter intervals or additional regions to gather more data. They'll clean up automatically.

A/B Test & Preview Environments

Monitor preview deployments or A/B test variants that have a limited lifetime. Checks expire when the environment is torn down.

API Usage

Creating an Expiring Check

Add expires_after_seconds to your check creation request:

{
  "name": "temp-monitoring",
  "type": "https",
  "config": { "url": "https://example.com" },
  "interval_seconds": 300,
  "regions": ["na-east-ewr"],
  "expires_after_seconds": 86400
}

Time Limits

• Minimum: 60 seconds (1 minute)
• Maximum: 2592000 seconds (30 days)

Unverified Free Tier

Users with unverified email addresses can only create expiring checks. Expiration defaults to 14 days. Verify your email to create permanent checks.

Terraform Integration

The Terraform provider handles expiring checks specially:

• expires_after_seconds is read-only in the provider
• Terraform won't attempt to recreate expired checks
• Export includes expiration info in JSON but not in Terraform output

resource "quismon_check" "deploy_verify" {
  name              = "deploy-verify"
  type              = "https"
  config            = jsonencode({
    url             = "https://api.example.com/health"
    expected_status = "200"
  })
  regions           = ["na-east-ewr"]
  interval_seconds  = 60

  # Note: expires_after_seconds is managed by API
  # Terraform won't modify it
}

Console Indicators

The console shows an expiring check with:

• A clock icon badge next to the check name
• Remaining time displayed (e.g., "5m", "2h", "3d")
• Yellow warning style when expiring within 1 hour