SURVEILLANCE ET ALERTE
ExpérimentalGrafana Alerting
Notifications par SMS.
Intégrez les alertes des tableaux de bord dans un système de notifications mobiles. Commencez par un prototype vérifiable et une interface externe avec l'API HTTP de FoxBox.
COMMENT ÇA SE CONNECTE
01 / CAS D'UTILISATION
Une notification utile,
à partir d'un événement existant.
Une alerte Grafana est déclenchée. Un point de contact webhook envoie le groupe d'alertes à un pont externe, où les messages sont segmentés et normalisés.
Cette intégration ajoute un canal de notification SMS distinct. Elle ne garantit pas la disponibilité du service et ne remplace pas votre processus existant de gestion et d'escalade des incidents.
02 / EXIGENCES
Avant de commencer.
- Webhook d'alerte Grafana ; version cible à valider
- Un hôte distinct est dédié au pont d'intégration. Rien n'est installé sur le firmware de la FoxBox.
- Python 3 pour le pont et un environnement isolé pour le premier test.
- Une interface HTTP FoxBox compatible avec la documentation
app=ws,op=pvDemande. La version de l'appareil et du micrologiciel doit être confirmée. - Pour tout test ultérieur en conditions réelles : un destinataire autorisé, des identifiants corrects et un itinéraire SMS validé. Les itinéraires SIM nécessitent une couverture réseau ; les services externes nécessitent un accès Internet et une configuration par l’opérateur.
Aucune version physique du firmware FoxBox ni aucune instance cible de Grafana Alerting n'a été vérifiée de bout en bout pour ce prototype.
Quel modèle de FoxBox est compatible avec cette intégration ?
Choisissez le format, le nombre de modems et le réseau souhaités. Conservez « Alerte Grafana » comme contexte du projet.
Trouvez la FoxBox adaptée à cette intégration →03 / INSTALLATION
Commencez en isolement.
Préparez le pont.
Téléchargez le paquet source. Suivez les instructions du fichier README à la racine pour configurer le pont externe en mode test, en utilisant des espaces réservés et une destination de test locale.
Étape 2
Créez un point de contact Webhook dans Grafana Alerting.
Étape 3
Configurez le point de terminaison du pont et l'authentification protégée.
Étape 4
Utilisez le test du point de contact avec un pont de test à blanc avant d'attribuer une politique de notification.
04 / EXAMINER LE CODE
Rien de caché
derrière l'exemple.
Les fichiers ci-dessous proviennent du pack source d'intégration téléchargeable. Consultez le guide complet du pont et de l'intégration avant d'utiliser l'exemple.
Loading source…05 / VALIDER LE CHEMIN
Testez l'exemple.
Ensuite, testez le déploiement.
Exécutez la suite de tests isolée du dépôt depuis le répertoire extrait. Son transport simulé n'envoie pas de SMS et ne vérifie pas la distribution cellulaire.
python3 -m unittest discover -s tests -vVérifiez la charge utile attendue, le comportement de validation, la gestion des doublons et les réponses d'erreur. L'exemple ci-dessous illustre le flux localement dans votre navigateur.
Le transport des points de contact Grafana, les alertes groupées et le comportement de récupération nécessitent une validation au niveau de l'instance cible. Un test de simulation réussi ne prouve pas la réception d'un SMS.
06 / DÉPANNAGE
Rendre les échecs visibles.
Le pont rejette la charge utile.
Vérifiez la correspondance entre les champs d'intégration et la configuration fournie. Commencez par utiliser les exemples synthétiques. Ne copiez pas le contenu des événements de production ni les informations d'identification dans les journaux de support.
La requête a expiré.
Vérifiez la disponibilité du service, le protocole TLS et le format de requête attendu. Ne renvoyez pas automatiquement une requête SMS ambiguë : la première requête a peut-être déjà été acceptée.
L'API a accepté la requête, mais aucun SMS n'est arrivé.
L'acceptation de la demande ne constitue pas une confirmation de livraison. Veuillez vérifier l'état des messages FoxBox et les conditions du réseau mobile sur l'appareil réel ; le prototype ne permet pas de confirmer la livraison.
Un événement en double a été envoyé.
Vérifiez les paramètres de clé d'événement et de déduplication du pont. Validez les événements groupés et de récupération dans le logiciel cible avant d'activer les notifications en direct.
DE L'INTÉGRATION AU MATÉRIEL
Choisissez le format.
Valider l'ajustement.
Commencez par le modèle S1 pour un modem, S2 pour deux, ou SR pour un déploiement en rack. L'intégration à elle seule ne détermine pas les exigences en matière de capacité ou de résilience des modems.
FoxBox S2 · appareil compact à deux modemsConfiguration et validation
Configuration technique : Grafana
Connexion via un pont externe
Créez un point de contact Webhook avec une requête HTTP POST, l'URL du pont et l'authentification Bearer. Conservez la charge utile Webhook native de Grafana. Définissez le nombre maximal d'alertes à 20 pour l'analyseur fourni et activez les notifications résolues. Acheminez une politique de notification à portée limitée vers ce point de contact avant d'envisager des groupes d'alertes plus larges.
Le pont analyse les empreintes digitales des alertes ainsi que leurs heures de début et de fin afin de distinguer les groupes d'alertes déclenchées et résolues. Il limite la taille des messages et rejette les charges utiles inappropriées ; il n'envoie pas silencieusement une liste tronquée de toutes les alertes. Conservez les identifiants du pont dans le champ d'autorisation protégé de Grafana et ceux de FoxBox uniquement sur l'hôte du pont.
Exemple de configuration · remplacer les espaces réservés avant utilisation
URL: https://bridge.example.invalid/webhooks/grafana
HTTP method: POST
Authorization scheme: Bearer
Authorization credentials: <PRIVATE_BRIDGE_TOKEN>
Max Alerts: 20
Disable resolved message: false
Payload: default Grafana webhook JSONValidez avant d'activer le transport
- Utilisez un groupe de déclenchement synthétique, une livraison en double, un groupe résolu et un groupe surdimensionné ; vérifiez l’identité du registre et le comportement de rejet avec la simulation activée.
Références : Grafana webhook notifier
API FoxBox : paramètres, erreurs et état · Authentification de l'adaptateur et gestion des doublons
