mirror of
https://github.com/grafana/grafana.git
synced 2025-08-06 02:59:24 +08:00
8a650e535b
* Added and updated frontmatter descriptions for dashboards pages * fixed typo * Updated public dashboards page description
94 lines
4.0 KiB
Markdown
94 lines
4.0 KiB
Markdown
---
|
|
aliases:
|
|
- ../../panels/library-panels/
|
|
- ../../panels/library-panels/add-library-panel/
|
|
- ../../panels/library-panels/create-library-panel/
|
|
- ../../panels/library-panels/delete-library-panel/
|
|
- ../../panels/library-panels/manage-library-panel/
|
|
- ../../panels/library-panels/unlink-library-panel/
|
|
- ../../panels/panel-library/
|
|
- ../manage-library-panels/
|
|
labels:
|
|
products:
|
|
- cloud
|
|
- enterprise
|
|
- oss
|
|
menuTitle: Manage library panels
|
|
title: Manage library panels
|
|
description: Create reusable library panels that you can use in any dashboard
|
|
weight: 300
|
|
---
|
|
|
|
# Manage library panels
|
|
|
|
A library panel is a reusable panel that you can use in any dashboard. When you make a change to a library panel, that change propagates to all instances of where the panel is used. Library panels streamline reuse of panels across multiple dashboards.
|
|
|
|
You can save a library panel in a folder alongside saved dashboards.
|
|
|
|
## Create a library panel
|
|
|
|
When you create a library panel, the panel on the source dashboard is converted to a library panel as well. You need to save the original dashboard once a panel is converted.
|
|
|
|
1. Open a panel in edit mode.
|
|
1. In the panel display options, click the down arrow option to bring changes to the visualization.
|
|
{{< figure src="/media/docs/grafana/panels-visualizations/screenshot-create-lib-panel-from-edit-9-5.png" class="docs-image--no-shadow" max-width= "800px" alt="Library panels tab of the panel editor pane" >}}
|
|
1. Click **Library panels**, and then click **+ Create library panel** to open the create dialog.
|
|
1. In **Library panel name**, enter the name.
|
|
1. In **Save in folder**, select the folder to save the library panel.
|
|
1. Click **Create library panel** to save your changes.
|
|
1. Save the dashboard.
|
|
|
|
Once created, you can modify the library panel using any dashboard on which it appears. After you save the changes, all instances of the library panel reflect these modifications.
|
|
|
|
You can also create a library panel directly from the edit menu of any panel.
|
|
|
|
{{< figure src="/media/docs/grafana/panels-visualizations/screenshot-create-from-more-9-5.png" class="docs-image--no-shadow" max-width= "900px" alt="Create library panel option in the panel menu" >}}
|
|
|
|
## Add a library panel to a dashboard
|
|
|
|
Add a Grafana library panel to a dashboard when you want to provide visualizations to other dashboard users.
|
|
|
|
1. Click **Dashboards** in the left-side menu.
|
|
1. Click **New** and select **New Dashboard** in the dropdown.
|
|
1. On the empty dashboard, click **+ Import library panel**.
|
|
|
|
You will see a list of your library panels.
|
|
|
|
1. Filter the list or search to find the panel you want to add.
|
|
1. Click a panel to add it to the dashboard.
|
|
|
|
## Unlink a library panel
|
|
|
|
Unlink a library panel when you want to make a change to the panel and not affect other instances of the library panel.
|
|
|
|
1. Click **Dashboards** in the left-side menu.
|
|
1. Click **Library panels**.
|
|
1. Select a library panel that is being used in different dashboards.
|
|
1. Select the panel you want to unlink.
|
|
1. Hover over any part of the panel to display the actions menu on the top right corner.
|
|
1. Click the menu and select **Edit**.
|
|
1. Click **Unlink** on the top right corner of the page.
|
|
1. Click **Yes, unlink**.
|
|
|
|
## View a list of library panels
|
|
|
|
You can view a list of available library panels and search for a library panel.
|
|
|
|
1. Click **Dashboards** in the left-side menu.
|
|
1. Click **Library panels**.
|
|
|
|
You can see a list of previously defined library panels.
|
|
{{< figure src="/media/docs/grafana/panels-visualizations/screenshot-library-panel-list-9-5.png" class="docs-image--no-shadow" max-width= "900px" alt="Library panels page with list of library panels" >}}
|
|
|
|
1. Search for a specific library panel if you know its name.
|
|
|
|
You can also filter the panels by folder or type.
|
|
|
|
## Delete a library panel
|
|
|
|
Delete a library panel when you no longer need it.
|
|
|
|
1. Click **Dashboards** in the left-side menu.
|
|
1. Click **Library panels**.
|
|
1. Click the delete icon next to the library panel name.
|