Majmun provides Prometheus metrics for monitoring system performance, stream statistics, and client activity.
Metrics are served on a separate address at the /metrics path; the endpoint is disabled when metrics_addr is
unset.
server:
metrics_addr: ":9090"
| Field |
Type |
Required |
Default |
Description |
metrics_addr |
string |
No |
"" |
Address for the metrics server (scrape /metrics) |
| Metric Name |
Type |
Description |
Labels |
iptv_playlist_streams_active |
Gauge |
Currently active playlist streams |
playlist_name |
iptv_client_streams_active |
Gauge |
Currently active client streams |
client_name, playlist_name, channel_name |
iptv_streams_reused_total |
Counter |
Streams joined to an already-running shared transcode instead of starting a new one |
playlist_name, channel_name |
iptv_streams_failures_total |
Counter |
Total number of stream failures |
client_name, playlist_name, channel_name, reason |
| Metric Name |
Type |
Description |
Labels |
iptv_listing_requests_total |
Counter |
Playlist/EPG/file requests served to clients |
client_name, request_type |
iptv_proxy_requests_total |
Counter |
Total proxy requests by client and status |
client_name, request_type, cache_status |
| Label |
Description |
Possible Values |
client_name |
Unique identifier for each client configuration |
any |
playlist_name |
Name of the playlist being accessed |
any |
channel_name |
Name of individual channels |
any |
request_type |
Type of request |
playlist, epg, file, channel |
cache_status |
Cache hit status (renewed = expired entry revalidated against upstream) |
hit, miss, renewed |
reason |
Failure reason |
global_limit, playlist_limit, client_limit, upstream_error |