Closed Alpha
FluxPlay is currently in Closed Alpha. This documentation is a work in progress and may be incomplete or out of date. Features, UI, and APIs are subject to change without notice. For access inquiries, please contact [email protected].
MONITORING & ALERTS
Know what is happening in your FluxPlay instance with threshold-based alerts and real-time health checks. Get notified before small issues become outages.
Proactive Observability
Rather than discovering problems through failed playback or user complaints, FluxPlay's monitoring system surfaces issues early — while they can still be addressed without user impact.
Capabilities
Alert Rules
Define threshold-based rules that fire when a metric crosses a boundary — e.g. disk usage above 85%.
Categories
Alerts are grouped by category: Storage, Transcoding, Downloads, Security, System. Filter and mute by category.
Bulk Acknowledge
Acknowledge multiple alerts at once, add a note, and suppress re-firing for a configurable snooze duration.
Health Checks
Real-time health status for every dependency. Individual check results available via the /health/detail endpoint.
Cooldowns
A cooldown period prevents alert storms. Once an alert fires, it will not re-fire until the cooldown expires.
Notification Integration
Alerts route to the notification system. Receive alert digests via email, Discord, Gotify, or in-app.
Configuring Alert Rules
Alert rules are configured under Admin → Monitoring → Alert Rules. Each rule specifies a metric, a comparison operator, a threshold value, and a severity level. When the metric crosses the threshold, a new alert record is created and routed to the notification system.
Example rules
- storage.used_percent > 85 → Warning
- storage.used_percent > 95 → Critical
- transcoding.queue_depth > 50 → Warning
- downloads.failed_last_hour > 10 → Warning
- backup.last_success_age_hours > 25 → Critical
Alert Categories
Storage
Disk usage, library growth rate, backup staleness
Transcoding
Queue depth, job failures, GPU utilization
Downloads
Failure rate, queue backlog, source errors
Security
Failed logins, lockouts, suspicious IP patterns
System
CPU, memory, dependency health, update availability
Streaming
Active stream count, buffer errors, session drops
Health Check Endpoints
FluxPlay exposes standard health check endpoints compatible with Docker health checks, Kubernetes liveness/readiness probes, and uptime monitoring tools.
Cooldown Periods
Cooldowns prevent the same alert from firing repeatedly within a short window. After an alert fires, a configurable cooldown period (default 30 minutes) suppresses re-evaluation for that rule. When the underlying condition resolves and re-triggers, the alert fires again after the cooldown expires.