En tant qu'utilisateur de New Relic, vous pouvez exécuter la même requête NRQL à plusieurs reprises pour monitorer des modèles critiques, vérifier des conditions spécifiques ou générer des rapports réguliers. Par exemple, vous devez vérifier quotidiennement les transactions ayant échoué, monitorer le taux d'erreur hebdomadaire ou suivre les indicateurs de performance horaires de vos applications. Ce processus manuel est chronophage et il est facile de manquer des informations importantes détaillées lorsque vous ne monitoring pas activement.
Les recherches NRQL planifiées résolvent ce problème en automatisant vos requêtes répétitives. Vous pouvez programmer l'exécution automatique des requêtes et recevoir les résultats par e-mail, ce qui vous permettra de rester informé des tendances critiques sans monitoring manuelle constante.
Ce que vous pouvez faire
Les recherches NRQL planifiées vous permettent de :
- Automatisez les requêtes répétitives: convertissez les requêtes manuelles en flux de travail automatisés qui s’exécutent selon votre planification.
- Commencez de n’importe où: créez une recherche planifiée depuis l’Administration ou directement depuis l’interface utilisateur de Logs.
- Restez informé de manière proactive: recevez des notifications par e-mail avec les résultats de vos requêtes directement dans votre boîte de réception.
- Définir les conditions de notification: choisissez de recevoir une notification à chaque exécution, ou uniquement lorsque vos résultats remplissent une condition que vous définissez en fonction du nombre de résultats dans votre requête.
- Planifiez de manière flexible: utilisez des planifications d’expressions cron personnalisées pour définir le moment d’exécution des requêtes.
- Choisissez votre format de sortie: exportez les résultats sous forme de fichiers CSV ou JSON joints aux notifications par e-mail.
- Collaborez avec votre équipe: envoyez les résultats de recherche planifiés à plusieurs destinataires d'e-mails.
- Gérez tout de manière centralisée: affichez, modifiez, et gérez toutes vos recherches planifiées depuis un emplacement unique dans l’interface utilisateur d’administration, quel que soit l’endroit où vous les avez créées.
Tarifs
Les recherches NRQL planifiées n’ont pas de tarification distincte. Vous ne payez que le coût de requête standard pour l’exécution de la requête NRQL sous-jacente, en fonction du modèle de tarification de votre compte.
Prérequis
Pour utiliser les recherches NRQL planifiées, vous avez besoin de :
- Accès au compte: Accès au compte sur lequel vous souhaitez programmer des recherches.
- Accès aux données: Autorisations appropriées pour interroger les données que vous souhaitez planifier. Par exemple, si vous planifiez une requête sur des données log, vous devez avoir accès à ces logs.
Autorisations
Par défaut, les rôles standards All product admin et Standard user incluent déjà l'accès Read et Modify aux recherches planifiées, et seul All product admin inclut l'accès Delete. Ces rôles incluent également déjà deux capacités dont dépendent les recherches planifiées :
- User API Keys (for self) > Modify (
account.create.own_api_keys) : New Relic en a besoin pour exécuter la recherche avec succès. - Workflow Schedules > Read (
workflow_automation.read.schedules) : requis pour afficher la liste des recherches planifiées.
Si vous souhaitez créer un rôle personnalisé et lui attribuer des capacités Scheduled Search spécifiques, utilisez l’une des méthodes suivantes :
- NerdGraph: créez un rôle personnalisé à l’échelle du compte via NerdGraph, et ajoutez les ID de permission du tableau suivant à l’éventail
permissionIds. - UI: créez un nouveau rôle personnalisé, ou modifiez-en un existant, pour ajouter la capacité Scheduled Search à partir de la section Scheduled Search and Reports.
Important
Certaines capacités accordent un accès plus large que d'autres. Par exemple, Delete accorde également l'accès en lecture et en modification. Si vous souhaitez uniquement accorder une capacité plus restreinte, sélectionnez cette capacité spécifique au lieu de Delete.
Le tableau suivant répertorie chaque capacité, ses ID d'autorisation, et ce qu'elle accorde :
Capacité | ID de permission | Description |
|---|---|---|
Scheduled Search > Read |
| Afficher les recherches planifiées |
Scheduled Search > Modify |
| Affichez, créez, et modifiez les recherches planifiées |
Scheduled Search > Delete |
| Afficher, créer, modifier et supprimer des recherches planifiées |
User API Keys (for self) > Modify |
| Requis pour exécuter une recherche planifiée. New Relic l’utilise pour créer une clé API utilisateur en votre nom, pour maintenir votre contexte utilisateur. Sans cela, l’exécution échoue. |
Workflow Schedules > Read |
| Requis pour afficher la liste des recherches planifiées. |
Planifier une nouvelle recherche
New Relic vous guide à travers ce flux directement dans le produit. Chaque étape ci-dessous décrit ce qui doit y être fait et tout ce qui n’est pas évident à l’écran.
Accédez au flux de création de recherche planifiée:
Choisissez le point d’entrée qui correspond à votre workflow. Les deux mènent au même flux de configuration.
Allez à one.newrelic.com > Administration > Scheduled Searches et cliquez sur Schedule a search.
Depuis l'UI de Logs, utilisez l'une de ces options :
Dans le coin supérieur droit, cliquez sur le menu et sélectionnez Schedule a search.
Sous le graphique de tendance de la requête, cliquez sur l'icône d'horloge.
Si vous avez déjà composé et exécuté une requête, elle est reprise dans le flux de configuration. Sinon, vous pouvez rédiger votre requête à l'étape suivante.
Conseil
Vous pouvez créer une recherche planifiée depuis l'Administration, ou l'interface utilisateur de Logs, mais vous ne pouvez afficher, modifier, ou supprimer les recherches planifiées existantes qu'à partir de Administration > Scheduled Searches.
Configurez votre requête:
Rédigez et testez votre requête NRQL, puis continuez.
Configurer notification:
Configurez les éléments suivants :
Nommez la recherche, puis définissez une destination pour les résultats. Vous ne pouvez envoyer les résultats qu'à des destinations e-mail.
- Si la destination existe, sélectionnez-la dans la liste.
- Si elle n’existe pas, ajoutez un ou plusieurs destinataires d’e-mails et nommez la destination.
Choisissez un objet, un message, et un format de sortie pour l’e-mail.
Définissez la condition de notification sous Send notification. La valeur par défaut est Always. Pour envoyer uniquement lorsque vos résultats atteignent un nombre que vous définissez, personnalisez-le ici.
Prudence
Les résultats de recherche planifiés sont joints à l’e-mail sous forme de fichiers CSV ou JSON et peuvent contenir des données sensibles. Passez en revue vos destinations d’e-mail pour confirmer que seuls les destinataires prévus sont inclus.
Établissez un calendrier:
Choisissez ce qui suit :
Choisissez une fréquence : horaire, quotidienne, hebdomadaire, ou une expression cron personnalisée.
Sélectionnez un fuseau horaire pour la planification.
Si vous utilisez une expression cron, voici quelques modèles courants à titre de référence :
0 * * * *- Chaque heure pile0 9 * * *- Tous les jours à 9h000 9 * * 1- Tous les lundis à 9h000 0 1 * *- Le premier jour de chaque mois à minuit*/15 * * * *- Toutes les 15 minutes0 9 * * 1-5- Tous les jours de la semaine à 9h00Conseil
L'intervalle le plus court pris en charge est toutes les 10 minutes.
Si vous définissez une condition de notification au lieu d’envoyer à chaque exécution, New Relic vérifie la condition au temps d’exécution planifié exact. Il ne suit pas les fluctuations entre les exécutions, donc si vos résultats tombent en dessous du seuil de la condition avant la prochaine exécution, vous ne recevrez pas de notification pour cette exécution.
Vérifiez, confirmez, et planifiez la recherche:
Vérifiez votre configuration, puis planifiez la recherche. Elle apparaît sur la page Scheduled searches.
Gérer les recherches planifiées
La page Scheduled searches de l’interface utilisateur d’administration répertorie toutes vos recherches automatisées, y compris celles que vous avez créées depuis l’interface utilisateur de Logs. Depuis le menu , vous pouvez afficher, modifier, ou supprimer une recherche en fonction de vos permissions.
Sujets connexes
Pour des informations connexes, voir :
- Apprenez-en davantage sur les requêtes NRQL pour créer des recherches automatisées plus sophistiquées.
- Configurez les destinations des e-mails d'alerte pour étendre vos options de notification.
- Découvrez l'automatisation des workflows pour des possibilités d'automatisation plus avancées.