Guide d'intégration de SolarWinds Orion

Les produits de la plateforme SolarWinds Orion, tels que Network Performance Monitor (NPM) et Server & Application Monitor (SAM), assurent la surveillance du réseau, des performances, de la disponibilité et des serveurs pour les réseaux multifournisseurs et les systèmes Linux et Windows Server, ainsi que des indicateurs détaillés de performance applicative pour plus de 200 applications, telles qu'Apache HTTP Server, Microsoft Exchange et Oracle Database. NPM et SAM permettent de déclencher et de réinitialiser des alertes en fonction de seuils personnalisés, susceptibles de déclencher et de résoudre des incidents dans PagerDuty.

Lorsque SolarWinds Orion crée une notification d'alerte pour un nœud, un composant ou une application, il envoie un événement à un service dans PagerDuty. Cet événement déclenchera un nouvel incident sur le service PagerDuty associé, ou grouper comme alertes dans un incident existant. Cette intégration fonctionne en envoyant des alertes SolarWinds Orion au format JSON, grâce à notre API d'événements .

Lorsque le nœud, le composant ou l'application atteint un état récupéré dans SolarWinds, un événement de résolution sera envoyé au service PagerDuty pour résoudre l'alerte et l'incident associé sur ce service.

Compatibilité

Les intégrations PagerDuty nécessitent un Rôle de base du gestionnaire ou supérieur pour l'autorisation de compte. Si vous ne disposez pas de ce rôle, veuillez contacter un administrateur ou un propriétaire de compte au sein de votre organisation pour configurer l'intégration.

Ce guide et le corps de la requête HTTP ont été écrits et testés sur Windows Server 2012 R2 avec la plateforme SolarWinds Orion 2015.1, 2016.1, 2018.4 et 2019.2. Veuillez consulter notre Guide d'intégration de l'ancien SolarWinds NPM Si vous possédez une ancienne version de NPM, les versions antérieures des produits SAM/APM et SolarWinds n'utilisant pas la plateforme Orion peuvent être configurées pour envoyer des alertes à PagerDuty via un intégration de messagerie électronique plutôt.

Dans PagerDuty

Il existe deux manières d'intégrer SolarWinds Orion à PagerDuty: via le routage global des événements ou directement via une intégration sur un service PagerDuty .

Si vous intégrez SolarWinds Orion à un service PagerDuty existant, passez à la section Intégration à un service PagerDuty de ce guide.

Intégration avec l'orchestration d'événements

L'intégration avec Event Orchestration vous permet d'acheminer les événements vers des services PagerDuty spécifiques en fonction de la charge utile de l'événement issue de l'outil intégré. Pour en savoir plus, consultez notre article sur Orchestration d'événements .

1. Accéder à AIOps → Orchestration d'événements et sélectionnez votre orchestration préférée.
2. Sélectionnez le Intégrations onglet puis copiez votre favori Clé d'intégration Conservez cette clé en lieu sûr pour une utilisation ultérieure. Une fois l'intégration configurée, vous reviendrez à cette interface pour spécifier comment acheminer les événements vers les services dans PagerDuty.

Intégration avec un service PagerDuty

L'intégration directe avec un service PagerDuty peut être avantageuse si vous n'avez pas besoin d'acheminer les alertes de SolarWinds Orion vers différents intervenants en fonction de la charge utile de l'événement. Vous pouvez toujours utiliser règles d'événement au niveau du service pour effectuer des actions telles que la suppression des alertes non exploitables et l'ajustement de la gravité.

1. De la Services menu, sélectionner Annuaire des services .
2. Si vous ajoutez votre intégration à un service existant , cliquez sur le nom du service auquel vous souhaitez ajouter l'intégration. Sélectionnez ensuite l'option Onglet Intégrations et cliquez sur le Ajouter une nouvelle intégration Si vous créez un nouveau service pour votre intégration, veuillez lire notre documentation dans la section Configuration des services et des intégrations et suivez les étapes décrites dans le Créer un nouveau service section.
3. Sélectionnez SolarWinds Orion dans le Type d'intégration menu.
4. Cliquez Ajouter une intégration pour enregistrer votre nouvelle intégration. Vous serez redirigé vers l'onglet « Intégrations » de votre service.
5. Recherchez votre intégration dans la liste et cliquez sur ∨ à droite. Un Clé d'intégration sera générée sur cet écran. Conservez cette clé en lieu sûr, car elle sera utilisée lors de la configuration de l'intégration avec SolarWinds Orion dans la section suivante.

Sur votre serveur SolarWinds

1. Connectez-vous à SolarWinds en tant qu'administrateur, puis accédez à la Paramètres menu et sélectionnez Tous les paramètres (ou cliquez Paramètres (dans le coin supérieur droit de la page si vous possédez une ancienne version de SolarWinds). Cliquez sur Gérer les propriétés personnalisées dans la section Gestion des nœuds et des groupes.
   
   
   
2. Cliquez Ajouter une propriété personnalisée .  
3. Sélectionner Nœuds et cliquez Suivant .  
4. Réglez le Nom de la propriété à « PDIntegrationKey » et, éventuellement, définir un Description , comme « Intégration PagerDuty », puis cliquez sur Suivant .  
5. Cliquez Sélectionner les nœuds et cochez tous les nœuds dans la colonne Nœuds disponibles pour lesquels vous souhaitez recevoir des alertes dans PagerDuty, cliquez sur Ajouter pour déplacer les nœuds vers la colonne Nœuds sélectionnés, puis cliquez sur Sélectionner les nœuds .  
6. Collez la clé d'intégration PagerDuty que vous avez copiée précédemment dans le champ sous Attribuer une valeur pour « PDIntegrationKey » aux nœuds sélectionnés , puis cliquez sur Soumettre .  
7. Téléchargez les exemples d'alertes et enregistrez-les où vous le souhaitez sur votre poste de travail ou sur votre serveur SolarWinds.
   • Exemples d'alertes
