diff --git a/docs/sources/alerting/unified-alerting/_index.md b/docs/sources/alerting/unified-alerting/_index.md index dccf861e53e..7a5dc89ddb9 100644 --- a/docs/sources/alerting/unified-alerting/_index.md +++ b/docs/sources/alerting/unified-alerting/_index.md @@ -20,6 +20,7 @@ Alerts have four main components: You can perform the following tasks for alerts: + - [Create a Grafana managed alert rule]({{< relref "alerting-rules/create-grafana-managed-rule.md" >}}) - [Create a Cortex or Loki managed alert rule]({{< relref "alerting-rules/create-cortex-loki-managed-rule.md" >}}) - [View existing alert rules and their current state]({{< relref "alerting-rules/rule-list.md" >}}) diff --git a/docs/sources/menu.yaml b/docs/sources/menu.yaml new file mode 100644 index 00000000000..e69de29bb2d diff --git a/docs/sources/panels/panel-library.md b/docs/sources/panels/panel-library.md new file mode 100644 index 00000000000..061365cba63 --- /dev/null +++ b/docs/sources/panels/panel-library.md @@ -0,0 +1,77 @@ ++++ +title = "Library panels" +weight = 400 ++++ + +# Library panels + +Library panels allow users to create reusable panels where any changes made to one instance of the library panel is reflected on every dashboard +affecting all other instances. where the panel is used. These panels can be saved in folders alongside Dashboards and streamline reuse of panels +across multiple dashboards. + +## Create a library panel + +Before you can use library panels, you have to create them. + +To create a library panel: + +1. Create a Grafana panel as you normally would, following instructions in [Add a panel]({{< relref "./add-a-panel.md" >}}). You an also use an existing panel. +1. Click the title of the panel and then click **Edit**. The panel opens in edit mode. +1. In the panel display options (side pane), click the down arrow option to bring changes to the visualization. + {{< figure src="/static/img/docs/library-panels/create-lib-panel-from-edit-8-0.png" class="docs-image--no-shadow" max-width= "900px" caption="Screenshot of the edit panel" >}} +1. Click the **Library panels** option, and then click **Create new library panel** to open the create dialog. + {{< figure src="/static/img/docs/library-panels/create-lib-panel-8-0.png" class="docs-image--no-shadow" max-width= "900px" caption="Screenshot of the create library panel dialog" >}} +1. In **Library panel name**, enter the name. +1. In **Save in folder**, select the folder to save the library panel. By default, the General folder is selected. +1. Click **Create library panel** to save your changes. + +Optionally, you can click title of the panel and then click **More > Create Library panel**. + + {{< figure src="/static/img/docs/library-panels/create-lib-panel-from-edit-8-0.png" class="docs-image--no-shadow" max-width= "900px" caption="Screenshot of the edit panel" >}} + + Then follow the instructions from + +Once created, you can modify the library panel. can be modified, and once saved, all instances of the library panel will represent these modifications. + + +## Add a library panel + +To add a library panel to a dashboard: + +1. Hover over the **+** option on the left menu, then select **Create** from the drop down options. The Add panel dialog opens. + {{< figure src="/static/img/docs/library-panels/add-library-panel-8-0.png" class="docs-image--no-shadow" max-width= "900px" caption="Screenshot of the edit panel" >}} +1. Click the **Add a panel from the panel library** option. 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 your desired panel and add it to the dashboard. + +## Manage library panels + +To view and manage existing library panels: + +1. Hover over the **Dashboard** option on the left menu, then click **Library panels**. You can see a list of previously defined library panels. + {{< figure src="/static/img/docs/library-panels/library-panel-list-8-0.png" class="docs-image--no-shadow" max-width= "900px" caption="Screenshot of the edit panel" >}} +1. Search for a specific library panel if you know its name. You can also filter the panels by folder or type. + + +## Unlink a library panel + +In case you have a library panel on your dashboard that want to modify it without affecting all other instances of the library panel, you can unlink the library panel. + +To unlink a library panel from a dashboard: + +1. Hover over **Dashboard** on the left menu, and then click **Library panels**. +1. Select a library panel that is being used in different dashboards. You will see a list of all the dashboards where the library panel is used. + {{< figure src="/static/img/docs/library-panels/used-in-list-8-0.png" class="docs-image--no-shadow" max-width= "900px" caption="Screenshot of the edit panel" >}} +1. Select the panel you want to unlink and update. +1. Click the title of the panel and then click **Edit**. The panel opens in edit mode. +1. Click the **Unlink** option on the top right corner of the UI. + +## Delete a library panel + +To delete a library panel: + +1. Hover over **Dashboard** on the left menu, and select Library panels from the drop down options. +1. Select a library panel that is being used in different dashboards. You will see a list of all the dashboards. +1. Select the panel you want to delete. +1. Click the delete icon next to the library panel name. + diff --git a/docs/sources/panels/visualizations/table/filter-table-columns.md b/docs/sources/panels/visualizations/table/filter-table-columns.md index ab60122d16f..00ca36c0979 100644 --- a/docs/sources/panels/visualizations/table/filter-table-columns.md +++ b/docs/sources/panels/visualizations/table/filter-table-columns.md @@ -1,14 +1,13 @@ +++ title = "Filter table columns" keywords = ["grafana", "table options", "documentation", "format tables", "table filter", "filter columns"] +aliases = ["/docs/grafana/latest/reference/table/", "/docs/grafana/latest/features/panels/table_panel/", "/docs/grafana/next/panels/visualizations/table/table-field-options/"] weight = 600 +++ # Filter table columns -> **Note:** This feature is available in Grafana 7.2+. - -If you turn on the **Column filter** in [Table options]({{< relref "table-field-options.md" >}}), then you can filter table options. +If you turn on the **Column filter**, then you can filter table options. ## Turn on column filtering diff --git a/docs/sources/whatsnew/whats-new-in-v8-0.md b/docs/sources/whatsnew/whats-new-in-v8-0.md index 143a363ecca..4dc844e7cd2 100644 --- a/docs/sources/whatsnew/whats-new-in-v8-0.md +++ b/docs/sources/whatsnew/whats-new-in-v8-0.md @@ -30,7 +30,7 @@ To learn more about the differences between new alerts and the legacy alerts, re ### Library panels -Library panels allow users to build panels that can be used in multiple dashboards. Any updates made to that shared panel will then automatically be applied to all the dashboards that have that panel. +Library panels allow users to build panels that can be used in multiple dashboards. Any updates made to that shared panel will then automatically be applied to all the dashboards that have that panel. For instructions on how to create, add, unlink and manage library panels, refer to [Library panels]({{< relref "../panels/panel-library.md" >}}). ### Real-time streaming