Aperçu

Les carnets sont des documents collaboratifs en texte enrichi qui vous donnent tout le pouvoir des graphiques Datadog. Plusieurs utilisateurs peuvent travailler ensemble pour réaliser une enquête ou un post-mortem avec des données en direct de votre incident. Les carnets sont également excellents pour les runbooks et la documentation, fournissant des informations réelles sur vos systèmes en plus de votre contenu.

Créer un carnet

Vous pouvez créer un carnet à deux endroits :

• Dans la barre de navigation à gauche, cliquez sur Tableaux de bord > Nouveau carnet.
• Dans le coin supérieur droit de la page de la liste des carnets, cliquez sur Nouveau carnet.

Modèles de carnet

Dans la galerie de modèles, consultez des modèles prêts à l’emploi à partir desquels vous pouvez créer de nouveaux carnets. Les modèles incluent un post-mortem de réponse à un incident, un rapport d’incident et une spécification SLO. Vous pouvez également créer un nouveau modèle personnalisé pour construire des structures de carnet réutilisables.

Modification d’un carnet

Les carnets offrent une expérience d’édition de texte enrichi pour créer et collaborer sur du contenu. Vous pouvez taper et formater librement du texte en utilisant des options de barre d’outils familières et des raccourcis clavier, tels que gras, italique, titres, listes, et plus encore, directement dans l’éditeur.

Pour les utilisateurs qui préfèrent les raccourcis, les carnets prennent également en charge la syntaxe Markdown. Par exemple, taper # suivi d’un espace crée un titre, et utiliser des triples accents graves (```) commence un bloc de code.

Le contenu textuel est automatiquement enregistré au fur et à mesure que vous tapez. Pour les graphiques intégrés, assurez-vous d’enregistrer vos modifications dans l’éditeur de graphiques pour les appliquer dans le carnet.

Types de contenu

Les carnets prennent en charge divers types de contenu enrichi et intégré, y compris, mais sans s’y limiter :

• Graphiques
• Images
• Titres (H1 - H3)
• Listes (listes à puces, listes numérotées et listes de contrôle)
• Blocs de code
• Citations en bloc
• Cellules Markdown

Pour la liste complète, tapez / dans un carnet.

Graphiques dans les carnets

Les carnets prennent en charge tous les types de widgets. Pour la liste complète, voir Widgets.

Survolez le widget pour afficher les options d’édition et de configuration des graphiques.

Pour modifier la requête ou configurer l’affichage du graphique, utilisez la fonction Édition rapide pour effectuer la plupart des modifications en ligne. Pour une configuration plus avancée, cliquez sur l’icône de crayon ou maintenez la touche Cmd/Ctrl enfoncée et cliquez sur le graphique pour ouvrir l’éditeur de graphique complet. Vous pouvez ajuster la période locale ou lier le graphique à l’heure du carnet global en cliquant sur l’icône de l’horloge.

Des options de configuration supplémentaires pour le graphique sont accessibles dans le menu à trois points, selon le type de graphique :

• Taille du graphique : Ajustez la hauteur du graphique en sélectionnant XS, S, M (par défaut), L ou XL.
• Légende du graphique : Décochez la case pour masquer la légende. Les légendes sont automatiquement désactivées pour les graphiques XS et S.

Fonctionnalités de texte enrichi

Les carnets prennent en charge les fonctionnalités de texte enrichi couramment utilisées telles que le gras, l’italique, le code en ligne et les en-têtes. Les carnets prennent également en charge une variété de types de listes tels que les listes à puces, numérotées ou de contrôle.

Chips intelligents

Commandes slash

Les commandes slash sont une interface pour créer des graphiques ou insérer d’autres contenus. Sur une nouvelle ligne, tapez / pour ouvrir le menu des commandes slash. Continuez à taper le nom du type de contenu souhaité et sélectionnez l’option appropriée.

Lorsque vous sélectionnez un type de graphique, cela ouvre l’éditeur de graphique. Après avoir cliqué sur Enregistrer, le graphique apparaît dans votre carnet.

Raccourcis clavier

En bas à gauche d’un carnet, cliquez sur l’icône de clavier pour voir une liste des raccourcis clavier pour l’édition.

De plus, vous pouvez utiliser les raccourcis suivants pour couper et coller des widgets (Cmd/Ctrl + X, Cmd/Ctrl + V).

