Supervision
Vuisio expose ses métriques au format Prometheus et fournit un tableau de bord Grafana prêt à l’emploi.
L’endpoint /metrics
Section intitulée « L’endpoint /metrics »Le SFU expose un endpoint /metrics au format Prometheus. Il est désactivé
par défaut : il n’apparaît que si le jeton VUISIO_METRICS_TOKEN est
configuré. Les requêtes doivent porter l’en-tête Authorization: Bearer <jeton>
(comparaison à temps constant). Sans jeton configuré, l’endpoint répond 404 ;
avec un mauvais jeton, 403.
Les métriques exposées
Section intitulée « Les métriques exposées »Compteurs (cumuls depuis le démarrage) :
| Métrique | Mesure |
|---|---|
vuisio_packets_received_total | paquets UDP reçus |
vuisio_packets_sent_total | paquets UDP envoyés aux clients |
vuisio_packets_dropped_total | paquets abandonnés (aucun destinataire) |
vuisio_media_forwarded_total | paquets média retransmis |
vuisio_audio_forwarded_total | paquets audio retransmis |
vuisio_rooms_created_total | salles créées |
vuisio_participants_joined_total | participants ayant rejoint |
vuisio_datachannel_send_failures_total | échecs d’envoi sur datachannel |
Jauges (valeurs instantanées) :
| Métrique | Mesure |
|---|---|
vuisio_rooms_active | salles actives |
vuisio_participants_active | participants actifs |
vuisio_moderators_active | modérateurs actifs |
vuisio_cameras_active | caméras activées |
vuisio_mics_active | micros activés |
vuisio_screen_shares_active | partages d’écran actifs |
vuisio_speakers_active | salles avec un orateur actif |
vuisio_sfu_threads | nombre de threads SFU |
vuisio_max_participants_per_room | plafond de participants par salle |
vuisio_process_cpu_seconds_total | temps CPU du processus |
vuisio_process_resident_memory_bytes | mémoire résidente |
vuisio_process_open_fds | descripteurs de fichiers ouverts |
vuisio_sfu_thread_cpu_seconds_total | temps CPU par thread SFU (label thread) |
vuisio_cross_thread_queue_depth | profondeur de la file inter-threads (label thread) |
Le tableau de bord fourni
Section intitulée « Le tableau de bord fourni »L’installeur peut déployer une pile de supervision complète (Prometheus +
Grafana), désactivée par défaut. Vous l’activez pendant l’installation (ou plus
tard avec vuisio reconfigure).
- Prometheus scrute le SFU (
/metrics) toutes les 15 secondes en passant le jeton en bearer, et collecte aussi les métriques de l’hôte (node exporter, process exporter). - Grafana charge automatiquement un tableau de bord « Vuisio overview » : vue d’ensemble des salles et participants, caméras et micros, partages d’écran, CPU et RAM par composant et par thread, espace disque, bande passante, files inter-threads, paquets perdus et paquets UDP.
- Grafana est servi derrière nginx sur le chemin
/grafana/, restreint aux plages d’adresses (CIDR) que vous autorisez.
Si vous avez déjà votre propre Prometheus, il suffit de scruter l’endpoint
/metrics avec le jeton.