Tout ce que vous avez toujours voulu savoir sur Centreon et Opsgenie sans oser le demander

Centreon, plateforme de supervision de référence, fournit des données de qualité et des capacités d’agrégation et de corrélation inégalées pour disposer d’une visibilité complète du Cloud jusqu’à l’Edge. Dans un environnement IT qui s’enrichit chaque jour de nouveaux outils pour garantir la fiabilité du SI des entreprises numériques, Centreon se positionne comme une solution de supervision connectée, capable de s’interfacer avec des outils tels que Opsgenie pour renforcer la qualité de l’analyse de l’état du SI. Voici enfin tous les secrets de la connexion de Centreon avec Opsgenie.

De l’importance de la supervision connectée

Seulement 27% des répondants au Baromètre de la supervision IT réalisé par Centreon considèrent comme excellente la visibilité sur les niveaux de performance IT, ce qui peut s’expliquer par le fait que seulement 61% du SI, en moyenne, est supervisé.

Des chiffres qui donnent à réfléchir sur l’importance de faire circuler les données et de les exploiter au sein d’une supervision ouverte, adaptable, évolutive et surtout connectée au reste du monde… On est connecté ou on ne l’est pas… Mais dans un monde devenu digital il vaut mieux l’être.

C’est pourquoi Centreon met à la disposition des ITOps un panel d’outils pour s’interfacer avec les solutions complémentaires qui permettent de disposer d’une meilleure visibilité sur le SI et d’informations sur sa santé, sa disponibilité, sa vie, son œuvre…

Pourquoi interfacer l’outil de gestion des incidents Opsgenie avec Centreon ?

Parlons d’Opsgenie, une plateforme de gestion des incidents conçue pour mettre en évidence les incidents critiques et réduire les temps de réactions des équipes concernées. Opsgenie reçoit des alertes des systèmes de supervision et des apps personnalisées et effectue un classement selon l’importance et le timing.

L’outil notifie des alertes par différents canaux de communication (appels, e-mails, SMS et messages push sur mobiles).

Intégrer des données que Centreon sait collecter avec fiabilité et précisions peut donc être une excellente option pour gagner en visibilité. Une approche rendue possible par le fait qu’il est possible d’intégrer Opsgenie avec des outils de supervision, d’ITSM ou de chat, ce qui va nous permettre de connecter Centreon avec Opsgenie afin de bénéficier du meilleur des deux mondes. 

CQFD !

Votre sésame : le Stream Connector

Fans d’Harry Potter, désolés de vous décevoir. Opsgenie et Centreon ce n’est pas magique, c’est juste technologique… et cela est rendu possible via le Stream Connector, une précieuse fonctionnalité de la plateforme Centreon qui formate et transfère les données de supervision (métriques ou événements) de Centreon vers un outil externe.

Pour interfacer votre outil de supervision préféré avec Opsgenie, Centreon met à votre disposition un Stream Connector. Deux choses à noter pour retrouver ses petits :

  • Les alertes de supervision Centreon deviennent des alertes dans Opsgenie,
  • Les alertes applicatives du module Centreon BAM deviennent des incidents dans Opsgenie.

Passons aux choses sérieuses : configurons Opsgenie…

La configuration se fait en deux étapes. 

Configuration de l’API pour les incidents

  1. Allez dans le menu Settings.
  2. Dans la partie Integrations, cliquez sur Integration list.
  3. Ajoutez une intégration API (Rest API HTTPS over JSON).
  4. Configurez votre intégration en allant dans le sous menu Configured integrations.
  5. Cliquez sur l’intégration API.
  6. Cochez les droits Create and Update Access.
  7. Assurez-vous d’avoir coché Enabled.
  8. Conservez votre API Key qu’il faudra pour Centreon.
  9. Sauvegardez votre configuration.

Configuration de l’API pour les alertes

  1. Allez dans le menu Settings.
  2. Dans la partie APP SETTINGS, cliquez sur API key management.
  3. Cliquez sur le bouton Add new API key.
  4. Nommez votre clé d’API.
  5. Conservez votre API Key qu’il faudra pour Centreon.
  6. Cochez la case Create and update.
  7. Cliquez sur le bouton Add API key.

… et configurons Centreon

