Utilisation des actions New Relic dans les workflows d’actions

Suite, toutes les versions

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Résumé ◀▼

Vous pouvez connecter des workflows d’action New Relic à l’aide d’une clé API pour automatiser les workflows en exploitant des requêtes de données, des recherches d’entités et la création de conditions d’alerte. Utilisez un compte de service dédié pour une intégration sécurisée. Cette connexion vous permet d’exécuter des requêtes NRQL, de récupérer les détails des entités, d’effectuer des recherches d'entités par critère et de créer des conditions d’alerte pour surveiller et gérer vos systèmes directement au sein de vos workflows.

En connectant le créateur d’action à des systèmes externes (comme New Relic), les administrateurs peuvent intégrer Zendesk à des systèmes externes dans des workflows automatisés, ce qui améliore la collaboration et permet d’assurer une expérience fluide et cohérente sur plusieurs plateformes.

Remarque – Les étapes associées aux systèmes externes dans des workflows d’actions sont appelées collectivement des actions externes.

Cet article aborde les sujets suivants :

Connexion de New Relic au créateur d’action
Utilisation des actions New Relic dans les workflows d’actions

Connexion de New Relic au créateur d’action

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Lorsque vous vous connectez à des systèmes externes pour les utiliser dans des workflows d’actions, nous vous conseillons de suivre ces meilleures pratiques :

Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
Toutes les intégrations nécessitent des portées (autorisations) obligatoires. Cependant, il est important d’examiner et de valider ces portées avant de valider l’accès au système externe.
Si vous gérez les identifiants pour des outils basés sur des clés API, comme OpenAI, nous vous conseillons de stocker les clés dans un gestionnaire d’identifiants ou un coffre-fort sécurisé.

Pour créer une clé API utilisateur dans New Relic

La connexion New Relic utilise une authentification par clé API. Vous devrez indiquer une clé API utilisateur depuis votre compte New Relic. Cette clé sert à interroger les données et à gérer les configurations. Cette clé API doit avoir les permissions appropriées pour accéder aux API New Relic pour les actions que vous comptez utiliser.

Consultez la documentation New Relic pour en savoir plus sur les clés API New Relic.

Important : sécurisez votre clé API. Ne la communiquez à personne et ne la soumettez pas au contrôle de versions. Utilisez une clé API de service dédiée pour les workflows de production.

Accédez au menu utilisateur de New Relic.
Sélectionnez Clés API.
Créez une clé d’application.
Enregistrez la clé API ou laissez la fenêtre ouverte pour pouvoir la copier et la coller dans Zendesk.
Vous en aurez besoin pour connecter New Relic au créateur d’action.

Pour connecter le créateur d’action à New Relic

Dans le Centre d’administration, cliquez sur Applications et intégrations () dans la barre latérale, puis sélectionnez Actions > Workflows d’actions.
Créez ou modifiez un workflow d’actions.
Ouvrez la barre latérale.
Sous Actions externes, cliquez sur New Relic.
Cliquez sur Connexion.
Suivez les invites de New Relic pour saisir votre clé API New Relic et finaliser la connexion.
Important : toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.

Une fois que vous vous êtes connecté au système, vous verrez un indicateur de connexion et des détails sur l’instance à laquelle vous êtes connecté, ainsi que les actions disponibles pour New Relic.

Utilisation des actions New Relic dans les workflows d’actions

Les actions New Relic suivantes sont disponibles :

Interrogation de données
Recherche d’entité
Recherche d’entités
Créer une condition d’alerte

Requête de données

Utilisez l’action Interroger des données pour exécuter des requêtes NRQL sur vos données de télémétrie New Relic.

Cette action a les entrées et les sorties suivantes :

Variables

Entrées

	Variables
Entrées	Obligatoires : `ID compte`, `Requête NRQL` Le champ ID compte inclut une liste déroulante de comptes accessibles avec votre clé API. Requête NRQL utilise une syntaxe de type SQL. Exemple : `SELECT count(*) FROM Transaction WHERE appName='WebApp' SINCE 1 hour ago`. Facultative : `Délai` Le champ Délai accepte les valeurs entre 1 et 120 seconds (10 secondes par défaut).
Sortie	Les résultats de la requête incluent des objets avec des champs déterminés par la clause NRQL SELECT, le nombre de lignes et la valeur du résultat total pour les requêtes d’agrégation.

Obligatoires : ID compte, Requête NRQL

Le champ ID compte inclut une liste déroulante de comptes accessibles avec votre clé API.

Requête NRQL utilise une syntaxe de type SQL. Exemple : SELECT count(*) FROM Transaction WHERE appName='WebApp' SINCE 1 hour ago.

Facultative : Délai

Le champ Délai accepte les valeurs entre 1 et 120 seconds (10 secondes par défaut).

Sortie Les résultats de la requête incluent des objets avec des champs déterminés par la clause NRQL SELECT, le nombre de lignes et la valeur du résultat total pour les requêtes d’agrégation.

Recherche d’une entité

Utilisez l’action Rechercher une entité pour récupérer des informations détaillées au sujet d’une entité surveillée spécifique.

Cette action a les entrées et les sorties suivantes :

Variables

Entrées

	Variables
Entrées	Obligatoires : `ID compte`, `Entité` Le champ Entité est une liste déroulante interrogeable. Tapez au moins 2 caractères du nom de l’entité à rechercher. Les résultats de recherche montrent le nom et le type de l’entité, avec un lien vers l’entité dans New Relic. Sélectionnez l’entité que vous voulez rechercher pour récupérer toutes ses informations, notamment le statut d’alerte actuel et tous marqueurs associés.
Sortie	Les informations d’entités incluent : GUID, nom, type, URL, statut de rapport, gravité d’alerte, et marqueurs avec métadonnées.

