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#
1. Provider Block (Recommended)#
2. Environment Variables#
3. Pulumi Configuration#
Getting API Credentials#
Create API Token#
- Log in to Better Uptime dashboard
- Navigate to Settings → API Tokens
- Click Create API Token
- Name your token (e.g., "Pulumi Integration")
- Set appropriate permissions
- 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#
| Property | Type | Required | Description |
|---|---|---|---|
apiToken | string | Yes | Better 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:
- Verify token is correct
- Check token hasn't expired
- 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
dependsOnto 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