Automatic Monitoring
ATStatus automatically monitors your services and updates their status based on real-time availability checks.
How Monitoring Works
The monitoring system continuously checks your services and automatically updates their status:
Monitor Types
HTTP/HTTPS
Web endpoints & APIs
TCP Port
Services & databases
Keyword
Content validation
Database
SQL & NoSQL
Enabling Monitoring
Per-Component Monitoring
Each component can have its own monitoring configuration:
- Navigate to Admin → Components
- Click on a component to edit it
- Enable Automatic Monitoring
- Set Monitor URL, Type, and Interval
- Click Save
Global Monitoring Settings
Configure system-wide settings in Admin → Settings → Monitoring:
| Setting | Description | Default |
|---|---|---|
| Default Interval | Default check interval for new components | 60 seconds |
| Default Timeout | Request timeout before marking as down | 30 seconds |
| Retry Count | Number of retries before marking as down | 3 |
| Status Thresholds | Response time thresholds for degraded status | 1000ms / 3000ms |
Status Calculation
Component status is automatically calculated based on monitoring results:
Running the Monitor
Manual Execution
Run monitoring checks manually:
npm run monitorAutomated via Cron
Set up automated monitoring with cron:
# Using curl (every minute in crontab)
* * * * * curl -X POST https://your-status-page.com/api/cron/monitor -H "Authorization: Bearer YOUR_CRON_SECRET"
# Or using the monitor daemon
npm run monitorSecurity Note
Protect the monitor endpoint with your CRON_SECRET environment variable. This prevents unauthorized users from triggering status updates.
Uptime Metrics
ATStatus tracks and displays uptime metrics for each monitored component:
Calculated from monitoring data (e.g., 99.95%)
Average latency in milliseconds
Visual history of availability (90-day default)
Troubleshooting
Monitor Not Running
- • Verify
CRON_SECRETis set in your.env - • Check that the cron job is configured correctly
- • Review server logs for errors
False Positives/Negatives
- • Increase timeout for slow services
- • Increase retry count for flaky connections
- • Verify the monitor URL is correct
- • Check network/firewall settings
Manual Override
You can manually override the component status at any time. When you manually set a status, automatic monitoring will resume on the next check unless you disable monitoring.