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
2025-04-09 22:02:51 +08:00
{{< admonition type = "note" > }}
2023-05-23 04:45:28 +08:00
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.
2025-04-09 22:02:51 +08:00
{{< / 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/ )