{{<figuresrc="/static/img/docs/enterprise/dashboard_insights_stats.png"max-width="400px"class="docs-image--no-shadow"alt="Stats tab">}}{{<figuresrc="/static/img/docs/enterprise/dashboard_insights_users.png"max-width="400px"class="docs-image--no-shadow"alt="Users and activity tab">}}
{{<figuresrc="/media/docs/grafana/dashboards/screenshot-data-source-insights-9.5.png"max-width="650px"class="docs-image--no-shadow"alt="Insights tab for a data source">}}
## Presence indicator
@ -89,7 +89,7 @@ When you are signed in and looking at a dashboard, you can know who is looking a
When there are more active users on a dashboard than can fit within the presence indicator, click the **+X** icon. Doing so opens [dashboard insights](#dashboard-and-data-source-insights), which contains more details about recent user activity.
{{<figuresrc="/media/docs/grafana/dashboards/screenshot-dashboard-sort-9.5.png"max-width="650px"class="docs-image--no-shadow"alt="Open list of dashboard sort options">}}
Annotations provide a way to mark points on a visualization with rich events. They are visualized as vertical lines and icons on all graph panels. When you hover over an annotation, you can get event description and event tags. The text field can include links to other systems with more detail.
{{<figuresrc="/static/img/docs/v46/annotations.png"max-width="800px"alt="Annotated visualization with annotation context menu open">}}
You can annotate visualizations in three ways:
@ -148,21 +148,21 @@ Grafana v8.1 and later versions also support typeahead of existing tags, provide
For example, create an annotation query name `outages` and specify a tag `outage`. This query will show all annotations (from any dashboard or via API) with the `outage` tag. If multiple tags are defined in an annotation query, then Grafana will only show annotations matching all the tags. To modify the behavior, enable `Match any`, and Grafana will show annotations that contain any one of the tags you provided.
You can also use template variables in the tag query. This means if you have a dashboard showing stats for different services and a template variable that dictates which services to show, you can use the same template variable in your annotation query to only show annotations for those services.
{{<figuresrc="/media/docs/grafana/dashboards/screenshot-annotation-tag-filter-variable-10.0.png"max-width="600px"alt="Annotation query options with a template variable query tag">}}
### Add time regions
When adding or editing an annotation, you can define a repeating time region by setting **Query type** to **Time regions**. Then, define the **From** and **To** sections with the preferred days of the week and time. You also have the option to change the timezone, which is set to the dashboard's timezone, by default.
{{<figuresrc="/media/docs/grafana/dashboards/screenshot-annotation-timeregions-10-v2.png"max-width="600px"caption="Time regions business hours">}}
{{<figuresrc="/media/docs/grafana/dashboards/screenshot-annotation-timeregions-10-v2.png"max-width="600px"alt="Time regions options set to business hours">}}
The above configuration will produce the following result in the Time series panel:
{{<figuresrc="/media/docs/grafana/screenshot-grafana-10-0-timeseries-time-regions.png"max-width="600px"caption="Time series time regions business hours">}}
{{<figuresrc="/media/docs/grafana/screenshot-grafana-10-0-timeseries-time-regions.png"max-width="600px"alt="Time series visualization with time regions business hours">}}
{{<figuresrc="/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.
@ -41,7 +41,7 @@ Once created, you can modify the library panel using any dashboard on which it a
You can also create a library panel directly from the edit menu of any panel.
{{<figuresrc="/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
@ -77,7 +77,7 @@ You can view a list of available library panels and search for a library panel.
1. Click **Library panels**.
You can see a list of previously defined library panels.
{{<figuresrc="/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.
Any changes you make to a dashboard used in a report are reflected the next time the report is sent. For example, if you change the time range in the dashboard, then the time range in the report also changes, unless you've configured a custom time range.
For information about recent improvements to the reporting UI, refer to [Grafana reporting: How we improved the UX in Grafana](https://grafana.com/blog/2022/06/29/grafana-reporting-how-we-improved-the-ux-in-grafana/).
@ -121,12 +117,12 @@ If the time zone is set differently between your Grafana server and its remote i
> We're actively developing new report layout options. [Contact us](https://grafana.com/contact?about=grafana-enterprise&topic=design-process&value=reporting) to get involved in the design process.
| Simple | Portrait | v6.4+ | Generates an A4 page in portrait mode with three panels per page. | {{<figuresrc="/static/img/docs/enterprise/reports_portrait_preview.png"max-width="500px"max-height="500px"class="docs-image--no-shadow">}} |
| Simple | Landscape | v6.7+ | Generates an A4 page in landscape mode with a single panel per page. | {{<figuresrc="/static/img/docs/enterprise/reports_landscape_preview.png"max-width="500px"class="docs-image--no-shadow">}} |
| Grid | Portrait | v7.2+ | Generates an A4 page in portrait mode with panels arranged in the same way as at the original dashboard. | {{<figuresrc="/static/img/docs/enterprise/reports_grid_portrait_preview.png"max-width="500px"max-height="500px"class="docs-image--no-shadow">}} |
| Grid | Landscape | v7.2+ | Generates an A4 page in landscape mode with panels arranged in the same way as in the original dashboard. | {{<figuresrc="/static/img/docs/enterprise/reports_grid_landscape_preview.png"max-width="500px"class="docs-image--no-shadow">}} |
| Simple | Portrait | v6.4+ | Generates an A4 page in portrait mode with three panels per page. | {{<figuresrc="/static/img/docs/enterprise/reports_portrait_preview.png"max-width="500px"max-height="500px"class="docs-image--no-shadow"alt="Simple layout in portrait">}} |
| Simple | Landscape | v6.7+ | Generates an A4 page in landscape mode with a single panel per page. | {{<figuresrc="/static/img/docs/enterprise/reports_landscape_preview.png"max-width="500px"class="docs-image--no-shadow"alt="Simple layout in landscape">}} |
| Grid | Portrait | v7.2+ | Generates an A4 page in portrait mode with panels arranged in the same way as at the original dashboard. | {{<figuresrc="/static/img/docs/enterprise/reports_grid_portrait_preview.png"max-width="500px"max-height="500px"class="docs-image--no-shadow"alt="Grid layout in portrait">}} |
| Grid | Landscape | v7.2+ | Generates an A4 page in landscape mode with panels arranged in the same way as in the original dashboard. | {{<figuresrc="/static/img/docs/enterprise/reports_grid_landscape_preview.png"max-width="500px"class="docs-image--no-shadow"alt="Grid layout in landscape">}} |
The import process enables you to change the name of the dashboard, pick the data source you want the dashboard to use, and specify any metric prefixes (if the dashboard uses any).
### Discover dashboards on grafana.com
Find dashboards for common server applications at [Grafana.com/dashboards](https://grafana.com/dashboards).
{{<figuresrc="/static/img/docs/troubleshooting/grafana_null_connected.png"max-width="1200px"alt="Graph with null values connected">}}
In this graph, we set graph to show bars instead of lines and set the **No value** under **Standard options** to **0**. There is a very big difference in the visuals.
{{<figuresrc="/static/img/docs/v50/variables_dashboard.png"alt="Variable drop-down open and two values selected">}}
These can be especially useful for administrators who want to allow Grafana viewers to quickly adjust visualizations but do not want to give them full editing permissions. Grafana Viewers can use variables.
@ -109,7 +109,7 @@ You can use variables in data links to send people to a detailed dashboard with
When creating or updating a data link, press Cmd+Space or Ctrl+Space on your keyboard to open the typeahead suggestions to more easily add variables to your URL.
| {{<figuresrc="/static/img/docs/queries/query-editor-help-7-4.png"class="docs-image--no-shadow"max-width="30px"max-height="30px">}} | Toggles query editor help. If supported by the data source, click this icon to display information on how to use the query editor or provide quick access to common queries. |
| {{<figuresrc="/static/img/docs/queries/duplicate-query-icon-7-0.png"class="docs-image--no-shadow"max-width="30px"max-height="30px">}} | Copies a query. Duplicating queries is useful when working with multiple complex queries that are similar and you want to either experiment with different variants or do minor alterations. |
| {{<figuresrc="/static/img/docs/queries/hide-query-icon-7-0.png"class="docs-image--no-shadow"max-width="30px"max-height="30px">}} | Hides a query. Grafana does not send hidden queries to the data source. |
| {{<figuresrc="/static/img/docs/queries/remove-query-icon-7-0.png"class="docs-image--no-shadow"max-width="30px"max-height="30px">}} | Removes a query. Removing a query permanently deletes it, but sometimes you can recover deleted queries by reverting to previously saved versions of the panel. |
| {{<figuresrc="/static/img/docs/queries/query-drag-icon-7-2.png"class="docs-image--no-shadow"max-width="30px"max-height="30px">}} | Reorders queries. Change the order of queries by clicking and holding the drag icon, then drag queries where desired. The order of results reflects the order of the queries, so you can often adjust your visual results based on query order. |
| {{<figuresrc="/static/img/docs/queries/query-editor-help-7-4.png"class="docs-image--no-shadow"max-width="30px"max-height="30px"alt="Help icon">}} | Toggles query editor help. If supported by the data source, click this icon to display information on how to use the query editor or provide quick access to common queries. |
| {{<figuresrc="/static/img/docs/queries/duplicate-query-icon-7-0.png"class="docs-image--no-shadow"max-width="30px"max-height="30px"alt="Duplicate icon">}} | Copies a query. Duplicating queries is useful when working with multiple complex queries that are similar and you want to either experiment with different variants or do minor alterations. |
| {{<figuresrc="/static/img/docs/queries/hide-query-icon-7-0.png"class="docs-image--no-shadow"max-width="30px"max-height="30px"alt="Hide icon">}} | Hides a query. Grafana does not send hidden queries to the data source. |
| {{<figuresrc="/static/img/docs/queries/remove-query-icon-7-0.png"class="docs-image--no-shadow"max-width="30px"max-height="30px"alt="Remove icon">}} | Removes a query. Removing a query permanently deletes it, but sometimes you can recover deleted queries by reverting to previously saved versions of the panel. |
| {{<figuresrc="/static/img/docs/queries/query-drag-icon-7-2.png"class="docs-image--no-shadow"max-width="30px"max-height="30px"alt="Drag icon">}} | Reorders queries. Change the order of queries by clicking and holding the drag icon, then drag queries where desired. The order of results reflects the order of the queries, so you can often adjust your visual results based on query order. |
## Query options
Click **Query options** next to the data source selector to see settings for the selected data source.
Changes you make here affect only queries made in this panel.
Use alert lists to display your alerts. You can configure the list to show the current state. You can read more about alerts in [Grafana Alerting overview][].
Dashboard lists allow you to display dynamic links to other dashboards. The list can be configured to use starred dashboards, recently viewed dashboards, a search query, and dashboard tags.
- **Never:** Time series data points in the the data are never disconnected.
- **Threshold:** Specify a threshold above which values in the data are disconnected. This can be useful when desired values in the data are of a known size and/or within a known range, and values outside this range should no longer be connected.
@ -132,7 +132,7 @@ A new layout option is available when rendering reports: the grid layout. With t
The grid layout is also available for the [Export dashboard as PDF]({{< relref "../dashboards/share-dashboards-panels#export-dashboard-as-pdf" >}}) feature.
{{<figuresrc="/static/img/docs/enterprise/reports_grid_landscape_preview.png"max-width="500px"class="docs-image--no-shadow"alt="Report in grid layout">}}
@ -169,7 +169,7 @@ Many thanks to [mtanda](https://github.com/mtanda) this contribution!
Google Cloud Monitoring data source ships with pre-configured dashboards for some of the most popular GCP services. These curated dashboards are based on similar dashboards in the GCP dashboard samples repository. In this release, we have expanded the set of pre-configured dashboards.
If you want to customize a dashboard, we recommend that you save it under a different name. Otherwise the dashboard will be overwritten when a new version of the dashboard is released.
Isabel
1 year ago
committed by