Skip to main content

Configuration

Set up and configure the Better Uptime provider for monitoring
2 min read

This guide covers how to configure the Better Uptime provider for Pulumi.

Overview#

The Better Uptime provider requires an API token for authentication. You can manage uptime monitoring, status pages, incidents, and integrations.

Provider Configuration#

Basic Setup#

Configuration Methods#

2. Environment Variables#

3. Pulumi Configuration#

Getting API Credentials#

Create API Token#

  1. Log in to Better Uptime dashboard
  2. Navigate to Settings → API Tokens
  3. Click Create API Token
  4. Name your token (e.g., "Pulumi Integration")
  5. Set appropriate permissions
  6. Copy the generated token

Required Permissions#

For full management capabilities:

  • Monitors: Read, Write
  • Status Pages: Read, Write
  • Incidents: Read, Write
  • Integrations: Read, Write
  • Heartbeats: Read, Write

Configuration Options#

PropertyTypeRequiredDescription
apiTokenstringYesBetter Uptime API token

Best Practices#

Security#

Multi-Account Setup#

Integration Examples#

With Better Uptime Monitor#

With Status Page#

Troubleshooting#

Invalid API Token#

Error: "Authentication failed: Invalid API token"

Solution:

  1. Verify token is correct
  2. Check token hasn't expired
  3. Ensure token has required permissions

Rate Limiting#

Error: "Rate limit exceeded"

Solution:

  • Better Uptime has rate limits (default: 100 requests/minute)
  • Add delays between resource creations
  • Use resource dependsOn to sequence operations

Permission Errors#

Error: "Insufficient permissions"

Solution:

  • Verify API token has correct permissions
  • Check account plan supports the feature
  • Ensure you're accessing resources you own

Additional Resources#