Workflows

Avec le workflow, vous contrôlez quand et où vous souhaitez recevoir des notifications sur les problèmes, transmettez les bonnes informations à la personne ou à l'équipe concernée et enrichissez la notification de votre problème avec des données New Relic supplémentaires.

Qu'est-ce qu'un problème ?

Les problèmes sont des groupes d’incidents qui décrivent le problème sous-jacent de vos symptômes. Lorsqu'un nouvel incident est créé, le service de renseignement incident ouvre un problème et évalue d'autres problèmes ouverts pour détecter des corrélations. Pour plus d'informations, voir Utiliser Incident Intelligence.

Comment les workflows sont-ils déclenchés ?

Un workflow est déclenché par un événement de problème pour les problèmes qui correspondent au filtre workflow et à leurs déclencheurs notification correspondants. Le workflow est configuré avec des déclencheurs recommandés par défaut, mais vous pouvez contrôler quand déclencher une notification pour chaque destination en cliquant sur les 3 points puis en choisissant Notify when. Le déclencheur de notification Activated doit également être activé.

L'événement suivant déclenche le workflow et envoie une notification aux points de terminaison de destination concernés :

Autorisations requises

L'utilisation du workflow nécessite des autorisations spécifiques.

• Pour accéder aux destinations : autorisations View pour Applied intelligence > Destinations ou Alerts.
• Pour accéder au workflow : autorisations View pour Applied intelligence > Workflows.
• Pour créer un workflow : autorisations Modify pour Applied intelligence > Workflows et Applied intelligence > Channels.
• Pour modifier les workflows : autorisations Modify pour Applied intelligence > Workflows et toutes les autorisations pour Applied intelligence > Channels et applied_intelligence.create.workflow.
• Pour supprimer le workflow : autorisations Delete pour Applied intelligence > Workflows et Applied intelligence > Channels.

Ajouter un workflow

La fonctionnalité de workflow se trouve sous le menu **Alerts ** .

1. Allez à one.newrelic.com > All capabilities > Alerts > Enrich and Notify > Workflow > Add a workflow.

2. Nommez votre workflow. Ce champ est obligatoire et doit être unique.

3. Avec le workflow, filtrez vos problèmes et envoyez-les à la destination appropriée. Vous pouvez créer une requête pour filtrer les bons problèmes.

   Conseil

   Pour configurer une notification séparée sur l'incident WARNING , filtrez par problèmes avec une priorité égale à HIGH.

4. Créez une requête en sélectionnant un attribut, un opérateur et une ou plusieurs valeurs pour affiner les problèmes appropriés que vous souhaitez transmettre.

   Conseil

   Le filtre de workflow se remplit automatiquement avec les données des problèmes passés ainsi que certaines valeurs statiques de la condition mémorisée (comme le nom de la condition). Si vous ne trouvez pas la valeur que vous recherchez, saisissez-la et sélectionnez Enter new. Un avertissement indiquant que le filtre ne correspond à aucun problème passé se produit parfois.

5. Recommandé : filtrer les problèmes par tag d'équipe afin que toutes les équipes puissent être averties lorsque leur entité est incluse dans un problème. Les étapes peuvent être trouvées dans la démo ci-dessous :

   Pour quelques conseils sur l'utilisation des balises, consultez cette publication du forum d'assistance sur les modèles workflow .

6. Optionnel : Enrichissez vos données.

   Comment enrichir les données

   Actuellement, vous ne pouvez envoyer que des sorties JSON ou numériques vers des destinations Webhook et Jira. De plus, vous pouvez envoyer du JSON à AWS EventBridge en utilisant les variables de workflow pointant vers le résultat d'enrichissement des données. De plus, vous ne pouvez envoyer des images qu'à d'autres destinations telles que Slack, PagerDuty, ServiceNow (application) et par e-mail. Pour obtenir de meilleurs résultats dans Webhook et Jira, utilisez une requête avec une sortie à valeur unique, telle que count, min ou max.

   Détails sur l'utilisation des enrichissements :

   • Les enrichissements peuvent donner un contexte supplémentaire à la notification d'alerte en y ajoutant des résultats de requête NRQL

   • L'outil d'enrichissement du workflow est similaire au générateur de requêtes.

   • Les résultats de la requête NRQL sont inclus dans le message de notification.

   • Si vous créez une requête pour votre workflow, elles s'exécutent en temps réel et les résultats de la requête sont la valeur de l'enrichisseur.

   • Vous pouvez enregistrer n'importe quelle requête valide dans votre workflow, même si elle renvoie un résultat vide, mais vous devez exécuter la requête avant d'enregistrer l'enrichissement. Vous pouvez également effectuer une requête avec des variables spécifiques à un problème ; par exemple {{entitiesData.ids}}

   • Pour des exemples d’enrichissement, voir Exemples d’enrichissement des données de workflow.

   • Remarque : le nom de la requête doit être unique, car vous l'utiliserez pour décider comment inclure le résultat dans la charge utile de la notification qui sera envoyée par le workflow.

     Important

     À ce stade, la représentation visuelle des enrichissements est envoyée à Slack et par e-mail. Pour les destinations ServiceNow et JIRA, nous recommandons de se limiter aux requêtes NRDB avec des résultats à valeur unique. Par exemple : count, min ou max.

     Le nombre maximal d'enrichissements par workflow est de 2.

