Notebooks

Información general

Los notebooks combinan gráficos y texto en un formato lineal con celdas. De esta forma, te permiten consultar y compartir artículos con tus datos en informes, estudios, runbooks y otros documentos.

Primeros pasos

  1. En la página con la lista de notebooks, haz clic en + New Notebook (+ Nuevo notebook).

  2. Haz clic en el botón Save Notebook (Guardar notebook).
    Nota: De forma predeterminada, los notebooks nuevos no se guardan automáticamente.

  3. Añade nuevas celdas a tu notebook con gráficos y contenidos compatibles.

  4. Configura las celdas.

Colaboración

Indicadores de los usuarios que están consultando un notebook y haciendo cambios en vivo

Los notebooks permiten la colaboración en tiempo real. Los indicadores de presencia muestran a las personas que están consultando un notebook en cualquier momento, además de las modificaciones en tiempo real de las celdas. Los cambios hechos en un notebook aparecen de forma automática sin necesidad de actualizar.

Todos los miembros del equipo pueden abrirlos, pero solo los usuarios de Datadog con el permiso Notebooks Write pueden modificarlos o eliminarlos.

Comentar

Para añadir un comentario, selecciona un texto o pasa el cursor por encima de un gráfico. El icono Add comment (Añadir comentario) aparecerá a la derecha de la celda. Desde los comentarios, también puedes notificar a un miembro del equipo hacer mediante la función@mention. Haz clic en los tres puntos verticales de la esquina superior derecha de un comentario que hayas escrito para editarlo o borrarlo. También puedes consultar o reabrir comentarios resueltos en el panel lateral Comment History (Historial de comentarios), al que podrás acceder desde el menú del engranaje del notebook.

Los autores de un notebook reciben notificaciones por email cuando se publican comentarios en sus notebooks. A su vez, la persona que deja el comentario también los recibe cuando alguien le responde. Gestiona los parámetros de las notificaciones usando Notifications en el menú del engranaje.

Tipo de vista

Menú desplegable de tipo de vista

Puedes alternar entre las distintas vistas del notebook seleccionando el menú desplegable de la parte superior derecha de tu notebook.

  • Editing (Edición): para hacer cambios en el notebook.

  • Viewing (Visualización): para consultar contenidos que son de solo lectura y evitar que los usuarios hagan cambios no deseados en parámetros y datos.

  • Presenting (Presentación): para compartir contenidos de forma que cada celda del notebook aparezca como una diapositiva. Este modo es compatible con interacciones gráficas como cuadros de información y leyendas.

Compartir un notebook

Haz clic en el icono del engranaje de la parte superior derecha de un notebook para ver las opciones para compartir. Puedes exportarlo a PDF, Markdown y otros formatos compatibles con un editor de documentos.

Para copiar un notebook en un editor de documentos, haz clic en Copy formatted contents (Copiar contenidos con formato). Luego pégalo en un editor de documentos tipo Google Docs o Microsoft Word para ver los contenidos, incluidos los gráficos, en su formato original.

Importar o exportar un notebook en formato JSON

Usa Export Notebook JSON (Exportar notebook en formato JSON) para descargar un archivo JSON que contiene la definición de tu notebook. Con Import Notebook JSON (Importar notebook en formato JSON) se sobreescribe el contenido del notebook con el del archivo JSON que cargues.

Enlace a celdas individuales

Para copiar la URL de una celda específica, haz clic en el menú Share (Compartir) de la celda y selecciona Link directly to cell (Vincular directamente a celda). La vinculación directa está disponible tanto para las celdas de visualización como para las de Markdown.

Cuando un usuario visita la URL de una celda específica, se abre el notebook y muestra la celda en la parte superior de la ventanilla. Los enlaces son absolutos. La URL de una celda no varía incluso si se cambia de sitio dentro del notebook.

Lista de notebooks

Lista de notebooks con la vista previa de los tipos de celdas de un notebook seleccionado

La lista de notebooks te permite ver y buscar notebooks creados anteriormente. Se muestra el nombre, el creador y la fecha de última modificación de cada notebook. Los notebooks se agrupan por:

  • Your notebooks (Tus notebooks): notebooks que has creado.
  • All Notebooks (Todos los notebooks): todos los notebooks de tu organización.
  • Notebook Type (Tipo de notebook): agrupa los notebooks por tipo.

