Understanding Your Status Page Overview
Learn how to access and understand your public status page to monitor service health and communicate with customers
Monitor Your Service Health with Status Pages
Learn how to access and understand your public status page to monitor the health and availability of your services in real-time.
What is a Status Page?
Your status page is a public-facing dashboard that displays the current health and availability of all your services. It allows your customers, team members, and stakeholders to quickly check if everything is running smoothly.
Accessing Your Status Page
Your Status Page URL
Your status page is accessible at:
https://yourdomain.com/api/v1/status-pages/public/[YOUR-PAGE-ID]/status/overview
Finding Your Page ID
- Dashboard Location: Go to Settings → Status Pages → Your page will display the unique page ID
- Format: Your page ID looks like
aaa94712-bb41-4536-a674-1df42bc06068 - Bookmark It: Once you have your URL, bookmark it for quick access
Understanding the Overview Response
Response Structure
When you access your status page overview, you'll receive a JSON response with the following information:
{
"status": "success",
"data": {
"services": [
{
"name": "API Service",
"status": "operational",
"description": "Main application API"
},
{
"name": "Database",
"status": "operational",
"description": "Primary database connection"
}
]
}
}
Status Values Explained
| Status | Meaning | Color | Action Needed |
|---|---|---|---|
| operational | Service is running normally | Green | No action required |
| degraded_performance | Service is slower than usual | Yellow | Monitor closely |
| partial_outage | Some features unavailable | Orange | Investigate issues |
| major_outage | Service completely unavailable | Red | Immediate attention needed |
| under_maintenance | Planned maintenance in progress | Blue | Expected downtime |
How to Use Your Status Page
For Your Team
- Quick Health Check: Visit your status page URL to see all services at a glance
- Proactive Monitoring: Check status before customer complaints come in
- Communication Tool: Share the status page URL with your team for transparency
For Your Customers
- Share the URL: Provide customers with your status page link
- Embed on Website: Add a status widget to your homepage
- Include in Support: Reference status page in customer communications
Setting Up Your Status Page
Initial Configuration
- Navigate to Status Pages: Dashboard → Features → Status Pages
- Create New Status Page: Click "Create Status Page"
- Add Services: List all services you want to monitor
- Configure Monitoring: Set up health checks for each service
- Save and Publish: Your page will be live immediately
Customizing Your Status Page
- Page Title: Customize the page header
- Service Names: Use descriptive names your users will understand
- Descriptions: Add helpful context for each service
- Branding: Apply your company colors and logo
Best Practices for Status Pages
Service Naming Guidelines
- "User Authentication" instead of "auth-service-01"
- "Payment Processing" instead of "payment-api-v2"
- "File Storage" instead of "s3-bucket-prod"
Monitoring Strategy
- Start Simple: Monitor 3-5 core services first
- Expand Gradually: Add more services as needed
- Keep Updated: Remove services you no longer use
- Test Regularly: Verify your monitoring is working
Integrating with Your Workflow
Team Notifications
- Slack Integration: Get alerts in your team channel
- Email Alerts: Receive notifications when status changes
- Webhook Support: Connect to your incident management system
Customer Communication
- Email Signup: Allow customers to subscribe for updates
- Incident History: Maintain transparency with past incidents
- Scheduled Maintenance: Communicate planned downtime
Common Use Cases
Scenario 1: SaaS Application
Services to Monitor:
- User Authentication
- Database Connection
- API Endpoints
- Third-party Integrations
- Email Service
Scenario 2: E-commerce Platform
Services to Monitor:
- Product Catalog
- Shopping Cart
- Payment Processing
- Order Management
- Customer Accounts
Troubleshooting
Status Page Not Loading
- Check URL: Verify your page ID is correct
- Test Connection: Try accessing from different networks
- Clear Cache: Refresh your browser or clear cache
- Contact Support: Reach out if issues persist
Services Not Showing
- Check Service Configuration: Ensure services are properly added
- Verify Monitoring: Check if health checks are running
- Review Permissions: Ensure public access is enabled
Status Page Setup Checklist
Status page created with unique IDServices added and configured
URL bookmarked for quick access
Team notified of status page URL
Customer communication prepared
Remember: Your status page is a powerful tool for transparency and communication. Keep it updated and share it proactively with stakeholders to build trust and reduce support inquiries.