Là aussi deux étapes : 

Installation du Stream Connector

  1. Connectezvous en SSH sur votre serveur Centreon central avec un utilisateur root.
  2. Installez les dépendances Lua nécessaires
    yum install -y lua-curl epel-release
  3. Téléchargez le Stream Connector
    wget -O /usr/share/centreon-broker/lua/opsgenie.lua https://raw.githubusercontent.com/centreon/centreon-stream-connector-scripts/master/centreon-certified/opsgenie/opsgenie-apiv1.lua
  4. Configurez les droits
    chmod 644 /usr/share/centreon-broker/lua/opsgenie.lua

Configuration du Stream Connector

  1. Connectez-vous à l’interface de votre Centreon avec un compte admin.
  2. Allez dans le menu Configuration > Collecteurs et sélectionnez Configuration du broker.
  3. Cliquez sur la configuration broker central-broker-master.
  4. Allez dans l’onglet Output.
  5. Ajoutez un nouvel output Generic – Stream connector.
  6. Nommez-le selon votre convenance.
  7. Renseignez le chemin du Stream Connector /usr/share/centreon-broker/lua/opsgenie.lua
  8. Ajoutez un paramètre string nommé app_api_token qui a pour valeur la clé d’API des alertes.
  9. Ajoutez un paramètre string nommé integration_api_token qui a pour valeur la d’API des incidents.
  10. Ajoutez un paramètre string nommé api_url qui a pour valeur https://api.opsgenie.com ou https://api.eu.opsgenie.com si vous êtes en Europe.
  11. Sauvegardez votre configuration.
  12. Allez dans le menu Configuration > Collecteurs et sélectionnez Collecteurs.
  13. Sélectionnez le collecteur Central.
  14. Cliquez sur le bouton Exporter la configuration.
  15. Cochez les cases Générer les fichiers de configuration, Lancer le débogage du moteur de supervision (-v) et Déplacer les fichiers générés.
  16. Cliquez sur le bouton Exporter.
  17. Connectez vous en SSH sur votre serveur Centreon central avec un utilisateur root.
  18. Redémarrez le démon cbd
    systemctl restart cbd

Bravo ! Votre plateforme Centreon est désormais prête à adresser des alertes à Opsgenie ! 

Exemple du suivi d’une alerte Centreon dans Opsgenie

L’origine : Centreon

Etudions de plus près le parcours d’une alerte. Notre hôte Yellow-submarine est supervisé par Centreon. Une alerte sur le service sky-of-blue est présente. 

La transmission : le Stream Connector

En mettant un niveau de verbosité accentué pour les logs du Stream Connector, nous obtenons les informations suivantes :

Wed Feb 10 11:08:05 2021: INFO: EventQueue:call: request body {« message »: »2021-02-10 11:08:05 Yellow-submarine // sky-of-blue is CRITICAL », »description »: »sky is cloudy », »alias »: »Yellow-submarine_sky-of-blue_CRITICAL »}
Wed Feb 10 11:08:05 2021: INFO: EventQueue:call: Call url https://api.eu.opsgenie.com/v2/alerts
Wed Feb 10 11:08:05 2021: INFO: EventQueue:call: HTTP Code : 202
Wed Feb 10 11:08:05 2021: INFO: EventQueue:call: Response body : {« result »: »Request will be processed », »took »:0.007, »requestId »: »e2543449-9399-44ff-89a9-875040906a0c »}

Dans son fonctionnement de base, nous constatons que le Stream Connector génère un JSON formaté pour Opsgenie. Le JSON est alors envoyé à l’adresse adéquate. 

Opsgenie nous indique la bonne réception de l’alerte

La réception : Opsgenie

Côté Opsgenie, nous pouvons à présent retrouver notre alerte sur le service sky-of-blue.

Rentrons dans les détails de cette alerte.

Nous avons ainsi notre suivi des activités de cette alerte au sein d’Opsgenie qui correspond au traitement fait par le Stream Connector de Centreon !

Pour aller plus loin

Le Stream Connector propose de nombreuses options pour permettre d’affiner les alertes envoyées à Opsgenie. Vous trouverez toutes les informations nécessaires à la personnalisation de votre configuration sur notre documentation dédiée à ce Stream Connector.