Skip to main content

Troubleshooting

Monitor Shows Incorrect Status​

Symptom: Monitor shows DOWN but your endpoint is working.

Causes and resolutions:

  1. Probe IP blocked by firewall — Most common cause. See HTTP Monitoring — Probe IP Allowlist →
  2. SSL certificate error — Check SSL Monitoring →
  3. Monitor configuration mismatch — Verify the expected status code matches what your endpoint returns
  4. Timeout too short — Increase the timeout if your endpoint has a slow first response (cold start)

Notifications Not Being Received​

Symptom: Monitor goes DOWN but no alerts arrive.

Checklist:

  • Alert policy is attached to the monitor (edit monitor → Alert Policy field)
  • Alert policy has notification channels configured
  • Notification channel has been tested (Settings → Notification Channels → Test)
  • For email: check spam / junk folder, add alerts@pingsla.com to allowlist
  • For Telegram: bot was started (/start) and is in the group
  • For Slack: webhook URL is valid and app is installed in workspace
  • For webhooks: endpoint is publicly reachable via HTTPS and returns 2xx

API Returns 401 Unauthorized​

Your API key is missing, incorrect, or revoked.

# Verify your key is set correctly
echo $PINGSLA_API_KEY

# Test the key
curl -I https://api.pingsla.com/v1/monitors \
  -H "Authorization: Bearer $PINGSLA_API_KEY"

Resolutions:

  • Regenerate the API key in Settings → API Keys
  • Ensure no extra whitespace in the key value
  • Verify the Bearer prefix is included

API Returns 403 Forbidden​

Valid key, but the action requires a higher role or a higher plan.

  • Check your workspace role in Settings → Team
  • Verify your plan supports the feature in Subscriptions →

Status Page Not Updating​

Symptom: Monitor is DOWN but status page still shows "Operational".

Resolutions:

  1. Ensure the monitor is added as a component on the status page
  2. Verify the monitor has an alert policy that triggers incidents
  3. Check that the incident was actually created (Incidents dashboard)

Dashboard Slow to Load​

  1. Clear browser cache and reload
  2. Disable browser extensions temporarily
  3. Try a different browser
  4. Check status.pingsla.com for platform incidents

Monitor Check History Is Empty​

Monitors show "No data" for the first few minutes after creation — the first check runs within the configured interval.

If no data appears after 10 minutes:

  1. Verify the monitor is in UP or DOWN state (not PAUSED)
  2. Check the probe region configuration

Cannot Delete a Monitor​

A monitor attached to a status page component must be removed from the status page first, then deleted.

  1. Edit the status page → remove the component
  2. Return to Monitors → delete the monitor

Getting Help​

If the above does not resolve your issue:

  1. Check FAQ →
  2. Open a GitHub issue: github.com/rizqtekv/pingSLA/issues
  3. Email support: support@pingsla.com (Business/Enterprise priority)