mirror of
https://github.com/grafana/grafana.git
synced 2025-02-25 18:55:37 -06:00
docs: update dashboard list visualization (#87494)
* docs: update dashboard list visualization * docs: add youtube video * Apply suggestions from code review Co-authored-by: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com> * Ran prettier --------- Co-authored-by: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com> Co-authored-by: Isabel Matwawana <isabel.matwawana@grafana.com>
This commit is contained in:
Marie Cruz
GitHub
parent
40aff085fb
commit
fa319f36fb
@ -32,30 +32,66 @@ Dashboard lists allow you to display dynamic links to other dashboards. The list
|
||||
|
||||
On each dashboard load, this panel queries the dashboard list, always providing the most up-to-date results.
|
||||
|
||||
You can use a dashboard list visualization to display a list of important dashboards that you want to track.
|
||||
|
||||
## Configure a dashboard list visualization
|
||||
|
||||
Once you’ve created a [dashboard](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/create-dashboard/), the following video shows you how to configure a dashboard list visualization:
|
||||
|
||||
{{< youtube id="MserjWGWsh8" >}}
|
||||
|
||||
{{< docs/play title="Dashboard List Visualization" url="https://play.grafana.org/d/fdlojrg7daebka/" >}}
|
||||
|
||||
## Panel options
|
||||
|
||||
{{< docs/shared lookup="visualizations/panel-options.md" source="grafana" version="<GRAFANA_VERSION>" >}}
|
||||
|
||||
## Options
|
||||
## Dashboard list options
|
||||
|
||||
Use these options to refine your visualization.
|
||||
Use the following options to refine your dashboard list visualization.
|
||||
|
||||
- **Include current time range -** Select this option to propagate the time range of the current dashboard to the dashboard links. When the user clicks a link, the linked dashboard opens with the indicated time range already set.
|
||||
- **Include current template variable values -** Select this option to include template variables currently used as query parameters in a link. When the user clicks the link, any matching templates in the linked dashboard are set to the values from the link. Learn more about [Dashboard URL variables](ref:dashboard-url-variables).
|
||||
- **Starred -** Display starred dashboards in alphabetical order.
|
||||
- **Recently viewed -** Display recently viewed dashboards in alphabetical order.
|
||||
- **Search -** Display dashboards by search query or tags. You must enter at least one value in **Query** or **Tags**. For the **Query** and **Tags** fields. Variable interpolation is supported, for example,`$my_var` or `${my_var}`.
|
||||
- **Show headings -** The chosen list selection (Starred, Recently viewed, Search) is shown as a heading.
|
||||
- **Max items -** Sets the maximum number of items to list per section. For example, if you left this at the default value of 10 and displayed Starred and Recently viewed dashboards, then the panel would display up to 20 total dashboards, ten in each section.
|
||||
### Include current time range
|
||||
|
||||
## Search
|
||||
Select this option to propagate the time range of the current dashboard to the dashboard links. When you click a link, the linked dashboard opens with the indicated time range already set.
|
||||
|
||||
### Include current template variable values
|
||||
|
||||
Select this option to include template variables currently used as query parameters in a link. When you click the link, any matching templates in the linked dashboard are set to the values from the link. Learn more in [Dashboard URL variables](ref:dashboard-url-variables).
|
||||
|
||||
### Starred
|
||||
|
||||
Display starred dashboards in alphabetical order.
|
||||
|
||||
### Recently viewed
|
||||
|
||||
Display recently viewed dashboards in alphabetical order.
|
||||
|
||||
### Search
|
||||
|
||||
Display dashboards by search query or tags. You must enter at least one value in **Query** or **Tags**. For the **Query** and **Tags** fields, variable interpolation is supported. For example, `$my_var` or `${my_var}`.
|
||||
|
||||
### Show headings
|
||||
|
||||
The selected list section (**Starred**, **Recently viewed**, **Search**) is shown as a heading.
|
||||
|
||||
### Max items
|
||||
|
||||
Sets the maximum number of items to list per section. For example, if you leave this at the default value of 10 and select **Starred** and **Recently viewed** dashboards, then the panel displays up to 20 total dashboards, 10 in each section.
|
||||
|
||||
## Search options
|
||||
|
||||
These options only apply if the **Search** option is selected.
|
||||
|
||||
- **Query -** Enter the query you want to search by. Queries are case-insensitive, and partial values are accepted.
|
||||
- **Folder -** Select the dashboard folders that you want to display.
|
||||
- **Tags -** Here is where you enter your tags you want to search by. Note that existing tags will not appear as you type, and they _are_ case sensitive.
|
||||
### Query
|
||||
|
||||
Enter the query by which you want to search. Queries are case-insensitive and partial values are accepted.
|
||||
|
||||
### Folder
|
||||
|
||||
Select the dashboard folders that you want to display.
|
||||
|
||||
### Tags
|
||||
|
||||
Enter tags by which you want to search. Note that existing tags don't appear as you type, and they _are_ case sensitive.
|
||||
|
||||
> **Note:** When multiple tags and strings appear, the dashboard list displays those matching _all_ conditions.
|
||||
|
||||
@ -23,12 +23,6 @@ Flame graphs let you visualize [profiling](https://grafana.com/docs/pyroscope/la
|
||||
|
||||
For example, if you want to understand which parts of a program consume the most resources, such as CPU time, memory, or I/O operations, you can use a flame graph to visualize and analyze where potential performance issues are:
|
||||
|
||||
## Panel options
|
||||
|
||||
{{< docs/shared lookup="visualizations/panel-options.md" source="grafana" version="<GRAFANA_VERSION>" >}}
|
||||
|
||||
## Flame graph mode
|
||||
|
||||
{{< figure src="/static/img/docs/flame-graph-panel/flame-graph-dark-mode.png" max-width="1025px" alt="A flame graph visualization for a system profile with both flame graph and top table mode." >}}
|
||||
|
||||
You can use a flame graph visualization if you need to:
|
||||
@ -75,6 +69,10 @@ The following table is an example of the type of data you need for a flame graph
|
||||
| 4 | 1.13 Bil | 1.13 K | compress/gzip.(\*Writer).Write |
|
||||
| 5 | 1.06 Bil | 1.06 K | compress/flat.(\*compressor).write |
|
||||
|
||||
## Panel options
|
||||
|
||||
{{< docs/shared lookup="visualizations/panel-options.md" source="grafana" version="<GRAFANA_VERSION>" >}}
|
||||
|
||||
## Modes
|
||||
|
||||
### Flame graph mode
|
||||
|
||||
@ -48,7 +48,11 @@ Use a text visualization when you need to:
|
||||
|
||||
{{< docs/shared lookup="visualizations/panel-options.md" source="grafana" version="<GRAFANA_VERSION>" >}}
|
||||
|
||||
## Mode
|
||||
## Text options
|
||||
|
||||
Use the following options to refine your text visualization.
|
||||
|
||||
### Mode
|
||||
|
||||
**Mode** determines how embedded content appears.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user