Avec les variables de notebook, vous pouvez configurer des paramètres dynamiques qui se répercutent sur plusieurs requêtes à travers les blocs de requête. Contrairement aux variables de modèle de dashboard, qui filtrent une vue statique, les variables de notebook agissent comme des paramètres injectés qui pilotent la logique sous-jacente de l'ensemble de votre document.
Accédez à one.newrelic.com > All capabilities > Notebooks.
Pourquoi utiliser des variables dans les notebooks ?
Les variables de notebook vous permettent de créer des expériences interactives telles que :
- Runbooks paramétrés où un ingénieur saisit un
hostNameoutransactionIdspécifique pour générer instantanément un rapport de santé du système cible. - Modèles de post-mortem qui peuvent être mis à jour avec des horodatages, des régions ou des noms d’application spécifiques pour analyser un incident.
- Seuils interactifs où les utilisateurs peuvent ajuster des variables comme
errorThresholdoulatencyTargetpour voir comment différents paramètres affectent les données visualisées.
Les principaux avantages sont les suivants :
- Création de runbooks exécutables: les variables transforment vos notebooks de pages statiques en outils interactifs. Vous pouvez créer des workflows adaptables pour les investigations d’événements d’alerte, l’analyse des performances et la collaboration en équipe.
- Standardiser le partage des connaissances: en tant que document enregistré, vous pouvez partager des workflows analytiques avec des collègues. Les utilisateurs n'ont pas besoin de réécrire des requêtes NRQL complexes — ils changent simplement pour une nouvelle valeur de variable à partir de vos variables prédéfinies et exécutent le workflow.
Définir une variable de notebook
Définissez une variable que vous injecterez dans vos blocs de requête NRQL pour paramétrer votre récupération de données et vos visualisations.
Pour définir une variable :
- À partir d'un notebook ouvert, localisez la barre de variables en haut de l'interface.
- Cliquez sur + Add variable.
- Configurez votre type de variable (par exemple, saisie de texte, liste déroulante ou numérique) et fournissez une valeur par défaut.
Règles de nommage des variables
Lors de la dénomination de votre variable, gardez à l’esprit ce qui suit :
- Le nom est la chaîne exacte que vous utiliserez dans vos blocs de notebook, entourée de
{{...}}. Par exemple, si vous nommez la variabletargetApp, vous la référencez dans vos blocs de requête en tant que{{targetApp}}. - Les noms de variables sont sensibles à la casse et doivent être uniques au sein d'un notebook.
- Choisissez des noms descriptifs qui rendent votre runbook explicite pour les autres utilisateurs (par exemple,
failingHostplutôt quevar1).
Utiliser une variable dans un bloc de requête
Une fois définie, référencez votre variable n’importe où dans une requête NRQL en utilisant la syntaxe {{variableName}} :
SELECT average(cpuPercent) FROM SystemSample WHERE hostname = {{failingHost}} TIMESERIESSELECT latest(cpuPercent) FROM ProcessSample WHERE hostname = {{failingHost}} FACET processDisplayNameLorsque vous exécutez la requête, la valeur de la variable que vous avez définie dans la barre des variables est substituée dans la requête au moment de l’exécution. La modification de la valeur de la variable et la réexécution de la requête mettent instantanément à jour tous les blocs qui font référence à cette variable.
Automatiser la réponse aux incidents avec des runbooks
L'application la plus puissante pour les variables de notebook est la création de runbooks exécutables pour la réponse aux incidents. En combinant les variables de notebook avec les workflowsNew Relic , vous pouvez automatiser le transfert entre le déclenchement d'une alerte et le début de l'investigation.
Structurez votre runbook
Un runbook paramétré bien structuré suit généralement ce modèle :
Block | Type | But |
|---|---|---|
1 | Réduction | Instructions sur la façon d’utiliser le runbook et le contexte architectural du service |
2 | NRQL | Vérification de système de haut niveau à l’aide de la variable injectée — par exemple :
|
3 | Réduction | Conseils conditionnels — par exemple : « Si le graphique ci-dessus montre un CPU > 90 %, exécutez la requête suivante pour identifier les principaux processus. » |
4 | NRQL | Requête d’investigation plus approfondie — par exemple :
|
Quelle est la prochaine étape ?
- Commencer avec les notebooks pour un aperçu de la fonctionnalité de notebooks
- Blocs dans le notebook pour en savoir plus sur les blocs de requête et de texte
- API Blob Storage pour les notebooks pour gérer les notebooks par programmation
- Variables de modèle : filtrer dynamiquement le dashboard pour la fonctionnalité de dashboard équivalente