Obligatoires : ID compte, Entité

Le champ Entité est une liste déroulante interrogeable. Tapez au moins 2 caractères du nom de l’entité à rechercher. Les résultats de recherche montrent le nom et le type de l’entité, avec un lien vers l’entité dans New Relic. Sélectionnez l’entité que vous voulez rechercher pour récupérer toutes ses informations, notamment le statut d’alerte actuel et tous marqueurs associés.

Sortie Les informations d’entités incluent : GUID, nom, type, URL, statut de rapport, gravité d’alerte, et marqueurs avec métadonnées.

Recherche d’entités

Utilisez l’action Recherche d’entités pour trouver des entités répondant aux critères de recherche.

Cette action a les entrées et les sorties suivantes :

Variables

Entrées

	Variables
Entrées	Obligatoire : `ID du compte` Facultatives : `Requête de recherche`, `Type d'entité`, `Gravité d'alerte`, `Filtre de marqueur`, `Résultats (max.)` Prenez en compte ce qui suit lorsque vous utilisez l’action Rechercher des entités : Tous les filtres de recherche sont facultatifs et peuvent être combinés. Le champ Requête de recherche utilise la syntaxe de requête New Relic (par exemple, `name LIKE 'Web%'`). Type d’entité inclut une liste déroulante des types d’entités disponibles. toutes les options de gravité d’alerte incluent NOT_ALERTING, WARNING et CRITICAL. Filtre de marqueur utilise le format clé:valeur (par exemple, environment:production). Résultats (max.) accepte les valeurs de 1 à 200 (50 par défaut).
Sortie	Tableau d’objets d’entités contenant GUID, nom, type, URL, domaine, statut de rapport, gravité d’alerte et ses marqueurs, ainsi que le nombre total d’entités et un indicateur signalant si d’autres résultats sont disponibles.

Obligatoire : ID du compte

Facultatives : Requête de recherche, Type d'entité, Gravité d'alerte, Filtre de marqueur, Résultats (max.)

Prenez en compte ce qui suit lorsque vous utilisez l’action Rechercher des entités :

Tous les filtres de recherche sont facultatifs et peuvent être combinés.
Le champ Requête de recherche utilise la syntaxe de requête New Relic (par exemple, name LIKE 'Web%').
Type d’entité inclut une liste déroulante des types d’entités disponibles. toutes les options de gravité d’alerte incluent NOT_ALERTING, WARNING et CRITICAL.
Filtre de marqueur utilise le format clé:valeur (par exemple, environment:production).
Résultats (max.) accepte les valeurs de 1 à 200 (50 par défaut).

Sortie Tableau d’objets d’entités contenant GUID, nom, type, URL, domaine, statut de rapport, gravité d’alerte et ses marqueurs, ainsi que le nombre total d’entités et un indicateur signalant si d’autres résultats sont disponibles.

Création d’une condition d’alerte

Utilisez l’action Créer une condition d’alerte pour créer une condition d’alerte NRQL dans New Relic.

Cette action a les entrées et les sorties suivantes :

Variables

Entrées

	Variables
Entrées	Obligatoires : `ID compte`, `Politique d'alerte`, `Nom de condition`, `Requête NRQL`, `Seuil critique` Facultatives : `Seuil d'avertissement`, `Durée du seuil`, `Opérateur de seuil`, `Activé` Prenez en compte ce qui suit lorsque vous utilisez l’action Créer une condition d’alerte : Le champ Politique d’alerte est une liste déroulante permettant d’effectuer une recherche et affichant les politiques du compte sélectionné. La requête NRQL doit renvoyer une valeur numérique simple pour la comparaison de seuil (par exemple, `SELECT count(*) FROM ZendeskTicketCreated SINCE 1 hour ago`). Seuil critique est la valeur numérique qui déclenche une alerte critique. Le seuil d’avertissement est facultatif et déclenche une alerte de niveau avertissement. Durée de seuil indique la valeur de dépassement du seuil avant que l’alerte ne soit déclenchée, en secondes (plage : 60-3600, 300 par défaut). Les options de seuil sont ABOVE, BELOW et EQUALS (ABOVE par défaut). Activé détermine si la condition est active immédiatement (true par défaut).
Sortie	Détails de l’alerte, notamment l’identifiant de l’alerte, son nom, l’identifiant de la politique et son état d’activation.

Obligatoires : ID compte, Politique d'alerte, Nom de condition, Requête NRQL, Seuil critique

Facultatives : Seuil d'avertissement, Durée du seuil, Opérateur de seuil, Activé

Prenez en compte ce qui suit lorsque vous utilisez l’action Créer une condition d’alerte :

Le champ Politique d’alerte est une liste déroulante permettant d’effectuer une recherche et affichant les politiques du compte sélectionné.
La requête NRQL doit renvoyer une valeur numérique simple pour la comparaison de seuil (par exemple, SELECT count(*) FROM ZendeskTicketCreated SINCE 1 hour ago).
Seuil critique est la valeur numérique qui déclenche une alerte critique.
Le seuil d’avertissement est facultatif et déclenche une alerte de niveau avertissement.
Durée de seuil indique la valeur de dépassement du seuil avant que l’alerte ne soit déclenchée, en secondes (plage : 60-3600, 300 par défaut).
Les options de seuil sont ABOVE, BELOW et EQUALS (ABOVE par défaut).
Activé détermine si la condition est active immédiatement (true par défaut).

Sortie Détails de l’alerte, notamment l’identifiant de l’alerte, son nom, l’identifiant de la politique et son état d’activation.