> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Use notebooks to gather related information
Use *notebooks* to gather information from multiple pages in Chronosphere Observability
Platform. When you're troubleshooting a problem, you might need graphs, charts, and
other resources to review at the same time. Notebooks let you gather these resources
in one place for ease of review.
## View a notebook
Notebooks open in a side panel anywhere in Observability Platform. Observability
Platform displays the last notebook you accessed. Your open notebook stays visible
anywhere in Observability Platform.
### Open a notebook
Where the **Notebook** control appears depends on whether it is in the page header
or the right sidebar. Use the tab that matches what you see:
### Switch notebooks
To switch notebooks or find a notebook you opened recently:
1. Click ** Select a notebook** in the notebook header.
2. Select the **My Notebooks** or **Recent Notebooks** tab:
* **My Notebooks** lists notebooks in your personal collection. The open
notebook is labeled **(current)** and appears at the top of the list.
* **Recent Notebooks** lists notebooks you opened recently, in order.
3. If needed, filter the list by entering a name in **Search**.
4. Click a **Name** in the table to open the selected notebook. Each row also
displays a **Date** for when the notebook was last updated.
### Share a notebook
Notebooks are stored in your personal collection. Other users don't see your
notebooks in **Select a notebook**.
To share a notebook:
1. Open the notebook.
2. Share the notebook using one of these controls:
* Click ** Copy URL** in the notebook header. If **Copy URL**
isn't visible, click the three vertical dots
icon, and then click **Copy URL**.
* In **Select a notebook**, open the row menu and click **Share**.
See [Notebook header](#notebook-header) for both header layouts.
When someone opens the link, Observability Platform opens that notebook in their
notebook panel.
### View version history
To view the history of changes for a notebook, click **Version history**. If
**Version history** isn't visible, click the three
vertical dots icon in the notebook header, and then click **Version history**.
See [Notebook header](#notebook-header) for both header layouts.
Click **Version history** to display a panel with two tabs:
* [**Code config**](/tooling/gitops#use-the-code-config-tool): Displays a code
representation of the selected entity as of the time of the selected revision.
* **Code diff**: Displays a Git-style diff of the most-recent change made to the
entity, in Chronosphere API format. To compare the selected revision to another
revision in the history, click the **Compare With** dropdown and select the
timestamp of the revision that you want to compare.
* Click **Unified** to see the diff stacked horizontally.
* Click **Split** to see changes side by side.
You can see the user, service account, or
[actor](/tooling/api-info#change-actors) which made and the method used for the
last change at the top of the list of changes.
To view a revision in the history, click any entry in the list of timestamped
revisions. The timestamps default to your local timezone.
You can view unchanged lines within the diff by clicking the **Expand X lines**
links.
For a natural language description of the differences between versions, click
**Explain what has changed**. An information box appears with a summary of the
changes. This summary can help users who are less familiar with code updates
understand changes. Use the **thumbs up** or **thumbs down** icon
to indicate whether the explanation was helpful or not.
The Version History view retains up to 500 revisions, or up to 15 months of revisions
if there are fewer than 500 revisions.
#### Restore a previous version
To restore a prior version of a notebook while reviewing its version history:
1. Select the version to revert to.
2. Click **Restore to *`DATE`***, where *`DATE`* is the selected version.
3. Click **Restore**.
The notebook refreshes and displays the restored version.
### Reload an updated notebook
If Observability Platform detects a newer saved version of the notebook than the
one displayed, an alert displays: **A new version of this notebook is available.**
This can happen in these situations:
* Another user saves changes to a shared notebook you're viewing.
* You edit the same notebook in another browser tab.
Click **Reload** to load the latest saved version.
## Notebook header
**Version history**, **Copy URL**, and **Create notebook** appear at the top of the
notebook panel. Observability Platform shows them as separate icon buttons or groups
them in a menu, depending on the width of the notebook header row. The layout switches
at 360 pixels. When the header row is narrower than 360 pixels, Observability Platform
uses a narrow header. When the row is 360 pixels or wider, it uses a wide header.
Resizing the notebook panel or using a long notebook name can change the header width
and switch between layouts.
Use the tab that matches what you see:
## Create a notebook
If your personal collection has no notebooks when you open the notebook panel,
Observability Platform creates one automatically.
To create another notebook:
1. [Open a notebook](#open-a-notebook).
2. Create a notebook using one of these controls:
* Click ** Create notebook** in the notebook header. If
**Create notebook** isn't visible, click the three
vertical dots icon, and then click **Create notebook**.
* Click ** Select a notebook**, and then click
**New Notebook**.
See [Notebook header](#notebook-header) for both header layouts.
3. A new notebook opens with a default name like **Untitled notebook ``**.
Click the name to rename it.
## Add items to your notebook
Notebooks combine dashboard-style panels, embedded entity link cards, and free-form
text.
When **Add to notebook** appears in a panel menu or in page actions, you can add
that visualization to a notebook. Paste a URL from a resource page to embed a link
card. Use paste for pages that don't offer **Add to notebook** on a panel, such as
[collections](/administer/collections/home) or [teams](/administer/accounts-teams/teams)
pages.
To delete an item from your notebook, click the item and then press `Delete`.
### Format text
Click anywhere in the notebook that isn't an added resource to add notes. Format
notes using the toolbar under the notebook title bar:
* **Bold**, **Italic**, and **Code** for inline formatting.
* **Link** to add or edit a hyperlink. In the **Add link** dialog, enter **Text**
and **Link**, and then click **Apply**.
* **Numbered list** and **Bulleted list** for lists.
When you select text, the same formatting controls display in a menu above the
selection.
### Drag a panel from a dashboard
To drag a panel into your notebook:
1. [Open a notebook](#open-a-notebook).
2. Open a [dashboard](/observe/dashboards).
3. Drag a panel by its header into the notebook. When the pointer is over the
notebook, **Drop panel to add to notebook** displays.
### Create a dashboard panel in the notebook
To create a panel in the notebook:
1. [Open a notebook](#open-a-notebook) that has no content.
2. Click **Add panel**.
3. Configure the panel in the **Add panel** dialog, and then click **Apply**.
See [Edit a panel](/observe/dashboards/panels#edit-a-panel).
### Paste a dashboard panel
To paste a copied panel into the notebook:
1. [Open a notebook](#open-a-notebook).
2. On a [dashboard](/observe/dashboards), click a panel and press `Control+C`
(`Command+C` on macOS) to copy it.
3. Click in the notebook text area and press `Control+V` (`Command+V` on macOS)
to paste the panel.
### From Logs Explorer
In [Logs Explorer](/investigate/querying/query-logs), add the current query to a
notebook from the page actions above the query results.
To add a Logs Explorer query to a notebook:
1. [Open a notebook](#open-a-notebook), or leave the notebook closed to pick a
notebook when you add content.
2. Open [Logs Explorer](/investigate/querying/query-logs).
3. Enter a query. **Add to notebook** is disabled until the query field contains
text.
4. To match a specific chart type in the notebook, select a visualization for the
query results.
5. Click **Add to notebook** in the page actions.
If a notebook is already open, Observability Platform adds the panels to that
notebook. Otherwise, select a notebook in the **Add panel to notebook** dialog,
or click **Add to new notebook**.
Observability Platform adds two panels to the notebook:
* A log volume histogram for the query
* A panel that matches the selected visualization, such as list, table, or time
series
Both panels use the Logs Explorer [time range](/navigate/time-ranges).
### From another page
On [dashboards](/observe/dashboards), [service pages](/observe/services/service-pages),
[SLOs](/observe/slo), [monitors](/investigate/alerts/monitors),
[alerts](/investigate/alerts/alert-details), the
[metrics catalog](/investigate/system-library/metrics-catalog), and
[Metrics DDx](/investigate/analyze/differential-diagnosis/metrics), **Add to notebook**
can appear in a panel menu.
When **Add to notebook** appears in a panel menu:
1. Hold the pointer over the panel, and then click the three
vertical dots icon.
2. Select **Add to notebook**.
3. Select a notebook, or click **Add to new notebook** to create a new notebook.
The selected resource displays at the bottom of your notebook.
### Paste entity links into the notebook
Paste a URL copied from a resource page in Observability Platform to embed a link
card labeled with the resource type and name. Click the card to open the resource.
To paste entity links:
1. Click in the notebook text area.
2. Paste the URL with `Control+V` (`Command+V` on macOS).
Paste each URL on its own line to add multiple resource cards.
## Delete a notebook
To delete a notebook:
1. [Open a notebook](#open-a-notebook).
2. Click ** Select a notebook** in the notebook header.
3. Next to the notebook you want to delete, click the
three vertical dots icon and then click **Delete**.
## Customize panels in a notebook
Change panel time ranges, open the panel editor to update queries and display
options, or capture snapshots.
### Change the time range
Change the [time range](/navigate/time-ranges) for the entire notebook to shift all
panels together, or override the time range on individual panels. For example, if
there's an anomaly in a graph in your notebook, add a second copy of the panel and
change its time range to the same time last week to compare patterns.
To change the time range for the entire notebook:
1. In the notebook, click the ** time range selector** below the
format toolbar.
2. Select a time range. See [Select time ranges](/navigate/time-ranges) for preset,
custom, and calendar options.
Panels without a per-panel override use the notebook time range. Panels with an
override keep their own time until you reset them.
To override the notebook time range for one panel:
1. Hold the pointer over the panel.
2. Click the clock icon.
3. Select an available time range, or **Custom time range** to set your own.
The customized time range appears in the panel as a chip under the panel name.
To reset the time range, click the `x` in the time range [chip](/navigate#chips),
or click the clock icon and select **Use notebook time**.
### Edit panel contents
To update a panel in a notebook:
1. Click the ** Edit** icon.
2. [Edit the panel](/observe/dashboards/panels#edit-a-panel).
Not all panel editing operations are available in notebooks. For example, you
can't change the [panel type](/observe/dashboards/panels#panel-types).
### Take a snapshot
Take a snapshot of a panel to capture specific data on a longer-term, static basis.
1. Add a panel to your notebook.
2. In the selected panel, click the three
vertical dots icon.
3. Select **Capture snapshot**.
The panel updates to indicate its snapshot status by adding
** Snapshot** under the panel title.
The snapshot time range displays next to the snapshot indicator. Zooming in on a time
range updates the time range chip, and adds an `x` to the chip. Click the `x` to
return to the original snapshot.
Notebook**
icon in the page header, between [pinned scope](/navigate/pinned-scopes) and search.
After the notebook opens, see [Notebook header](#notebook-header) for create, share,
and version history controls.