Aller au contenu

Acquittement vers centreon

Lorsqu'un acquittement est positionné du côté Centreon, il est nativement envoyé a Canopsis et positionné sur l'alarme ( si la configuration associée est activée ) par le Stream Connector. Ce cas d'usage montre comment faire suivre un acquittement réalisé sur Canopsis vers Centreon en se servant de l'API de celui-ci.

Pré-requis:

  • Une instance Centreon avec le Stream Connector configuré pour envoyer des événements de Centreon vers Canopsis : Canopsis Events
  • Avoir créé un utilisateur Canopsis avec les bonnes ACL pour réaliser les actions suivantes :
    • Droits nécessaires:
      • Gestion des accès aux ressources :
        • Host Resources :
          • Hosts : Include all hosts
      • Gestion des accès sur les ressources :
        • Services Actions Access :
          • Acknowledge a service
          • Disacknowledge a service
        • Hosts Actions Access :
          • Acknowledge a host
          • Disacknowledge a host

Documentation externe :

Centreon

Créer un token API pour Canopsis

Une fois qu'un utilisateur dédié à Canopsis a été créé et que ses ACL ont bien été configurées, se rendre sur la page Administration > API Tokens et créer un token pour l'utilisateur Canopsis

Centreon 1

Récupérer et sauvegarder le token généré, il sera nécessaire pour plus tard.

Canopsis

Créer une règle d'enrichissement d'entité

Pour pouvoir faire la requête d'acquittement vers Centreon, deux éléments seront nécessaires : le host_id et le service_id. Ces deux éléments devront être enrichis pour être placés dans les informations de l'entité et permettre leur utilisation dans un webhook de scénario.

Exemple d'un événement en sortie du Stream Connector : 

[
    {
        "action_url": "",
        "component": "Host-name",
        "connector": "centreon-stream",
        "connector_name": "Central",
        "event_type": "check",
        "host_id": "15",
        "hostgroups": [
            "Group 1",
            "Group 2"
        ],
        "long_output": "Plugin's long output",
        "notes_url": "",
        "output": "Plugin's output",
        "resource": "Service-name",
        "service_id": "47",
        "servicegroups": [],
        "source_type": "resource",
        "state": 1,
        "timestamp": 1708693347
    }
]

Créer une nouvelle règle d'enrichissement :

  • Identifiant: Enrichissement Centreon
  • Type: Enrichissement
  • Description: Copie les valeurs de host_id et le service_id pour les ajouter à l'entité
  • Modèles des événements:
  • Condition:
    • Recherché par: Type du connecteur
    • Condition: Egal
    • Valeur: centreon-stream
  • Et
    • Recherché par: Extra Info
    • Dictionnaire: host_id
    • Champ: Nom
    • Condition: Existe
  • Et
    • Recherché par: Extra Info
    • Dictionnaire: service_id
    • Champ: Nom
    • Condition: Existe
  • Actions (1):
    • Type: Copier une valeur d'un champ d'un événement vers une information d'une entité
    • Nom: host_id
    • Valeur: Event.ExtraInfos.host_id
  • Actions (2):
    • Type: Copier une valeur d'un champ d'un événement vers une information d'une entité
    • Nom: service_id
    • Valeur: Event.ExtraInfos.service_id

Une fois qu'un événement est envoyé et que l'alarme est créée, vérifier que les éléments apparaissent bien dans les informations de l'entité :

Centreon 2

Créer un scénario de type webhook

Il faut ensuite procéder à la création d'un nouveau scénario de type webhook en s'inspirant de l'exemple ci-dessous ( celui-ci sera automatiquement déclenché lors d'un action d’acquittement réalisée sur Canopsis ) :

  • Nom: Acquittement Centreon
  • Déclencheurs: Alarme acquittée
  • Actions:
    • Type: Webhook
    • Transmettre l'auteur à l'étape suivante : Oui
    • Comportement si le pattern ne matche pas : Fin
    • Comportement en cas d'échec : Fin
    • Comportement en cas de succès : Fin
    • Général :
      • Méthode: POST
      • URL: https://URL-DU-CENTREON/centreon/api/latest/monitoring/hosts/{{ .Entity.Infos.host_id.Value }}/services/{{ .Entity.Infos.service_id.Value }}/acknowledgements
      • En-têtes
        • Clé d'en-tête: X-AUTH-TOKEN
        • Valeur d'en-tête: Votre jeton
      • Payload: 
        {
"comment": "Acknowledged by {{ .Alarm.Value.ACK.Author }} from Canopsis",
"is_notify_contacts": false,
"is_persistent_comment": true,
"is_sticky": true
}
  • Modèles des alarmes:
    • Condition:
      • Recherché par: Origine de l'acquittement
      • Condition: Egal
      • Valeur: user
  • Modèles des entités:
    • Condition:
      • Recherché par: Type du connecteur
      • Condition: Egal
      • Valeur: centreon-stream/false
    • Et
      • Recherché par: Infos
      • Dictionnaire: host_id
      • Champ: Nom
      • Condition: Existe
    • Et
      • Recherché par: Infos
      • Dictionnaire: service_id
      • Champ: Nom
      • Condition: Existe

Tester un acquittement

Poser un acquittement côté Canopsis

Centreon 3

Retourner sur Centreon et vérifier que l'acquittement est bien visible

Centreon 4