Supervision
Le centrex expose ses métriques au format Prometheus, et livre des alertes de référence.
Brancher Prometheus
Deux façons de lire /metrics :
-
Depuis la VM, sans rien régler : Prometheus, ou un agent local qui relaie (Grafana Agent, node_exporter…), interroge
127.0.0.1:8080.scrape_configs: - job_name: centrex static_configs: - targets: ["127.0.0.1:8080"] -
Depuis votre Prometheus, à travers https, avec un jeton de supervision : menu API du portail, carte Supervision (Prometheus), Créer un jeton. La configuration à copier s’affiche une seule fois, jeton compris :
scrape_configs: - job_name: centrex scheme: https authorization: credentials: cxs_… static_configs: - targets: ["centrex.operateur.exemple"]Un seul jeton à la fois : Remplacer le jeton invalide aussitôt l’ancien, Révoquer rend
/metricsde nouveau local seulement. La carte montre la dernière lecture par Prometheus. Sans jeton valide, une requête qui passe par nginx est refusée. Seul un admin opérateur, connecté en personne, gère ce jeton : ni une clé d’API, ni l’accès d’assistance de l’éditeur.
Métriques
| Métrique | Sens |
|---|---|
centrex_info{version, schema} | Version installée et schéma de la base. |
centrex_mise_a_jour_disponible | 1 si une version plus récente attend dans le dépôt. |
centrex_freeswitch_joignable | 1 si FreeSWITCH répond. |
centrex_appels_en_cours | Appels en cours sur l’instance. |
centrex_postes_inscrits | Postes et softphones inscrits. |
centrex_licence_jours_restants | Jours de licence restants ; négatif : échue depuis tant de jours. |
centrex_licence_bloquee | 1 si la licence est échue depuis plus de 30 jours (création d’utilisateurs bloquée). |
centrex_trunks{etat} | Trunks des clients par état d’enregistrement (REGED, FAIL_WAIT, NOREG pour un trunk par adresse IP, INCONNU). |
centrex_cdr_recus | Appels gardés au journal. |
centrex_cdr_dernier_horodatage_secondes | Réception du dernier appel au journal. |
centrex_webhooks_en_attente | Envois de webhooks à livrer. |
centrex_webhooks_abandonnes | Envois abandonnés après toutes leurs tentatives. |
centrex_ip_bannies | Adresses bannies en ce moment. |
centrex_volume_taille_octets{volume} | Taille du volume : enregistrements (le leur, voir Volume des enregistrements) ou systeme. |
centrex_volume_libre_octets{volume} | Octets libres du volume. |
centrex_enregistrements_volume_dedie | 1 si les enregistrements ont leur propre volume, 0 s’ils partagent le disque système. |
centrex_bascule_passives_connectees | Actif/passif, sur l’active : passives en réplication (1 en régime établi). |
centrex_replication_retard_secondes | Actif/passif, sur l’active : retard de la passive. |
Alertes de référence
/usr/share/doc/centrex-v3/supervision/alertes.yml, à charger dans Prometheus : centrex ou
FreeSWITCH injoignable, trunk non enregistré, plus d’appels au journal en journée, webhooks en
attente ou abandonnés, trop d’adresses bannies, mise à jour en attente depuis une semaine,
actif/passif sans passive ou en retard, licence bientôt échue ou échue, chute brutale des postes
inscrits, volume des enregistrements à 80 % puis 95 % ou partagé avec le disque système, moins
de 10 % libres sur le disque système. Les seuils sont des points de départ, à ajuster.
Ajoutez une alerte sur le processeur (au-delà de 75 % en pointe, voir Dimensionnement) et sur l’espace disque, avec votre agent système.
En actif/passif, le centrex est arrêté sur la passive : supervisez les deux VM, et ne déclenchez « centrex injoignable » que si aucune des deux ne répond.
Dans le portail
La page Diagnostic montre la santé de l’instance (FreeSWITCH, base, appels au journal, webhooks, trunks), les appels en cours et les adresses bannies ; les alertes par e-mail (trunk tombé ou rétabli, licence) se règlent dans les réglages de l’instance.