Notebooks
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

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.

Notebook List

La Notebook List vous permet de consulter et de rechercher les notebooks précédemment créés. Le nom, le 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 contenu

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 analysé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 apparaît à 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 de la souris dessus, ou utilisez un raccourci clavier. Accédez à liste de tous les raccourcis clavier en cliquant sur le bouton 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 : permet d’afficher un graphique par valeur de tag pour voir 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: