Passer au contenu
Milan · Côme · Depuis 2010SIM + SMPP / HTTP
FoxBox
Menu

SURVEILLANCE ET ALERTE

Expérimental

Grafana 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

Grafana Alertingdéclenchement de la règle d'alerte
{}Pont extérieurValider · traduire · dédupliquer
▣FoxBoxInterface HTTP documentée
▤Route SMS configuréeCarte SIM ou service externe via Kannel

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=pv Demande. 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.
La compatibilité est un contrôle de déploiement.

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.

  1. 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.

  2. Étape 2

    Créez un point de contact Webhook dans Grafana Alerting.

  3. Étape 3

    Configurez le point de terminaison du pont et l'authentification protégée.

  4. Étape 4

    Utilisez le test du point de contact avec un pont de test à blanc avant d'attribuer une politique de notification.

Ouvrir le fichier README complet de Grafana Alerting ↗

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.

config.json
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.

Terminal · tests isolés
python3 -m unittest discover -s tests -v

Vé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.

Limites actuelles

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 – image de catalogueFoxBox S2 · appareil compact à deux modems

Configuration 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 JSON

Validez 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

↑

Contact US