opensource/grafana
1
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-08-03 02:32:19 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
grafana/docs/sources/dashboards/build-dashboards/create-dashboard/index.md
Christopher Moyer 414d536186 Docs: refactors config panels and visualizations, corrects relrefs (#55940) 
* refactors config panels and visualizations, corrects relrefs

* adds an alias

* Remove some old content

* moves visualizations topic to the root

* moves out panels and visualization topics to the root

* adds move and resize panel to add/organize panel; creates a create dashboard topic under build dashboards; adjusts context of add a panel to be from within an existing dashboard

* updates aliases

* creates search at root, moves dashboard preview to search, creates standalone search dashboard topic

* moves Set dashboard time range to use-dashboards, creates modify dashboard settings and adds moves Modify dashboard time settings to that topic

* moves existing query-options topic from working with panels to configure-panel-visualizations, moves panel time overrides and timeshift content to query options

* Moving things to better category, fixing links, improving ordering

* Move panel inspector to main panel topic

* completes partial fix of relrefs

* relref fixes con't

* restructures remaining panels topics

* more relref fixes

* Minor fix

* Minor tweak

* finishes fixing relrefs

Co-authored-by: Torkel Ödegaard <torkel@grafana.com>
Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
2022-10-11 15:31:20 -05:00

4.1 KiB
Raw Blame History

aliases title menuTitle weight keywords
/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/
/docs/grafana/latest/dashboards/build-dashboards/add-organize-panels/
Create a dashboard Create a dashboard 1
panel
dashboard
create

Create a dashboard

Dashboards and panels allow you to show your data in visual form. Each panel needs at least one query to display a visualization.

Before you begin:

  • Ensure that you have the proper permissions. For more information about permissions, refer to [About users and permissions]({{< relref "../../../administration/roles-and-permissions/" >}}).
  • Identify the dashboard to which you want to add the panel.
  • Understand the query language of the target data source.
  • Ensure that data source for which you are writing a query has been added. For more information about adding a data source, refer to [Add a data source]({{< relref "../../../datasources/add-a-data-source/" >}}) if you need instructions.

To create a dashboard:

  1. Sign in to Grafana, hover your cursor over Dashboard, and click + New Dashboard.

  2. Click Add a new panel.

  3. In the first line of the Query tab, click the drop-down list and select a data source.

  4. Write or construct a query in the query language of your data source.

    For more information about data sources, refer to [Data sources]({{< relref "../../../datasources/" >}}) for specific guidelines.

  5. In the Visualization list, select a visualization type.

    Grafana displays a preview of your query results with the visualization applied.

    For more information about individual visualizations, refer to [Visualizations options]({{< relref "../../../panels-visualizations/visualizations/" >}}).

  6. Refer to the following documentation for ways you can adjust panel settings.

    While not required, most visualizations need some adjustment before they properly display the information that you need.

    • [Configure value mappings]({{< relref "../../../panels-visualizations/configure-value-mappings" >}})
    • [Visualization-specific options]({{< relref "../../../panels-visualizations/visualizations/" >}})
    • [Override field values]({{< relref "../../../panels-visualizations/configure-overrides/" >}})
    • [Configure thresholds]({{< relref "../../../panels-visualizations/configure-thresholds/" >}})
    • [Configure standard options]({{< relref "../../../panels-visualizations/configure-standard-options/" >}})

  7. Add a note to describe the visualization (or describe your changes) and then click Save in the upper-right corner of the page.

    Notes can be helpful if you need to revert the dashboard to a previous version.

Configure repeating rows

You can configure Grafana to dynamically add panels or rows to a dashboard based on the value of a variable. Variables dynamically change your queries across all rows in a dashboard. For more information about repeating panels, refer to Configure repeating panels.

To see an example of repeating rows, refer to Dashboard with repeating rows. The example shows that you can also repeat rows if you have variables set with Multi-value or Include all values selected.

Before you begin:

  • Ensure that the query includes a multi-value variable.

To configure repeating rows:

  1. On the dashboard home page, click Add panel.

  2. On the Add a panel dialog box, click Add a new row.

  3. Hover over the row title and click the cog icon.

  4. On the Row Options dialog box, add a title and select the variable for which you want to add repeating rows.

Note: To provide context to dashboard users, add the variable to the row title.

Move a panel

You can place a panel on a dashboard in any location.

  1. Open the dashboard.

  2. Click the panel title and drag the panel to the new location.

Resize a panel

You can size a dashboard panel to suits your needs.

  1. Open the dashboard.

  2. To adjust the size of the panel, click and drag the lower-right corner of the panel.