Les carnets sont conçus pour la collaboration. Vous pouvez facilement partager vos documents data-driven avec les membres de votre équipe afin de diffuser des informations détaillées, de collaborer sur des enquêtes ou de créer des modèles d'analyse réutilisables.
Aperçu du partage de blocs-notes
Tous les carnets créés au sein de votre organisation New Relic sont automatiquement accessibles aux autres membres de l'organisation qui ont accès à la fonctionnalité de carnets. Cela permet une collaboration fluide au sein de votre équipe.
Important
Actuellement, les ordinateurs portables ne disposent pas de paramètres d'autorisation précis. Toute personne de votre organisation ayant accès à la fonctionnalité de blocs-notes peut consulter, modifier et supprimer n'importe quel bloc-notes. Nous travaillons à la mise en place d'autorisations plus détaillées lors d'une prochaine sortie.
Partager l'URL d'un bloc-notes
La manière la plus simple de partager un bloc-notes spécifique est de partager son URL :
- Ouvrez le carnet que vous souhaitez partager.
- Copiez l'URL depuis la barre d'adresse de votre navigateur.
- Partagez l'URL avec les membres de votre équipe par e-mail, messagerie instantanée ou via votre outil de communication préféré.
Les membres de l'équipe qui cliquent sur l'URL seront directement redirigés vers le bloc-notes (à condition qu'ils aient accès à votre organisation New Relic).
Trouver des carnets partagés
Pour découvrir les carnets créés par les membres de votre équipe :
- Rendez-vous sur one.newrelic.com.
- Ouvrez la console Query your data.
- Cliquez sur Notebooks pour afficher l’index des carnets.
- Parcourez tous les carnets de notes de votre organisation ou utilisez la fonction de recherche pour trouver des carnets de notes spécifiques.
Recherche de cahiers
Utilisez la barre de recherche de l'index des carnets pour trouver des carnets spécifiques par :
- Nom du cahier
- Mots-clés dans le titre du carnet
- Contenu du bloc-notes (si consultable)
Trier les cahiers
Trier la liste des carnets par :
- Nom: Ordre alphabétique
- Dernière modification: La plus récente en premier
- Date de création: Du plus récent au plus ancien
- Favoris: Vos carnets marqués d'une étoile apparaissent en haut.
Collaboration bonnes pratiques
Conventions d'appellation
Utilisez des noms clairs et descriptifs pour vos carnets afin d'aider les membres de l'équipe à comprendre leur objectif :
- Bon: « Analyse des performances de l'API - Octobre 2024 »
- Bon: "Modèle d'analyse hebdomadaire du taux d'erreur"
- Points positifs: « Analyse du taux de désabonnement des clients - Résultats du 3e trimestre »
- Évitez: « Mon carnet » ou « Test ».
stratégies organisationnelles
Créer des modèles
Créez des modèles de carnets réutilisables pour les tâches d'analyse courantes :
- Créez un notebook avec une requête et une structure standard.
- Utilisez des variables pour les éléments personnalisables
- Ajouter des instructions Markdown pour les membres de l'équipe
- Nommez-le clairement en tant que modèle (par ex. « Modèle : investigation d'événement d'alerte »)
Documentez votre analyse
Utilisez les blocs Markdown pour fournir du contexte :
- Expliquez le but de chaque requête
- Documentez votre méthodologie d'analyse
- Inclure des liens vers des ressources connexes
- Ajouter les conclusions et les prochaines étapes
Utilisez des visualisations descriptives
- Ajoutez des titres clairs à vos graphiques
- Utilisez des schémas de couleurs cohérents.
- Inclure les étiquettes et les unités des axes
- Ajouter des indicateurs de seuil ou de base de référence, le cas échéant
Flux de travail collaboratif
Réponse de l'événement d'alerte
Créez des notebooks collaboratifs d'investigation sur les événements d'alerte :
- Commencez par un modèle d'événement d'alerte standard
- Ajouter des membres à l'équipe au fur et à mesure de l'avancement de l'enquête
- Documentez les résultats en temps réel à l'aide de blocs Markdown
- Inclure les requêtes et visualisations pertinentes
- Résumer la cause profonde et les étapes de remédiation
Rapports hebdomadaires/mensuels
Créer des carnets d'analyse récurrents :
- Créer un modèle de bloc-notes avec des métriques standard
- Utilisez des variables pour les plages horaires et les filtres.
- Planifiez des bilans réguliers avec votre équipe
- Archiver les rapports complétés avec des noms spécifiques à la date
Partage des connaissances
Transformer les enquêtes ponctuelles en connaissances réutilisables :
- Créer des carnets d'analyse détaillés
- Incluez la méthodologie et le raisonnement en Markdown
- Ajoutez des commentaires expliquant les résultats inhabituels
- Partager avec l'équipe élargie pour référence ultérieure
Contrôle de version et historique
Conseil
Actuellement, les ordinateurs portables ne disposent pas d'un historique des versions intégré. Pensez à dupliquer vos carnets de notes importants avant d'apporter des modifications significatives afin de préserver les versions précédentes.
Pour maintenir le contrôle des versions :
- Dupliquez avant d'apporter des modifications importantes: Créez une copie de votre bloc-notes avant d'y apporter des modifications importantes.
- Utilisez des noms descriptifs: incluez les numéros de version ou les dates dans les noms des notebooks.
- Modifications du document: Utilisez des blocs Markdown pour indiquer les modifications apportées et leur date.
- Archiver les anciennes versions: Déplacer les versions obsolètes dans un dossier séparé ou selon une convention de nommage distincte
problèmes de partage de dépannage
Le bloc-notes n'est pas visible par les membres de l'équipe.
Si les membres de l'équipe ne peuvent pas voir votre bloc-notes :
- Vérifier l'accès à l'organisation: s'assurer qu'ils appartiennent à la même organisation New Relic.
- Vérifier l'accès aux fonctionnalités: Confirmer qu'ils ont accès à la fonctionnalité d'aperçu des blocs-notes
- Essayez l'URL directe: partagez l'URL précise du notebook plutôt que de compter sur eux pour la trouver dans l'index.
Performances avec des carnets partagés
Les notebooks volumineux ou complexes peuvent être lents à charger pour tous les utilisateurs :
- Optimiser la requête: utiliser des plages horaires et des filtres appropriés
- Limiter les résultats: utiliser les clauses
LIMITdans la requête NRQL - Envisagez de fractionner: Divisez les très grands carnets en documents plus petits et ciblés.
Quelle est la prochaine étape ?
- Découvrez les visualisations dans les notebooks
- Explorez des exemples de carnets pour trouver l'inspiration en matière de collaboration.
- Consultez la section sur l'ajout de requêtes aux notebooks pour découvrir des techniques avancées.