Pasa el cursor encima del icono de vista previa en cualquier notebook para ver los contenidos, incluidos los de tipo widget y Markdown. Para abrir el notebook en modo de visualización, pasa el cursor encima del notebook y haz clic en Open notebook in view mode (Abrir notebook en modo de visualización) a la derecha.

Galería de plantillas

En la galería de plantillas podrás ver plantillas listas para usar a partir de las cuales podrás crear nuevos notebooks. Las plantillas incluyen un informe de respuesta a incidentes, un informe de incidentes y una especificación SLO. También puedes crear una nueva plantilla personalizada para construir estructuras de notebook reutilizables.

Historial de versiones

Desde notebook, haz clic en el icono Configure (Configurar) y luego en Version history (Historial de versiones) para abrir el panel lateral del historial de versiones. Puedes previsualizar, restaurar o clonar el historial de versiones de tu notebook. Para más información, consulta la guía del historial de versiones.

Configuración del notebook

Periodos de tiempo

De forma predeterminada, todas las celdas con gráficos están vinculadas al periodo de tiempo que se define en el encabezado del notebook.

Para ver un periodo diferente, elige otra opción en el selector. También puedes arrastrar en el gráfico directamente. La URL se actualizará para reflejar el nuevo periodo de tiempo sin guardarlo en el notebook.

Nota: Hacer clic y arrastrar para hacer zoom en un gráfico no desvincula la celda del periodo global, cambia el periodo global del notebook.

Guardar el periodo global del notebook con el botón Set Default Time

Para guardar el periodo elegido como el predeterminado del notebook, haz clic en Set Default Time (Definir periodo por omisión). Para restablecer el periodo al global que tuvieras guardado de forma predeterminada, haz clic en el botón de restablecimiento.

Las celdas individuales pueden desvincularse del periodo global y asociarse a un periodo de tiempo concreto.

Selector de periodos de tiempo para celdas con la celda desvinculada del periodo global

Para ver un periodo de tiempo diferente en una sola celda, edítala y utiliza el conmutador para desvincularla del periodo global. Cambia el periodo utilizando el selector o arrastrando el gráfico. Los cambios que se hacen en modo de edición se guardan automáticamente cuando pulsas Done (Listo). Si lo que quieres es descartarlos, haz clic en Cancel (Cancelar).

Tipos de notebooks

Botón Add Type (Añadir tipo) destacado en un notebook

Los notebooks pueden agruparse en tipos, lo que te permite acceder rápidamente a la información relevante. Si se crean a partir de otros productos como gestión de incidencias o monitores, se les asigna un tipo automáticamente. Pasa el cursor sobre el título para que se muestre la opción para añadirlo o editarlo. Para añadir un tipo haz clic en + Add Type y, si lo que quieres es editarlo, haz clic en el icono del lápiz que aparece al lado cuando pasas el cursor por encima.

Snapshots gráficas

Puedes configurar tus notebooks para que capturen snapshots de gráficos que podrían dejar de estar disponibles pronto de forma automática. Activa esta función haciendo clic en Turn on snapshots (Activar snapshots) en el menú del engranaje de cualquier notebook. También puedes utilizar este menú para ver tus snapshots y desactivar las automáticas. Recuerda que tendrás que desactivar la función para retirar el acceso a las snapshots que ya tengas.

Opción del menú del engranaje para activar las snapshots

Los notebooks que tengan la función de toma de snapshots automática activa capturan una imagen estática de los gráficos para un periodo de tiempo determinado (por ejemplo, Aug 18, 12:00 am - Aug 19, 11:59 pm). Estas snapshots se actualizan cuando el gráfico se modifica, siempre y cuando el nuevo gráfico también tenga vinculado un periodo de tiempo determinado. Si cambias el periodo de tiempo del gráfico a global (por ejemplo Past 1 Hour), la snapshot se eliminará.

Para previsualizar una snapshot en un gráfico vinculado a un periodo de tiempo concreto, basta con pasar el ratón sobre el icono de la cámara mientras estás en modo de edición.

