Guide d'intégration d'Opsview

Opsview est une version dérivée du système de supervision Nagios. Par conséquent, la procédure d'intégration à votre compte PagerDuty est similaire à celle de la configuration de Nagios.

En intégrant PagerDuty à votre solution de surveillance Nagios existante, vous pouvez faire en sorte que les alertes Nagios soient directement transmises à la personne compétente capable de résoudre le problème.

Configuration de l'intégration PagerDuty / Opsview

Dans PagerDuty

1. De la part de Services menu, sélectionnez Répertoire des services.
2. Sur votre page Services : si vous créez un nouveau service pour votre intégration, cliquez sur +Ajouter un nouveau service Si vous ajoutez votre intégration à un service existant, cliquez sur le nom du service auquel vous souhaitez ajouter l'intégration. Cliquez ensuite sur Intégrations onglet et cliquez sur Ajouter un Nouvelle intégration lien.
3. Sélectionnez votre application parmi les Type d'intégration menu et entrez un Nom de l'intégration Si vous créez un nouveau service pour votre intégration, dans les paramètres généraux, saisissez un Nom pour votre nouveau service. Ensuite, dans les paramètres d'incident, spécifiez le Politique d'escalade , Notification urgente , et Comportement lors de l'incident pour votre nouveau service.
4. Cliquez sur Ajouter un service ou Ajouter une intégration Cliquez sur le bouton pour enregistrer votre nouvelle intégration. Vous serez redirigé vers la page Intégrations de votre service.
   
5. Copiez le Clé d'intégration pour votre nouvelle intégration :

Sur votre serveur

1. Installez les dépendances Perl nécessaires :
   

    aptitude installer libwww-perl libcrypt-ssleay-perl 

   OU

    yum install perl-libwww-perl perl-Crypt-SSLeay 

2. Téléchargez pagerduty_nagios.pl et copiez-le dans /usr/local/nagios/libexec/notifications.
   

    wget https://raw.github.com/ryanhoskin/pagerduty-opsview-pl/master/pagerduty_nagios.pl cp pagerduty_nagios.pl /usr/local/nagios/libexec/notifications 

3. Assurez-vous que le fichier est exécutable par l'utilisateur Nagios.
   

    chmod 755 /usr/local/nagios/libexec/notifications/pagerduty_nagios.pl 

4. Activez les macros de variables d'environnement dans /usr/local/nagios/configs/Master Monitoring Server/nagios.cfg (si elles ne sont pas déjà activées).
   

    activer_macros_environnement=1 

5. Modifier le crontab de l'utilisateur Nagios.
   

    crontab -u nagios -e 

6. Ajoutez la ligne suivante à la crontab.
   

    * * * * * /usr/local/nagios/libexec/notifications/pagerduty_nagios.pl flush 

Dans Opsview

1. Accédez à votre interface de gestion Web Opsview.
2. Allez à Avancé > Méthodes de notification .
3. Cliquez sur le + icône.
   
4. Remplissez le formulaire comme suit (assurez-vous de saisir PAGERDUTY_SERVICE_KEY et non votre clé de service réelle dans le champ Variables de contact).
   

   Remarque : Si vous utilisez Opsview 4 ou une version ultérieure, vous devrez modifier la commande comme suit en remplaçant PAGERDUTY_SERVICE_KEY par votre clé API de service.

    pagerduty_nagios.pl enqueue -f CONTACTPAGER='PAGERDUTY_SERVICE_KEY' 

5. Cliquez sur Soumettre les modifications .
6. Allez à Configuration > Contacts .
7. Cliquez sur le + icône.
   
8. Remplissez le formulaire comme suit (le mot de passe peut être n'importe quoi) :
   
9. Cliquez sur Notifications .
10. Saisissez votre clé API de service dans la case prévue à cet effet : Requis pour PagerDuty Votre clé de service se trouve sous Services > ( Nom de votre service ) > Paramètres d'intégration > Clé API du service .
    
11. Cliquez sur Soumettre et Modifier les profils de notification .
12. Cliquez sur le + icône.
    
13. Saisissez le nom « pagerduty » et cochez la case pagerduty Cochez la case située sous la section « Notifier par ». Laissez tous les autres paramètres par défaut.
    
14. Cliquez sur Soumettre les modifications .
15. Cliquez sur le lien « État de la configuration » (situé au-dessus des menus), puis sur le bouton « Recharger la configuration » pour forcer OpsView à générer tous les fichiers de configuration Nagios.

Vous avez maintenant ajouté les notifications Opsview à PagerDuty.

FAQ

Comment configurer Opsview pour qu'il fonctionne avec plusieurs services PagerDuty ?

C’est très simple avec l’intégration actuelle, car un service Nagios dans PagerDuty est directement associé à un contact. Par défaut, ce contact est nommé « pagerduty » et défini dans Configuration > Contacts.

Pour configurer plusieurs services, il suffit de dupliquer la définition de contact existante et de la renommer (par exemple, pagerduty_database, pagerduty_network, etc.). Copiez ensuite le contenu correspondant et collez-le. API Saisissez la clé depuis PagerDuty dans le champ « pager ». N'oubliez pas de redémarrer Nagios pour que les modifications soient prises en compte.

Que se passe-t-il si un événement Opsview survient pendant que mon réseau est hors service ?

Si un serveur PagerDuty est inaccessible, les événements seront stockés dans une file d'attente sur disque. La tâche cron installée tentera de renvoyer les événements à une minute d'intervalle.

Si un serveur PagerDuty est inaccessible pour une raison quelconque, les événements seront enregistrés sur disque à intervalles d'une minute.

Étant donné qu'Opsview a besoin de ma connexion Internet externe pour envoyer des rapports de panne à PagerDuty, comment serai-je notifié si notre site perd sa connectivité externe ?

Il est recommandé de configurer un service de test de ping externe pour surveiller la connectivité externe de votre site. Vous pouvez ensuite utiliser PagerDuty pour recevoir les alertes de ces services.

Ça ne semble pas fonctionner. Que se passe-t-il ?

Consultez le journal système pour rechercher les messages provenant de « pagerduty_nagios ». Sur la plupart des systèmes :

 grep pagerduty_nagios /var/log/syslog 

S'il te plaît Contactez-nous si vous n'arrivez pas à résoudre le problème.

Quels types de messages Nagios PagerDuty comprend-il ?

PagerDuty peut traiter PROBLÈME , RECONNAISSANCE , et RÉCUPÉRATION messages. Tous les autres messages, y compris DÉMARRAGE À COUPE et FLAPPINGSTOP Ces messages sont ignorés. Si vous souhaitez que PagerDuty traite d'autres messages Nagios, veuillez nous le faire savoir !