Récupération des alertes

IntentPlatform vous offre la possibilité de récupérer les alertes présentes sur intentPlatform. Ces alertes peuvent être de 2 types :
  • alertes sur les flux métriques ou événements
  • alertes sur les opérations (interventions, devis, réserves)

La récupération des alertes se fait par l'intermédiaire d'une notification appelée  webhook .
Le mécanisme des webhooks est un mécanisme synchrone de communication, qui ne peut pas être renvoyé lors d'interruption de service, il ne peut donc pas être utilisé en tant qu'unique source de données.

Configuration

La configuration se réalise directement sur la plateforme dans intentStudio.

Dans la rubrique Paramètres, sélectionnez "Notifications alertes métiers".
Vous devez renseigner une Url de webhook sur laquelle la plateforme viendra vous notifier dès qu'une alarme aura été générée.

Vous devez vous abonner aux types de notification que vous souhaitez recevoir :
  • Alertes des flux métriques et événements pour les alertes générées à partir des streams (Sur-chauffe bâtiment, panne ascenseurs, etc.)
  • Alertes sur les opérations pour les alertes générées à partir des interventions, devis, réserves (intervention hors délais, devis non transmis depuis +72h, etc.)

https://slite.com/api/files/izEcVRMU2/Capture%20d%E2%80%99e%CC%81cran%202021-12-08%20a%CC%80%2010.55.59.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiYmdKbGM5SG1FWSIsImlhdCI6MTcyOTA5MjEyNCwiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJrWTk1dWMxNVB3UmpmOCIsImV4cCI6MTczMTY4NDEyNH0.YZ6zjEkt8thDR9Fsx7YcTUA02aDzVxW9DWdogcWUPWY

Notification

Pré-requis

L'utilisateur doit paramétrer, dans intentStudio, des seuils d'alertes afin qu'une alerte soit générée sur intentPlatform en fonction des règles qu'il aura définies.
L'utilisateur devra indiquer qu'une notification de type webhook devra être générée en cas de respect des conditions de déclenchement.

https://slite.com/api/files/pw9fWPgih/Capture%20d%E2%80%99e%CC%81cran%202021-12-08%20a%CC%80%2011.02.51.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiYmdKbGM5SG1FWSIsImlhdCI6MTcyOTA5MjEyNCwiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJrWTk1dWMxNVB3UmpmOCIsImV4cCI6MTczMTY4NDEyNH0.YZ6zjEkt8thDR9Fsx7YcTUA02aDzVxW9DWdogcWUPWY
Une notification sera transmise sur l'url de webhook dès qu'une des conditions de déclenchement aura été rencontrée.

Message

L'utilisateur peut définir, pour le contenu "event" du webhook, les champs transmis et leur valeur lors de la configuration du seuil d'alerte.

https://slite.com/api/files/8bADRMb5r/Capture%20d%E2%80%99e%CC%81cran%202021-12-08%20a%CC%80%2011.10.36.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiYmdKbGM5SG1FWSIsImlhdCI6MTcyOTA5MjEyNCwiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJrWTk1dWMxNVB3UmpmOCIsImV4cCI6MTczMTY4NDEyNH0.YZ6zjEkt8thDR9Fsx7YcTUA02aDzVxW9DWdogcWUPWY
Ci-dessous un exemple de message transmis suite à la génération d'une alerte.
[
  {
    "type": "monitors:timeseries",
    "id": "8bdd8355-a832-4bf0-a513-f99dcfbcfbd7",
    "event": {
      "alertTitle": "Pannes ascenseurs",
      "labelAsset": "Ascenseur",
      "assetReference": "01-MAR-1042-000-01-ASC1",
      "alertStatus": "Critique",
      "alertValue": "HIGH"
    }
  }
]