JET Notification API
L’API de notification JET vous permet de vous abonner aux événements et de désigner une fonction de rappel pour recevoir les événements lorsqu’ils se produisent. Ces interfaces Python fournissent une interface au système de notification MQTT qui, pour les langages autres que Python, doit être géré en dehors de JET (voir Programmation de la notification JET pour les langages non Python). Pour plus d’informations sur MQTT et Python, voir https://mosquitto.org/ .
Format JSON des messages de notification JET
La notification JET est délivrée au format JSON. Le message JSON comporte deux parties : l’en-tête et les attributs. L’en-tête est commun à tous les événements. Il contient l’ID de l’événement, le nom d’hôte, l’heure, la gravité et l’installation de l’événement. Les attributs contiennent des informations sur l’événement et varient en fonction du nom du sujet de l’événement.
Tous les événements rtsock du noyau auront info comme la gravité et KERNEL la facilité. Pour les événements syslog, la gravité et l’installation seront les mêmes que celles des messages syslog Junos OS.
Voici un exemple de fichier JSON d’événement.
“jet-event”: {
“event-id”: “KERNEL_EVENT_IFD_ADD”
“hostname”: “mydevice”,
“time”: “2016-01-07”,
“severity”: “info”,
“facility”: “KERNEL”,
“attributes”: {
“name”: “ge-0/0/0”,
“snmp-id”: 520,
“flags”: 8
}
}
Consultez package d’applications JET pour plus d’informations sur JSON.
S’abonner aux événements
Les applications développées à l’aide de JET peuvent s’abonner aux événements répertoriés dans le tableau 1. Un sujet est un point de terminaison auquel les clients se connectent. Un sujet agit comme le centre de distribution pour la publication et l’abonnement des messages. Les sujets sont des chaînes hiérarchiques simples, encodées en UTF-8, délimitées par une barre slash.
Événements |
Sujet |
Informations d’événement renvoyées |
|---|---|---|
Interface physique (IFD) |
|
nom, snmp-id, flags |
Inteface logique (IFL) |
|
nom, sous-unité, snmp-id, flags |
Famille (IFF) |
|
nom, sous-unité, famille, nom de la table, flags |
Adresse |
|
nom, sous-unité, famille, adresse locale, adresse de destination, adresse de diffusion, flags |
Pare-feu |
|
nom, version, id client, type de filtre, protocole, nom de l’interface, indicateurs |
Route |
|
nom de la table, nom du routeur logique, famille d’adresses, type de route, préfixe de route, arrayof(adresse suivante), flags |
Table de routage |
|
nom, nom du routeur logique, famille d’adresses, flags |
Syslog |
/junos/events/syslog/event-id |
arrayof(paires attribut-valeur) |
Programmation de la notification JET pour les langages non Python
De nombreuses langues de haut niveau disposent d’une bibliothèque MQTT. Une application JET peut utiliser la bibliothèque correspondante pour se connecter au broker MQTT s’exécutant sur Junos OS et s’abonner aux événements. Par exemple, voici un exemple de programme JAVA qui se connecte à un courtier MQTT et s’abonne à des événements : Exemple de messagerie MQTT en Java.
Pour plus de détails sur des bibliothèques MQTT pour différentes langues, voir le tableau 2.
Nom de la langue |
Lien de licence |
|---|---|
C, Mosquitto |
|
C++, Mosquitto |
|
Python, Mosquitto |
|
Ruby, Ruby-mqtt |
|
Java, Eclipse Paho Java |
|
Aller, Eclipse Paho Go |
|
C#, MqttDotNet |