Si quieres compartir una versión de tu notebook con snapshots, desde el menú del engranaje, haz clic en View snapshots (Ver snapshots). Copia la URL o anexa &view=snapshots a la URL de cualquier notebook que tenga la función de snapshot activada.

Variables de plantilla

Los notebooks aceptan variables de plantilla. Recorre las visualizaciones de forma dinámica añadiendo y seleccionando valores de variables de plantilla. Para obtener más información, consulta Variables de plantilla.

Configuración de las celdas

Para añadir celdas, usa el botón + que aparece a la izquierda de la celda o selecciona una opción de la sección Add New Cell (Añadir celda nueva) de la parte inferior del notebook. Usa la bandeja de acciones que aparece sobre la celda cuando pasas el cursor por encima para compartir, clonar o borrar celdas. Las celdas gráficas pueden exportarse a un dashboard o descargarse como PNG o CSV de datos gráficos. Los cambios que hagas en el modo de edición se guardan automáticamente al pulsar Done (Listo). Si quieres descartarlos, haz clic en Cancel (Cancelar).

Opciones de edición

Haz clic en More options (Más opciones) en el editor integrado de un widget para editar las opciones del widget. Añade detalles como superposiciones de eventos, marcadores y controles del eje Y.

Opciones de diseño

En una celda de un notebook, haz clic en Edit (Editar) para ver la configuración de la celda en el modo de edición. También puedes ver las opciones de diseño disponibles, que varían en función del tipo de contenido de la celda. Tienes algunos ejemplos a continuación:

  • Graph size (Tamaño del gráfico): elige entre XS, S, M (por omisión), L y XL.
  • Graph legend (Leyenda del gráfico): desmarca la casilla para ocultar la leyenda. Las leyendas se desactivan automáticamente para los gráficos XS y S.
  • Grouping (Grupos): muestra un gráfico por valor de etiqueta (tag) para ver pequeños múltiplos de tu visualización.
Parámetros gráficos de una celda de un notebook en modo de edición que muestran las opciones de tamaño, leyenda y agrupación

Nota: Cambiar alguno de estos parámetros solo afectará a la celda seleccionada.

Tipos de contenido

Los notebooks aceptan celdas de visualización y de texto. Las celdas de texto tienen formato Markdown, lo que permite usar encabezados, subencabezados, enlaces, imágenes, listas y bloques de código. También aceptan diagramas con formato MermaidJS.

Los gráficos en notebooks son compatibles con todos los orígenes de datos de Datadog: métricas, eventos de logs, tráfico de redes, eventos RUM, métricas de elaboración de perfiles, señales de seguridad, etc. Los gráficos se crean con el editor de consultas de Datadog. Notebook acepta:

Limitar el acceso de edición

Por omisión, todos los usuarios tienen acceso completo a notebooks.

Utiliza los controles de acceso granular para limitar los roles que pueden editar un notebook concreto:

  1. Cuando consultes un notebook, haz clic en el engranaje que aparece en la parte superior derecha. Se abrirá el menú de configuración.
  2. Selecciona Permissions (Permisos).
  3. Haz clic en Restrict Access (Restringir el acceso).
  4. El cuadro de diálogo se actualiza para mostrar que los miembros de tu organización tienen por omisión el permiso de acceso Viewer (Visualización).
  5. Utiliza el menú desplegable para seleccionar uno o varios roles, equipos o usuarios que pueden modificar el notebook.
  6. Haz clic en Add (Añadir).
  7. El cuadro de diálogo se actualiza para indicar que el rol que has seleccionado tiene el permiso Editor (Edición).
  8. Haz clic en Save (Guardar).

Nota: Para mantener tu acceso de edición al notebook, el sistema necesita que incluyas al menos un rol al que pertenezcas antes de guardar.

Para restablecer el acceso general a un notebook con acceso restringido, sigue estos pasos:

  1. Cuando consultes un notebook, haz clic en el engranaje que aparece en la parte superior derecha. Se abrirá el menú de configuración.
  2. Selecciona Permissions (Permisos).
  3. Haz clic en Restore Full Access (Restablecer acceso completo).
  4. Haz clic en Save (Guardar).

Leer más