IBM Z ChatOps Intégration (version préliminaire publique)

Découvrez comment envoyer des notifications d'alerte concernant les événements d' Instana à IBM Z ChatOps.

Pour envoyer en temps réel des notifications d'alerte concernant les événements d' Instana à IBM Z ChatOps, créez un canal d'alerte IBM Z ChatOps.

Création d'un canal d'alerte « IBM Z ChatOps »

Pour créer un canal d'alerte dans l' IBM Z ChatOps, cliquez sur Paramètres > Paramètres généraux > Événements et alertes > Canaux d'alerte > Ajouter un canal d'alerte dans l'interface utilisateur d' Instana.

Canal d'alerte d'IBM Z ChatOps

  • Le champ « URL » de la table « Z ChatOps » doit pointer vers l'instance « IBM Z ChatOps » afin de pouvoir envoyer une requête POST pour les incidents, par exemple https://your_microservice_server:your_port_number/ibm/bnz/v1/incident. Pour plus d'informations, consultez la section « Intégration avec IBM Z ChatOps ».

  • Le champ « Token » doit contenir un jeton JWT de type « bearer », qui peut être extrait du microservice IBM Z ChatOps.

  • Le champ Channel doit contenir le nom du canal à partir duquel vous souhaitez recevoir des alertes dans votre service de canal (c'est-à-dire le nom du canal dans '**Mattermost**, qui est un outil de communication utilisé pour intégrer IBM Z ChatOps).

Détails de la charge utile de l'alerte

Les alertes sont reçues lorsqu'un événement est déclenché dans l'interface utilisateur d' Instana. Une adresse de terminaison « URL » est fournie lors de la création d'un canal d'alerte « IBM Z ChatOps ». La charge utile de l'alerte reçue est envoyée à ce point de terminaison URL.

Lorsqu'une entité d' IBM z/OS s déclenche une alerte dans Instana, une charge utile correspondant à cette entité spécifique est envoyée à IBM Z ChatOps. Instana prend en charge les entités suivantes d' IBM z/OS :

  • CICS
  • Db2
  • IMS

Le contenu de l'alerte contient les informations suivantes:

  • Id: ID de l'événement.
  • Récapitulatif: titre de l'événement.
  • Description: description de l'événement.
  • Priorité : les événements de type « Instana » dont la gravité est critique sont classés dans high la priorité, et tous les autres événements sont classés dans low la priorité.
  • Niveau de gravité : les événements de type « Instana » dont le niveau de gravité est «critique» sont classés dans critical la catégorie «gravité», ceux dont le niveau de gravité est «avertissement» sont classés dans minor la catégorie «gravité», et les autres événements sont classés dans low la catégorie «gravité».
  • Catégorie: alerte.
  • DateTime: Fournit l'horodatage du rapport et de l'événement au format UTC (Coordinated Universal Time).
  • Emplacement: le nom de ressource contient le nom de l'entité pour laquelle l'événement est déclenché. Des informations supplémentaires sont incluses pour les événements sur les entités IBM Z comme suit:
    • CICS: nom du sysplex, nom du système, ID SMF.
    • Db2: ID SMF.
    • IMS: ID SMF.
  • Statut: événement New ou Closed .
  • Source : Instana.
  • ChatTool Posted: inclut le nom du canal Mattermost fourni par l'utilisateur.
  • Liens : Vous trouverez ci-joint le lien vers l'événement « Instana ».
  • Zones personnalisées: en fonction du type d'événement, les données suivantes sont jointes dans l'alerte:
    • CICS: composant, région CICS et nom Cicsplex.
    • IMS: composant et ID IMS .
    • Db2: Composant et ID Db2 .

Exemple d'alerte

Concernant les problèmes en cours ou les incidents ( CICS )

Consultez l'exemple suivant de contenu d'alerte d'un événement IBM CICS avec le type Issue et le statut Open:

IBM Z ChatOps Exemple 1.1 IBM Z ChatOps Exemple 1.2