8. Extrait Exemples d'alertes.zip sur votre poste de travail ou serveur SolarWinds (c'est-à-dire sur votre bureau, Téléchargements dossier, ou C:\ PagerDuty\Sample Alerts ).
9. Revenez à la page Paramètres principaux et administration de SolarWinds Orion en accédant à l' Paramètres menu et sélection Tous les paramètres (ou cliquez Paramètres (dans le coin supérieur droit de la page si vous possédez une ancienne version de SolarWinds). Cliquez sur Gérer les alertes dans la section Alertes et rapports.
   
   
   
10. Ensuite, cliquez sur Exportation/Importation pour importer certaines des alertes les plus populaires pour lesquelles nous avons créé des modèles. Cliquez sur Alerte d'importation et sélectionnez les définitions d'alerte que vous souhaitez importer dans SolarWinds à partir des fichiers extraits Exemples d'alertes emplacement. Félicitations ! SolarWinds pourra désormais déclencher et résoudre des incidents dans PagerDuty.

Tester une alerte

Ouvrez une alerte à partir du panneau SolarWinds et accédez à l' Action de déclenchement Tab. Simulez l'envoi d'une alerte via POST. En cas de succès, un incident PagerDuty sera déclenché. En cas d'échec, vérifiez le format JSON et les variables SolarWinds utilisés dans le corps de la requête HTTP.

Créez vos propres alertes

Vous pouvez envoyer des alertes supplémentaires à PagerDuty en sélectionnant l'alerte que vous souhaitez utiliser et en accédant à Actions de déclenchement , puis ajoutez simplement une action en utilisant le Enregistrer l'alerte dans un fichier option. Le fichier doit être enregistré dans C:\ PagerDuty\ File d'attente avec un .SMS extension de fichier, et le contenu doit être JSON formaté pour notre API d'événements Consultez les définitions d’alerte que nous fournissons pour obtenir des exemples sur la façon d’écrire vos propres alertes à envoyer à PagerDuty.

Caractères spéciaux : Vous devez éviter d'inclure des guillemets dans le modèle d'alerte. Cela entraînerait la terminaison de la chaîne dans la sortie, ce qui entraînerait une syntaxe JSON invalide et empêcherait la soumission des événements à l'API Événements. Si vous devez inclure des guillemets dans le modèle, il est fortement recommandé d'utiliser des guillemets courbes. ' et « , plutôt que des guillemets droits ( ' ).

FAQ

Puis-je déclencher des incidents sur plusieurs services PagerDuty ?

Oui ! Accédez simplement à la page de détails du nœud pour lequel vous souhaitez déclencher des incidents sur un autre service PagerDuty , faites défiler jusqu'à la section « Propriétés personnalisées », puis cliquez sur Modifier les valeurs des propriétés personnalisées pour définir une valeur différente pour Clé d'intégration PD sur ce nœud. Inutile de modifier vos alertes (sauf si vous avez codé en dur la clé d'intégration de vos alertes personnalisées), car les modèles que nous fournissons utilisent une requête SQL pour extraire la clé d'intégration de cette propriété personnalisée sur chaque nœud.

Pourquoi mon alerte ne se déclenche-t-elle pas ?

Essayez d'abord de modifier les alertes Conditions de déclenchement à une réalité actuelle pour être sûr que le problème ne vient pas d'un manquement aux conditions de déclenchement. Si, après avoir essayé, vous constatez « Cette alerte serait immédiatement déclenchée sur 0 objet(s) dans la portée de l'alerte » en finale Résumé un pas au-dessus du Soumettre Si vous cliquez sur le bouton « Déclencher », même si vous savez que les conditions saisies dans les conditions de déclenchement sont actuellement remplies, un bug particulier est probablement en cause. Il arrive que les alertes SolarWinds soient corrompues et nécessitent d'être remplacées. Pour résoudre ce problème, créez une nouvelle alerte de toutes pièces, avec toutes les conditions de déclenchement, actions, etc. identiques à l'alerte d'origine ; à la fin Résumé Vous devriez alors voir un message indiquant que la nouvelle alerte se déclenchera pour au moins un objet. Après avoir enregistré la nouvelle alerte, vous pouvez supprimer l'alerte d'origine, corrompue.

Pourquoi est-ce que je continue à recevoir une erreur HTTP lors du test/simulation de l'action ?

Si vous obtenez un message « Échec de l'exécution de la requête HTTP » lorsque vous essayez de simuler un déclencheur ou de résoudre une action sur une alerte, il s'agit généralement de parce que le JSON n'est pas valide ou car les variables SolarWinds ne sont pas renseignées correctement.

• Essayez de coller l'intégralité du contenu de l'action Corps de requête Http champ dans un outil de validation JSON pour détecter les erreurs de formatage.
• Essayez de tester en remplaçant les variables SolarWinds (par exemple, ${N=SwisEntity;M=FullName}) par des données fictives, puis testez à nouveau avec le bouton Simuler. Une fois que vous avez réussi, créez une alerte/un incident test sur PagerDuty en cliquant sur simuler sur l'action, vous pouvez rajouter des variables de manière incrémentielle ; vous pouvez le faire plus facilement en cliquant sur le Insérer des variables lors de la modification de l'action. Les variables sans valeur d'aperçu ne seront pas correctement renseignées pour le type de ressource que l'alerte en question est censée surveiller (par exemple, nœud, interface, etc.).