Table des matières

Les carnets génèrent automatiquement une table des matières à partir de tous les en-têtes ou graphiques que vous insérez dans votre document. Vous pouvez créer un en-tête en utilisant le raccourci markdown # ou en sélectionnant du texte et en cliquant sur En-tête dans la barre d’outils.

Étiquettes de carnet

Ajouter des images aux carnets

Vous pouvez ajouter des images à votre carnet en utilisant /image ou le menu Ajouter une cellule. Cela offre des options pour redimensionner, aligner et légender l’image. Les images téléchargées sont hébergées par Datadog.

Vous pouvez utiliser l’une des options suivantes pour télécharger une image à héberger par Datadog :

• Déposez un fichier image dans la zone de téléchargement
• Cliquez sur Choisir un fichier et localisez l’image dans votre répertoire de fichiers
• Collez une URL accessible au public pour l’image

Cliquez sur les icônes de la barre d’actions de l’image pour ajuster la taille, l’alignement, ajouter une légende pour l’image, ou voir l’image en mode plein écran.

Ajouter des commentaires à un carnet

Vous pouvez ajouter des commentaires sur le contenu dans le corps du carnet. Pour commenter un texte, surlignez le texte et cliquez sur l’icône de commentaire dans la barre d’outils.

Pour commenter un graphique ou une image, cliquez sur l’icône de commentaire à droite du graphique.

Expérience multijoueur dans les carnets

Les carnets prennent en charge la collaboration complète, permettant à plusieurs utilisateurs de modifier simultanément. Lorsqu’un collaborateur ouvre votre carnet, son curseur apparaît en temps réel. Survolez un curseur pour voir le nom du collaborateur.

Widgets

Lorsqu’un autre utilisateur édite un widget, un contour apparaît autour du widget. Étant donné que les widgets sont enregistrés selon le principe du dernier écrit, évitez d’éditer un widget sur lequel quelqu’un d’autre travaille.

Présence

En haut du carnet, vous pouvez voir les images d’avatar de tous les utilisateurs actuellement en train de consulter le carnet. Survolez un avatar pour voir le nom du collaborateur associé.

Configuration d’un carnet

Variables de modèle

Les carnets prennent en charge les variables de modèle. Définissez dynamiquement la portée des visualisations en ajoutant et en sélectionnant des valeurs de variables de modèle. Pour plus d’informations, voir Variables de Modèle.

Contrôles temporels

Par défaut, tous les graphiques sont liés à la plage de temps globale définie dans l’en-tête du carnet.

Pour voir une plage de temps différente, sélectionnez une option dans le sélecteur de temps global, ou faites glisser directement sur un graphique. L’URL du carnet se met à jour pour refléter cette nouvelle plage de temps sans l’enregistrer dans le carnet.

Remarque : Cliquer et faire glisser pour zoomer sur un graphique ne déverrouille pas le graphique de la plage de temps globale. Cela change la plage de temps globale du carnet à la place.

Pour enregistrer ce temps comme le temps par défaut du carnet, cliquez sur Définir le temps par défaut. Pour réinitialiser votre plage de temps globale à la plage de temps globale par défaut précédemment enregistrée, cliquez sur le bouton de réinitialisation.

Les graphiques individuels peuvent être dissociés de la plage de temps globale et définis sur une plage de temps indépendante.

Pour afficher une plage de temps différente sur un seul graphique, modifiez le graphique et utilisez le commutateur pour le dissocier de la plage de temps globale. Changez la plage de temps en utilisant le sélecteur de temps ou en glissant sur le graphique. Les modifications apportées en mode édition sont enregistrées automatiquement lorsque vous cliquez sur Terminé. Pour annuler vos modifications, cliquez sur Annuler au lieu de Terminé.

Modes

Vous pouvez passer d’un mode à l’autre depuis le carnet en sélectionnant le menu déroulant en haut à droite de votre carnet.

• Édition : Apportez des modifications au carnet.
• Visualisation : Le contenu est en lecture seule, empêchant les utilisateurs d’apporter des modifications non désirées aux configurations et informations existantes.

Historique des versions

Depuis un carnet, cliquez sur l’icône d’engrenage et cliquez sur Historique des versions pour ouvrir le panneau latéral de l’historique des versions. Vous pouvez prévisualiser, restaurer ou cloner une version précédente de votre carnet. Pour plus d’informations, consultez le guide de l’historique des versions.

Instantanés de graphiques

Les carnets prennent automatiquement des instantanés des graphiques avec des plages de temps fixes pour préserver la vue avant que les limites de conservation des données ne s’appliquent. Aucune configuration n’est requise. Utilisez le menu kebab à côté d’un graphique pour afficher ou télécharger un instantané.

Les instantanés sont des images statiques de graphiques avec une plage de temps fixe (par exemple, Aug 18, 12:00 am - Aug 19, 11:59 pm). Un instantané se met à jour lorsque le graphique est mis à jour, tant que le graphique continue d’utiliser une plage de temps fixe. Changer le graphique en une plage de temps globale (par exemple, Past 1 hour) supprime l’instantané.

Vous pouvez prévisualiser l’état de l’instantané pour un carnet en survolant l’indicateur d’instantané du graphique sous le titre du carnet. La prévisualisation montre l’heure du dernier instantané et le nombre d’instantanés créés.

Lorsqu’un carnet contient un graphique avec des données qui dépassent ses limites de conservation des données, le carnet affiche un instantané en ligne du graphique. L’instantané est une image statique, mais il est remplacé si vous modifiez le graphique sous-jacent.

Permissions

Par défaut, tous les utilisateurs disposent de l’ensemble des autorisations relatives aux notebooks.

Utilisez nos contrôles d’accès pour restreindre l’accès en vue et en modification uniquement à vous-même :

1. En visualisant un carnet, cliquez sur le bouton Partager dans le coin supérieur droit.
2. Sélectionnez Privé pour moi.
3. Cliquez sur Enregistrer.

Utilisez des contrôles d’accès granulaires pour limiter les rôles qui peuvent modifier un carnet particulier :

1. En visualisant un carnet, cliquez sur le bouton Partager dans le coin supérieur droit.
2. Sélectionnez Personnalisé.
3. Mettez à jour l’accès de l’organisation à Lecteur pour révoquer l’accès en modification du reste de l’organisation.
4. Utilisez le menu déroulant pour sélectionner un ou plusieurs rôles, équipes ou utilisateurs qui peuvent modifier le carnet.
5. Cliquez sur Ajouter.
6. La boîte de dialogue se met à jour pour montrer que le rôle que vous avez sélectionné a la permission Éditeur.
7. Cliquez sur Enregistrer.

Remarque : Pour maintenir votre accès en modification au carnet, le système exige que vous incluiez au moins un rôle dont vous êtes membre avant de sauvegarder.

Vous devez avoir un accès en modification pour restaurer l’accès général à un carnet restreint. Complétez les étapes suivantes :

1. En visualisant un carnet, cliquez sur le bouton Partager dans le coin supérieur droit.
2. Sélectionnez Mon organisation.
3. Cliquez sur Enregistrer.

Recherche de carnets

La page Liste des Carnets est l’endroit où trouver tous vos carnets.

Rechercher

Le champ de recherche prend en charge la recherche en texte intégral. Tapez votre requête pour afficher les carnets pertinents comme résultats.

Filtrage

Vous pouvez filtrer les carnets avec les méthodes suivantes :

Il existe également des filtres rapides pour accéder à vos carnets et aux carnets étiquetés avec vos équipes.

Reprendre là où vous vous étiez arrêté

Si aucun filtre n’est activé, la section Reprendre là où vous vous étiez arrêté apparaît, affichant les carnets les plus récents que vous avez consultés ou modifiés.

Tri des carnets

Vous pouvez trier les carnets en sélectionnant l’étoile ⭐, les détails ou les en-têtes modifiés pour trier par ces valeurs.

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Gérez et optimisez vos coûts OCI avec Datadog Cloud Cost Management.BLOG Créer des histoires axées sur les données grâce aux notebooks collaboratifsBLOG Meilleures pratiques pour écrire des postmortems d'incidentBLOG Transformez et enrichissez vos journaux avec les pipelines d'observabilité Datadog.BLOG Explorez vos données avec Sheets, l'éditeur DDSQL et les carnets pour une analyse avancée dans Datadog.BLOG Comment nous avons créé une pratique FinOps réussie chez Datadog.BLOG Commencer avec les carnets.CENTRE D'APPRENTISSAGE Utiliser les carnets Datadog pour des rapports centralisés.CENTRE D'APPRENTISSAGE