Panel Health Monitoring

Panel Health Monitoring

When your panel goes down, customers cannot stream and new orders fail to provision. IPTVbp includes built-in health monitoring so you can catch problems before customers report them.

How Health Checks Work

IPTVbp pings each connected panel at regular intervals (every 5 minutes by default). Each health check:

1. Opens an HTTP connection to the panel URL.
2. Authenticates using stored credentials or API token.
3. Calls a lightweight status endpoint (e.g. fetching the server info or package list).
4. Records the response time and HTTP status code.
5. Updates the panel status indicator (green, yellow, red).

Panel Status Indicators

Colour	Meaning	Action
Green	Healthy -- response under 2 seconds	None required
Yellow	Degraded -- response between 2-5 seconds or intermittent failures	Investigate server load
Red	Down -- 3 consecutive failures	Immediate attention required

Viewing Health Data

Go to Services > IPTV Panels and click on any panel. The detail page shows:

• Current status with last check timestamp.
• Uptime percentage over the last 24 hours, 7 days, and 30 days.
• Response time chart -- a line graph of average response times.
• Recent incidents -- a log of every status change (green to red, etc.) with timestamps.
• Active lines / capacity -- how many user lines exist vs. the panel's capacity.

Configuring Alerts

Under Settings > Notifications > Panel Alerts you can configure:

• Email alerts -- receive an email when a panel goes red.
• Discord webhook -- post to a Discord channel when status changes.
• Alert threshold -- how many consecutive failures before alerting (default: 3).
• Recovery notification -- get notified when a panel comes back online.

Capacity Monitoring

IPTVbp tracks the number of active lines on each panel. This is useful for:

• Knowing when to add a new panel -- when a panel reaches 80% capacity, start provisioning on a secondary panel.
• Load balancing -- if you have multiple panels, IPTVbp can distribute new subscriptions to the panel with the most available capacity.
• Trend analysis -- see how quickly you are filling panels to plan hardware purchases.

Set a capacity alert threshold (e.g. 80%) to receive a notification before a panel is full.

Automated Failover

If you have multiple panels of the same type, you can enable automated failover:

1. Go to Services > IPTV Panels > Failover Settings.
2. Enable Auto-Failover.
3. Select a primary panel and one or more fallback panels.
4. When the primary panel goes red, new provisioning requests are automatically routed to the first healthy fallback.
5. When the primary recovers, new requests return to it (or stay on the fallback -- configurable).

Existing subscriptions remain on their original panel. Only new provisioning is affected by failover.

Manual Health Check

You can trigger a health check at any time:

1. Go to the panel detail page.
2. Click Check Now.
3. The result appears within a few seconds.

This is useful after making changes to the panel (restarting services, updating software, changing firewall rules).

Best Practices

• Set up alerts on day one. Do not wait until a customer reports an outage.
• Monitor response times, not just uptime. A panel that responds in 8 seconds is technically "up" but will cause provisioning timeouts.
• Keep at least one backup panel. Even if you do not use failover, having a secondary panel ready means you can switch manually in an emergency.
• Review health data weekly. Look for patterns -- does the panel slow down at peak hours? Does it restart overnight? These patterns reveal underlying issues.
• Keep panel software updated. Many performance issues are fixed in newer versions of Xtream UI and NXT Dashboard.

Common Issues

Panel shows red but works in browser: IPTVbp checks the API endpoint, not the web UI. The web UI and API may run on different ports or services. Verify the API port is accessible and the API service is running.

Response times are high:

• Check the panel server CPU and memory usage.
• Look for database lock issues (common with Xtream UI under heavy load).
• Consider moving the panel database to a dedicated server.
• Enable query caching if available.

Capacity shows incorrect numbers:

• Click Sync Now to force a fresh count from the panel.
• Deleted lines in the panel may not be reflected immediately. The next scheduled sync will correct the count.