Notebooks combine graphs and text in a linear, cell-based format. They are designed to help you explore and share stories with your data such as incident investigations, postmortems, runbooks, and infrastructure documentation.
The Notebook List allows you to view and search previously created notebooks. Each notebook’s name, creator, and last modified date are displayed. The notebooks are grouped by:
Everyone on your team can open or edit any notebook, but a notebook can only be deleted by the creator.
Edits to another user’s notebook are not saved automatically. If you attempt to save changes to someone else’s notebook, a copy is created unless you explicitly choose to overwrite the original.
Create a new notebook from the main navigation: Notebooks > New Notebook.
A new notebook is not saved by default. You must click the Save button.
Notebooks support visualizations and text cells.
Metrics in a notebook are graphed using the Datadog query editor. Notebooks support:
Text in a notebook is formatted with Markdown, which enables the use of headings, subheadings, links, images, lists, and code blocks.
When an existing notebook is opened, the cells are in a closed state. To open a cell for editing, click on it or navigate to it with the arrow keys and press
Enter. To close a cell, click outside it or press
CMD + Enter. Only one cell may be open at a time.
To insert, clone, or delete cells, click the gear icon that appears to the left of the cell number or use a keyboard shortcut. A list of all keyboard shortcuts is available by clicking the keyboard button in the notebook header.
By default, all graph cells adhere to the global time frame set in the notebook header. However, individual cells can be unlocked from the global time and set to an independent time frame. This allows for the comparison of metrics over multiple, distinct periods of time within a single notebook, which is suited for incident investigations.
To set an individual time frame, click the clock icon in the top-right corner of a graph cell. Then, uncheck Lock this cell to global time frame and set your preferred time frame:
Note: Clicking and dragging to zoom in on a graph does not unlock the cell from the global time. It changes the notebook’s global time instead.
Expand the graph by clicking on the expand icon on the right side of the cell. More details about full screen mode is available on the Widgets page.
The following layout options are available by clicking the grid icon on the right side of the cell:
Note: Changing any of these settings only affects the targeted cell.
Copy the URL for a specific cell by clicking the chain-link icon on the right side of the cell. Direct linking is available for both visualization and Markdown cells.
When a user visits the URL for a specific cell, the notebook is opened to show the cell at the top of the viewport. Links are absolute: a cell’s URL remains the same even if it is moved to a new position within the notebook.
Save a notebook with
CMD + S or click the Save button in the notebook header. After a new notebook has been saved once, it continues to autosave at regular intervals. Also, a notebook can be saved manually at any time between autosaves. To ensure you don’t lose work, you are prompted for confirmation if you attempt to leave a notebook with unsaved changes.
Rename a notebook by clicking the name field in the notebook header.
Clone any notebook from the individual notebook by using the settings cog at the top right.
Delete a notebook from the notebook list page, or inside the individual notebook by using the settings cog at the top right. You can only delete notebooks that you have created.