Lorsque vous enquêtez sur des problèmes complexes ou partagez des informations détaillées avec votre équipe, vous vous retrouvez souvent à jongler entre différents outils, à copier des requêtes, à prendre des captures d'écran et à lutter pour maintenir le contexte tout en reconstituant un récit complet à partir de vos données. Les dashboards traditionnels sont parfaits pour monitoring, mais ils sont insuffisants lorsqu'il s'agit de documenter les enquêtes, de créer des analyses post-mortem détaillées ou de construire un flux de travail analytique étape par étape.
Les notebooks résolvent ce problème en offrant une manière dynamique et organisée de raconter une histoire complète à partir de vos données. Ce sont des documents structurés et data-driven qui vous permettent de combiner requêtes, visualisations et textes descriptifs en un seul élément partageable, éliminant ainsi la nécessité de passer d'un outil à l'autre ou de perdre des informations importantes lors de votre analyse.
Cas d'utilisation
Utilisez des carnets pour améliorer votre workflow et transformer les données brutes en récits exploitables :
- Requête, analyse et visualisation de données: interrogez toutes vos données d'observabilité (logs, métriques, événement) et créez des visualisations pour mieux comprendre les performances de votre système.
- Créez des post-mortems et des documents d'événements d'alerte: Collaborez avec votre équipe pour documenter les investigations et créer un registre clair et réutilisable pour les post-mortems d'événements d'alerte et l'analyse des causes profondes.
- Créez des flux de travail et des manuels d'exploitation réutilisables: créez et partagez des guides étape par étape pour des analyses complexes.
- Ajoutez du contexte et un récit: utilisez Markdown pour ajouter facilement des titres détaillés, des notes et des explications à votre requête et à vos graphiques, transformant ainsi des points de données disparates en une histoire cohérente.
Commencez avec les cahiers
Maintenant que vous comprenez les bases des carnets de notes, vous êtes prêt à commencer à créer et à gérer vos propres carnets.
Accédez aux carnets.
Pour accéder aux carnets :
- Rendez-vous sur one.newrelic.com.
- Ouvrez la console Query your data depuis le menu latéral situé en bas de la page.
- Cliquez sur Notebooks dans l’en-tête du générateur de requêtes pour afficher la liste de tous les notebooks créés par votre organisation.
Accédez aux notebooks en allant dans Query your data > Notebooks
Blocs de cahier
Les blocs sont les unités de base d'un cahier. Ce sont des sections individuelles que vous ajoutez pour structurer votre analyse et votre récit.
blocs de requête
Utilisez des blocs de requête pour écrire des requêtesNRQL et visualiser les résultats. Tous les types de graphiques à requête unique et les personnalisations disponibles dans le générateur de requêtes standard sont pris en charge dans les notebooks.
Blocs de texte
Utilisez Markdown pour ajouter du texte enrichi, des titres, du contexte, des explications et du texte descriptif afin de raconter l'histoire de votre enquête.
Actions de blocage
Chaque bloc peut être manipulé pour organiser votre document :
- Duplicate: créer une copie du bloc
- Delete: supprimez le bloc de votre notebook
- Move Up/Down: réorganiser les blocs dans votre bloc-notes
- Move to Top/Bottom: déplacer rapidement les blocs vers le début ou la fin
Autorisations des carnets
Avant de commencer à créer des carnets, il est important de comprendre comment fonctionnent les autorisations et qui aura accès à vos carnets.
association d'organisations
Chaque carnet est une ressource qui appartient à l'organisation au sein de laquelle il a été créé. Cette association est permanente et ne peut être modifiée. Les blocs-notes ne peuvent pas être partagés entre différentes organisations. Si l'organisation est supprimée, le bloc-notes est également supprimé. Si un utilisateur change d'organisation, il n'aura plus accès aux blocs-notes de son ancienne organisation.
Modèle d'autorisations actuel
New Relic Notebooks utilise des rôles personnalisés avec des capacités CRUD pour contrôler l’accès. Il existe deux niveaux d’accès : au niveau de l’organisation (défini par un administrateur) et au niveau du notebook (défini pour chaque notebook par son créateur).
Autorisations au niveau de l'organisation
Ceux-ci sont accordés via des rôles personnalisés dans l’interface d’administration de New Relic.
Rôle | Capacités | Ce que cela permet |
|---|---|---|
Accès intégral |
| Créer, lire, modifier et supprimer n'importe quel notebook dans l'organisation |
Créateur |
| Créer de nouveaux carnets (ses propres carnets uniquement) |
Rôles au niveau du carnet
Ils sont attribués sur un carnet spécifique, généralement par le créateur du carnet.
Rôle | Autorisation | Ce que cela permet |
|---|---|---|
Propriétaire |
| Lire, modifier, supprimer et gérer les autorisations — automatiquement attribuées au créateur |
Éditeur |
| Modifier le notebook |
Lecteur |
| Afficher le notebook (en lecture seule) |
Comment cela fonctionne ensemble
- Un administrateur attribue à un utilisateur le rôle Creator au niveau de l’organisation — cela lui permet de créer des carnets.
- Lorsqu’un utilisateur crée un carnet, il en devient automatiquement le Owner.
- Le propriétaire peut ensuite partager le notebook avec d'autres personnes en leur accordant les rôles Editor ou Reader sur ce notebook spécifique.
- Les utilisateurs qui ont besoin d’accéder à tous les notebooks à l’échelle de l’organisation (par exemple, les administrateurs) obtiennent plutôt le rôle Full access.
Quelle est la prochaine étape ?
Maintenant que vous comprenez les bases des cahiers, vous pouvez :
- Apprenez-en davantage sur les blocs dans un cahier
- Utilisez des variables dans les notebooks pour créer des runbooks dynamiques et paramétrés
- Gérez les notebooks par programmation avec l'API Blob Storage pour les notebooks
Vous pouvez également explorer les fonctionnalités associées :
- Dashboards pour la création de visualisations de données persistantes
- générateur de requêtes pour créer une requête individuelle
- Graphiques pour comprendre les options de visualisation