Skip to content

About

Bobi.Tools — plugin nmos_monitor

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Supervision NMOS (BCP-008) — plugin Bobi.Tools

Supervision d'état des receivers et des senders NMOS selon AMWA BCP-008-01 / BCP-008-02, pour Bobi.Tools. L'outil restitue fidèlement ce que les équipements déclarent ; il ne définit aucune alarme de son cru.

Ce que fait l'outil

  • Découverte des Devices qui annoncent le contrôle IS-12 (urn:x-nmos:control:ncp), exploration de leur modèle MS-05-02 et repérage des objets NcReceiverMonitor / NcSenderMonitor, rattachés à leur receiver ou sender IS-04 par le touchpoint.
  • Abonnement en WebSocket aux moniteurs, comme la spec l'exige : après la lecture initiale, rien n'est sondé. L'outil s'abonne aussi aux blocs du modèle, si bien que des moniteurs publiés à chaud sont pris en charge sans couper le lien.
  • Statuts normalisés : global, lien, connexion / transmission, synchronisation, flux / essence, avec le compteur de transitions (×N) qui distingue un défaut franc d'un flux qui bat, et les compteurs de paquets perdus ou en retard quand l'équipement les expose.
  • Table filtrable et triable (recherche, Rx/Tx, format, état), tri par sévérité, compteur « affichés / total ».
  • Remise à zéro des compteurs d'un moniteur (commande IS-12 envoyée à l'équipement).

À savoir

  • Un équipement qui fait IS-04 et IS-05 mais pas IS-12 ne peut pas être supervisé ici.
  • Un retour au vert qui tarde de quelques secondes est conforme : la spec impose un statusReportingDelay (3 s par défaut) avant de remonter un rétablissement.
  • Des compteurs absents ne valent pas zéro perte : l'outil affiche « aucun compteur exposé ».
  • Un équipement muet est détecté par un ping WebSocket après 20 s de silence ; à la perte du lien, les statuts sont invalidés plutôt que figés.
  • Validé sur un équipement 2110 réel (24 moniteurs, pleinement conforme). Limites : pas d'authentification IS-10 / BCP-003-02, pas de découverte DNS-SD, pas d'alerte par courriel.

Prérequis

  • Bobi.Tools avec Docker : l'outil tourne en conteneur (runtime: docker).
  • Le plugin Parc NMOS (nmos_parc) : l'outil ne déclare aucun équipement et lit son park.json en lecture seule (volume partagé). Sans lui, le panneau « Parc » explique pourquoi rien n'apparaît.
  • Des équipements NMOS exposant IS-12 et des moniteurs BCP-008.

Installation

Dans Bobi.Tools : Réglages → Outils → Catalogue, bouton « Installer ». Ou, sur une machine neuve, en une ligne :

bash <(curl -fsSL https://raw.githubusercontent.com/bob-integration/bobitools/main/get.sh) --outils nmos_monitor

L'aide complète est dans help.md, affichée dans Bobi.Tools (menu « ? » → Aide). Un banc d'essai sans matériel (équipement NMOS factice conforme) se lance avec ./tests/run.sh.

Sécurité

  • Le conteneur n'a pas d'authentification propre : son port n'est publié que sur 127.0.0.1, il n'est donc joignable qu'à travers Bobi.Tools, qui contrôle les droits.
  • Les connexions IS-04 et IS-12 partent du serveur, sans authentification. La remise à zéro des compteurs, seul geste qui écrit sur un équipement, demande une permission dédiée.

In English

AMWA BCP-008-01 / BCP-008-02 status monitoring of NMOS receivers and senders for Bobi.Tools. It discovers IS-12 capable Devices, walks their MS-05-02 model, subscribes over WebSocket to NcReceiverMonitor / NcSenderMonitor objects (and to blocks, so monitors added later are picked up) and displays the normalised statuses, transition counters and packet counters — no polling, no home-made alarms. Requires Docker and the nmos_parc plugin (read-only shared park).

Licence

GPL-3.0-or-later — © 2026 BOBI SAS. Voir LICENSE.

About

Bobi.Tools — plugin nmos_monitor

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages