Notebooks

Notebooks

Présentation

Les notebooks combinent des graphiques et du texte au sein d’un format linéaire basé sur des cellules. Ils sont conçus pour explorer vos données et partager des histoires en créant des analyses de fin de projet, des enquêtes, des runbooks, des documents, etc.

Collaboration en direct

Les notebooks prennent en charge la collaboration en temps réel. Les indicateurs de présence indiquent à tout moment qui consulte votre notebook ; les indicateurs apparaissent également à côté de toute cellule en cours de modification par un autre utilisateur.

Les modifications apportées à un notebook s’affichent automatiquement, sans qu’une actualisation soit nécessaire.

Tous les membres de votre équipe peuvent ouvrir ou modifier un notebook. Cependant, un notebook peut uniquement être supprimé par le créateur ou un administrateur.

Publier des commentaires

Pour ajouter un commentaire, sélectionnez du texte ou passez le curseur sur un graphique. Le bouton Add a comment apparaît alors à droite de la cellule.

Pour modifier ou supprimer un commentaire que vous avez ajouté, cliquez sur le menu dans le coin supérieur droit du commentaire.

Des notifications par e-mail sont envoyées aux auteurs de notebook lorsque de nouveaux commentaires sont ajoutés, ainsi qu’aux personnes à l’origine d’un commentaire en cas de réponse. Vous pouvez gérer vos paramètres de notifications en accédant à Notifications depuis le menu des réglages du notebook.

Liste des notebooks

La liste des notebooks vous permet de consulter et de rechercher les notebooks précédemment créés. Le nom, l’identité du créateur et la date de dernière modification de chaque notebook sont indiqués. Les notebooks sont regroupés en deux catégories :

  • My Notebooks : les notebooks que vous avez créés.
  • Other Notebooks : les notebooks créés par d’autres membres de votre équipe.

Nouveau notebook

Créez un notebook depuis la navigation principale, en accédant à Notebooks > New Notebook.

Par défaut, les nouveaux notebooks ne s’enregistrent pas automatiquement. Vous devez cliquer sur le bouton Save.

Types de contenus

Les notebooks prennent en charge les visualisations et les cellules de texte.

Visualisation

Les graphiques dans les notebooks prennent en charge toutes les sources de données Datadog : métriques, événements de log, spans indexées, live processes, trafic réseau, événements RUM, métriques de profiling et signaux de sécurité.

Les graphiques sont créés à l’aide de l’éditeur de requête de Datadog. Les notebooks prennent en charge les éléments suivants :

Texte

Le texte d’un notebook prend en charge le format Markdown, qui permet l’utilisation de titres, de sous-titres, de liens, d’images, de listes et de blocs de code.

Manipulation de cellules

Lorsque vous ouvrez un notebook existant, ses cellules sont « fermées ». Pour ouvrir une cellule afin de la modifier, placez le curseur de la souris dessus et utilisez CMD + clic, ou cliquez sur Edit. Pour fermer une cellule, cliquez en dehors de celle-ci, appuyez sur Échap ou appuyez sur CMD + Entrée. Une seule cellule peut être ouverte à la fois.

Pour insérer des cellules, utilisez le bouton + qui figure à gauche de la cellule. Pour partager, dupliquer ou supprimer des cellules, utilisez la barre d’action qui s’affiche au-dessus de la cellule lorsque vous passez le curseur dessus. Vous pouvez également utiliser un raccourci clavier. Accédez à la liste de tous les raccourcis clavier en cliquant sur l’icône en forme de clavier dans l’en-tête du notebook.

Intervalles de temps

Par défaut, toutes les cellules de graphique respectent le même intervalle de temps global que celui défini dans l’en-tête du notebook. Cependant, certaines cellules peuvent se dissocier de l’intervalle global et être définies sur un autre intervalle indépendant. Cela permet de comparer des métriques sur plusieurs intervalles de temps distincts au sein d’un notebook, une fonctionnalité particulièrement utile pour les enquêtes à la suite d’incidents.

Pour définir un intervalle de temps spécifique, cliquez sur l’icône en forme d’horloge dans le coin supérieur droit d’une cellule de graphique. Décochez ensuite la case Lock this cell to global time frame et définissez l’intervalle de temps souhaité :

Remarque : si vous cliquez sur une cellule et la faites glisser pour zoomer sur un graphique, cela ne dissocie pas la cellule de l’intervalle de temps global. À la place, cette opération modifie l’intervalle de temps global du notebook.

Agrandir un notebook

Développez le graphique en cliquant sur l’icône d’agrandissement située à droite de la cellule. Consultez la page Widgets pour en savoir plus sur le mode plein écran.

Options de disposition

Pour afficher les options de disposition suivantes, cliquez sur l’icône en forme de grille à droite de la cellule dans l’éditeur :

  • Graph size : sélectionnez la taille du graphique parmi XS, S, M (par défaut), L et XL.
  • Graph legend : décochez cette case pour masquer la légende. Les légendes sont automatiquement désactivées pour les graphiques XS et S.
  • Grouping : cette option permet d’afficher un graphique par valeur de tag, afin de visualiser de petits multiples de votre visualisation.

Remarque : si vous modifiez l’un de ces paramètres, le changement s’applique uniquement à la cellule sélectionnée.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles: