Disponibles à ce jour :

• Email
• SNMP Trap
• ServiceNow
• Zabbix
• Discord
• Telegram

D’autres intégrations se font facilement avec l’Integration builder.

Sélectionner l’intégration voulue pour chaque alerte

1. Créez un bot en suivant core.telegram.org/bots/features#botfather
   À la création vous recevez un jeton d’API, par ex. "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw"
   
   
   
   
2. Ouvrez une conversation avec le bot que vous venez de créer et cliquez sur « START » ; vous pouvez aussi envoyer /start, puis un message de test
   
   
3. Ouvrez une nouvelle fenêtre sur l’URL https://api.telegram.org/bot<TOKEN>/getUpdates, où vous remplacez <TOKEN> par celui de l’étape 1
   
   
4. Dans le JSON obtenu, vous devez trouver chat.id, par exemple "123456789"

   "chat":{
      "id":123456789,
      "first_name":"First",
      "last_name":"Second",
      "type":"private"
   },
   

5. Créez une Custom integration dans XorMon, avec le <TOKEN> et le <CHAT_ID> :
   URL : https://api.telegram.org/bot<TOKEN>/sendMessage
   Headers : Content-Type: application/json
   
   Un corps JSON personnalisé avec les clés « chat_id » et « text » est requis ; « chat_id » est la valeur de l’étape 4 :
   
   
6. Quand une alerte se déclenche, vous recevez le message :
   

XorMon emploie zabbix_sender pour envoyer ses alertes à Zabbix.

1. Installez l’agent Zabbix par le moyen de votre choix :
   RedHat :
   

   dnf install https://repo.zabbix.com/zabbix/6.4/rhel/8/x86_64/zabbix-release-6.4-1.el8.noarch.rpm
   sudo dnf clean all
   sudo dnf install zabbix-sender

   Debian :

   wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian12_all.deb
   dpkg -i zabbix-release_latest_7.0+debian12_all.deb
   apt update
   apt install zabbix-sender

2. Installez zabbix_sender selon votre plateforme :
   www.zabbix.com/documentation/current/en/manual/installation/install_from_packages
   repo.zabbix.com/zabbix/
   
   
3. Créez un hôte dans Zabbix, ou reprenez-en un
   
4. Créez un item pour cet hôte, avec :
   Type : Zabbix trapper
   Type of information : Text
   
   
5. Dans XorMon, renseignez Zabbix Server, Port, Host et Key tels que saisis dans Zabbix
   
6. Appuyez sur Test pour vérifier le message de test dans Zabbix
   

L’Integration builder permet d’envoyer les événements matériels et les alertes de XorMon vers tout autre outil qui accepte une API REST ou des webhooks.
Avec l’Integration builder, vous composez la requête :

• URL du point d’accès
• méthode (GET, POST, PUT, PATCH, DELETE)
• en-têtes de la requête
• corps de la requête, au format JSON

Le corps de la requête accepte plusieurs variables prédéfinies portant les informations de l’alerte.
Par exemple

• {DEVICE} : nom de l’équipement
• {STATUS} : état rapporté
• {METRIC} : nom de la métrique en alerte
• {VALUES} : valeurs qui ont déclenché l’alerte
• {ITEMS} : liste des éléments qui franchissent le seuil
• Et d’autres

Configuration
Interface XorMon → Settings → Alerting → onglet Integrations



Exemples de corps de requête pour une alerte de performance :

{
  "name": "Custom Alert",
  "data": {
    "items": "{ITEMS}",
    "level": "{LEVEL}",
    "limit": "{LIMIT}",
    "metric": "{METRIC}",
    "values": "{VALUES}"
  }
}     

Ajoutez l’intégration nouvellement créée à une configuration d’alerte ou d’événement matériel

Comment employer l’Integration builder pour envoyer les alertes de XorMon vers Discord par un webhook.

• Créez un webhook dans Discord
  Allez dans les paramètres du serveur -> Integrations -> Webhooks
  Saisissez le nom et le salon où vous voulez recevoir les messages.
  
  
• Copiez l’URL du webhook
  
  
• Créez une Integration dans XorMon
  - Allez dans Settings -> Alerting -> Integrations
  - Cliquez sur « New Integration »
  - Sélectionnez la méthode POST
  - Collez l’URL du webhook Discord
  - Ajoutez l’en-tête « Content-Type: application/json »
  - Ajoutez le message JSON
  - Le message doit contenir :
  
  - « username » : le nom employé à la création du webhook
  - « content » : le contenu du message envoyé au salon Discord
  
  
  Exemple de message pour un événement matériel :
  

  {
    "content": "HW Event: {DEVICE} ({CLASS}/{HW_TYPE}) changed to {STATUS} ({REASON})",
    "username": "XorMon"
  }

  
  
• Testez l’intégration
  Vous devez recevoir le message de test dans le salon Discord
  
  
• Employez la nouvelle intégration dans une configuration d’événement matériel