7. Notifier : Choisissez une ou plusieurs destinations et ajoutez un message facultatif.

   Conseil

   Dans n’importe quel canal de destination, commencez à taper et un menu variable s’ouvrira. Vous verrez les noms des variables, qui seront remplacés par les valeurs de la variable au moment de l'exécution. Pour utiliser les résultats des enrichisseurs, utilisez leur nom.

   Notificateur

   • Pour enregistrer et activer un workflow, vous devez inclure un notificateur.
   • La configuration d'un notificateur nécessite la configuration d'une destination de notification.
   • Vous pouvez le configurer soit via l'élément de menu Destination , soit via le Create new destination item dans la liste déroulante de sélection de destination dans chaque écran de canal de destination.
   • Une destination notification inclut les informations d'identification requises pour envoyer une notification à une plateforme tierce et une option permettant de personnaliser le message envoyé par les champs de modélisation de nos problèmes aux champs de la plateforme de destination.
   • Pour savoir comment configurer des destinations et configurer des modèles de messages, consultez la documentation sur la notification.
   • (Facultatif) Vous pouvez marquer la notification que vous souhaitez recevoir pour chaque notificateur. Sinon, une notification sera envoyée à chaque notifiant par défaut.

8. Cliquez sur update message une fois les exigences du notificateur remplies.

9. Facultatif : Testez votre workflow. Nous utiliserons les données existantes de votre compte pour envoyer un exemple de notification avec votre nouvelle configuration. Le test ne fonctionne que s'il existe des problèmes correspondant au filtre. S'il n'y a pas de données, vous verrez ce message : We don't see any issues matching your filter. That doesn't mean it won't work.

10. Cliquez sur Update workflow pour terminer le workflow.

logdes notifications de problèmes

Le de problèmes notification log fournit à l'utilisateur un enregistrement détaillé pour suivre toutes les notifications générées par les workflows. Ces informations permettent de résoudre les problèmes, de monitorer les performances workflow et de garantir que les notifications sont envoyées aux bonnes destinations. En conséquence, l’utilisateur peut rapidement identifier tout problème pouvant survenir et prendre les mesures correctives nécessaires.

Pour accéder au de notification log problèmes, accédez one.newrelic.com > Alerts > Workflows à, puis cliquez Issue notification log sur.

Navigation dans le de problèmes notification log

Le de problèmes notification log affiche les colonnes suivantes :

1. Time: Cette colonne affiche l'heure à laquelle la notification de workflow a été envoyée.

2. Status: Cette colonne affiche le statut de la notification.

   • Envoyé : la notification a été envoyée avec succès depuis New Relic.
   • Échec : la notification n'a pas été envoyée avec succès depuis New Relic.
   • Rebondi : le serveur de messagerie de réception ne peut pas ou ne veut pas livrer l'e-mail. Cela se produit généralement parce que l'adresse e-mail n'est pas valide ou que la boîte de réception est pleine. Les adresses e-mail renvoyées sont supprimées dans les futurs envois.
   • Abandonné : le client de messagerie n'a pas tenté d'envoyer l'e-mail car l'adresse e-mail a déjà rebondi, parce que l'adresse s'est désabonnée de nos e-mails ou parce que l'adresse a marqué nos e-mails comme spam.
   • Différé : l'e-mail n'a pas été transmis lors de la première tentative, en raison de problèmes temporaires tels que la connectivité. Il y aura une autre tentative, donc une notification différée peut réussir ou rebondir plus tard.

3. Destination: Cette colonne affiche le type de destination recevant la notification de workflow (par exemple, Slack ou e-mail).

4. Operation: Le type de notification qui a été envoyée (par exemple, Notifier, Fermer, Commentaire, Accusé de réception, Test).

5. Issue Name: Cette colonne affiche le nom du problème qui a déclenché la notification de workflow.

6. Trigger Event: Cette colonne affiche l’événement de problème qui a déclenché la notification de workflow. Cliquer sur l'événement fournira plus d'informations sur la manière dont les workflows sont déclenchés.

7. Workflow: Cette colonne affiche le workflow qui a déclenché la notification.

8. Error Details: Cette colonne affiche des détails supplémentaires si la notification a échoué.

9. Notification Result: Cette colonne affiche un lien vers une preuve dans le tiers (par exemple, un fil de discussion Slack ou un ticket JIRA) si la notification a été envoyée avec succès.

10. Payload: Ceci est disponible pour les notifications envoyées aux destinations webhook et affiche la charge JSON de la notification qui a été envoyée.

Notification NrAi

Vous pouvez demander toutes les informations de la notification de problème à l'aide de l'événement NrAiNotification.

Utilisez cette requête pour voir toutes les notifications envoyées à partir du workflow classées par types de destination :

FROM NrAiNotification
SELECT count(*)
FACET destinationType

Voir les détails supplémentaires

L'utilisateur peut afficher des détails supplémentaires en cliquant sur n'importe quelle ligne du log de notification des problèmes. Cela affichera les détails de l'erreur (le cas échéant) et un lien vers la notification dans le tiers.