2022-05-26 23:06:25 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								---
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								aliases:
							 
						 
					
						
							
								
									
										
										
										
											2022-12-10 00:36:04 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								  -  ../guides/getting_started/
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								  -  ../guides/gettingstarted/
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								  -  getting-started/
							 
						 
					
						
							
								
									
										
										
										
											2022-05-26 23:06:25 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								description: Learn how to get started with Grafana by adding a preconfigured dashboard.
							 
						 
					
						
							
								
									
										
											 
										
											
												Explicitly set all front matter labels in the source files (#71548)
* Set every page to have defaults of 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration pages to have of 'Cloud', 'Enterprise', and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/enterprise-licensing pages to have 'Enterprise' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/organization-management pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/provisioning pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/recorded-queries pages to have labels cloud,enterprise
* Set administration/roles-and-permissions/access-control pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/stats-and-license pages to have labels cloud,enterprise
* Set alerting pages to have labels cloud,enterprise,oss
* Set breaking-changes pages to have labels cloud,enterprise,oss
* Set dashboards pages to have labels cloud,enterprise,oss
* Set datasources pages to have labels cloud,enterprise,oss
* Set explore pages to have labels cloud,enterprise,oss
* Set fundamentals pages to have labels cloud,enterprise,oss
* Set introduction/grafana-cloud pages to have labels cloud
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Fix introduction pages products
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set panels-visualizations pages to have labels cloud,enterprise,oss
* Set release-notes pages to have labels cloud,enterprise,oss
* Set search pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/audit-grafana pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-authentication pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/configure-authentication/enhanced-ldap pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-authentication/saml pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-database-encryption/encrypt-secrets-using-hashicorp-key-vault pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-request-security pages to have labels cloud,enterprise,oss
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-team-sync pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/export-logs pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set troubleshooting pages to have labels cloud,enterprise,oss
* Set whatsnew pages to have labels cloud,enterprise,oss
* Apply updated labels from review
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
---------
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
											 
										 
										
											2023-07-18 16:10:12 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								labels:
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								  products:
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								    -  enterprise
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								    -  oss
							 
						 
					
						
							
								
									
										
										
										
											2022-05-26 23:06:25 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								title: Build your first dashboard
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								weight: 200
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								---
							 
						 
					
						
							
								
									
										
										
										
											2015-03-10 15:55:42 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								# Build your first dashboard
  
						 
					
						
							
								
									
										
										
										
											2017-02-07 14:48:01 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								This topic helps you get started with Grafana and build your first dashboard using the built-in `Grafana`  data source. To learn more about Grafana, refer to [Introduction to Grafana ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/introduction/ ).
							 
						 
					
						
							
								
									
										
										
										
											2015-03-10 15:55:42 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2023-05-23 04:45:28 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								{{% admonition type="note" %}}
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								Grafana also offers a [free account with Grafana Cloud ](/signup/cloud/connect-account?pg=gsdocs ) to help getting started even easier and faster. You can install Grafana to self-host or get a free Grafana Cloud account.
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								{{% /admonition %}}
							 
						 
					
						
							
								
									
										
										
										
											2021-01-15 00:24:22 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								#### Install Grafana
  
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								Grafana can be installed on many different operating systems. For a list of the minimum hardware and software requirements, as well as instructions on installing Grafana, refer to [Install Grafana ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/setup-grafana/installation/ ).
							 
						 
					
						
							
								
									
										
										
										
											2018-08-23 23:39:39 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								#### Sign in to Grafana
  
						 
					
						
							
								
									
										
										
										
											2020-02-27 02:39:47 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								To sign in to Grafana for the first time:
							 
						 
					
						
							
								
									
										
										
										
											2020-02-27 02:39:47 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-07-27 21:44:18 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  Open your web browser and go to http://localhost:3000/. 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								   The default HTTP port that Grafana listens to is `3000`  unless you have configured a different port.
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2023-10-10 23:01:13 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  On the sign-in page, enter `admin`  for both the username and password. 
						 
					
						
							
								
									
										
										
										
											2022-07-27 21:44:18 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  Click **Sign in** . 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2023-10-28 01:55:52 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								   If successful, you'll see a prompt to change the password.
							 
						 
					
						
							
								
									
										
										
										
											2022-07-27 21:44:18 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								1.  Click **OK**  on the prompt and change your password. 
						 
					
						
							
								
									
										
										
										
											2020-02-27 02:39:47 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								{{<  admonition  type = "note"  > }}
							 
						 
					
						
							
								
									
										
										
										
											2023-05-23 04:45:28 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								We strongly recommend that you change the default administrator password.
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								{{<  / admonition  > }}
							 
						 
					
						
							
								
									
										
										
										
											2020-02-27 02:39:47 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								#### Create a dashboard
  
						 
					
						
							
								
									
										
										
										
											2020-02-27 02:39:47 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								If you've already set up a data source that you know how to query, refer to [Create a dashboard ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/create-dashboard/ ) instead.
							 
						 
					
						
							
								
									
										
										
										
											2023-05-04 01:49:31 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2023-06-06 02:45:36 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								To create your first dashboard using the built-in `-- Grafana --`  data source:
							 
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  Click **Dashboards**  in the main menu. 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								1.  On the **Dashboards**  page, click **New**  and select **New Dashboard**  from the drop-down menu. 
						 
					
						
							
								
									
										
										
										
											2023-04-03 23:33:55 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  On the dashboard, click ** + Add visualization**. 
						 
					
						
							
								
									
										
										
										
											2023-05-09 02:24:23 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2023-09-06 23:11:58 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								   
							 
						 
					
						
							
								
									
										
										
										
											2023-05-09 02:24:23 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2023-10-28 01:55:52 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  In the dialog box that opens, click `-- Grafana --` : 
						 
					
						
							
								
									
										
										
										
											2022-07-27 21:44:18 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2023-10-28 01:55:52 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								   {{<  figure  class = "float-right"   src = "/media/docs/grafana/dashboards/screenshot-data-source-selector-10.0.png"  max-width = "800px"  alt = "Select data source dialog box"  > }}
							 
						 
					
						
							
								
									
										
										
										
											2023-06-06 02:45:36 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								   This configures your [query ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/panels-visualizations/query-transform-data/#add-a-query ) and generates the Random Walk dashboard.
							 
						 
					
						
							
								
									
										
										
										
											2023-05-04 01:49:31 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  Click **Refresh**  to query the data source. 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								1.  When you've finished editing your panel, click **Save dashboard** . 
						 
					
						
							
								
									
										
										
										
											2023-05-04 01:49:31 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								   Alternatively, click **Back to dashboard**  if you want to see your changes applied to the dashboard first. Then click **Save dashboard**  when you're ready.
							 
						 
					
						
							
								
									
										
										
										
											2023-05-04 01:49:31 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-03-21 22:43:43 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  Add a descriptive title for the dashboard, or have Grafana create one using [generative AI features ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/dashboards/manage-dashboards#set-up-generative-ai-features-for-dashboards ), and then click **Save** . 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								1.  Click **Back to dashboard**  and then **Exit edit** . 
						 
					
						
							
								
									
										
										
										
											2023-10-28 01:55:52 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								Congratulations, you have created your first dashboard and it's displaying results.
							 
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								#### Next steps
  
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								Continue to experiment with what you have built, try the [explore workflow ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/explore/ ) or another visualization feature. Refer to [Data sources ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/datasources/ ) for a list of supported data sources and instructions on how to [add a data source ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/datasources/#add-a-data-source ). The following topics will be of interest to you:
							 
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								-  [Panels and visualizations ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/panels-visualizations/ ) 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								-  [Dashboards ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/dashboards/ ) 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								-  [Keyboard shortcuts ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/dashboards/use-dashboards/#keyboard-shortcuts ) 
						 
					
						
							
								
									
										
										
										
											2023-05-18 22:50:20 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								-  [Plugins ](/grafana/plugins?orderBy=weight&direction=asc ) 
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2022-05-25 21:19:36 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								##### Admins
  
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2020-10-23 06:14:30 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								The following topics are of interest to Grafana server admin users:
							 
						 
					
						
							
								
									
										
										
										
											2018-08-14 19:21:52 +08:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2024-06-20 21:53:21 +08:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								-  [Grafana configuration ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/setup-grafana/configure-grafana/ ) 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								-  [Authentication ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/setup-grafana/configure-security/configure-authentication/ ) 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								-  [User permissions and roles ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/administration/roles-and-permissions/ ) 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								-  [Provisioning ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/administration/provisioning/ ) 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								-  [Grafana CLI ](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/cli/ )