2022-05-26 10:06:25 -05:00
---
aliases:
2022-12-09 10:36:04 -06:00
- ../guides/getting_started/
- ../guides/gettingstarted/
- getting-started/
2022-05-26 10:06:25 -05: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 03:10:12 -05:00
labels:
products:
- enterprise
- oss
2022-05-26 10:06:25 -05:00
title: Build your first dashboard
weight: 200
---
2015-03-10 02:55:42 -05:00
2022-05-25 08:19:36 -05:00
# Build your first dashboard
2017-02-07 00:48:01 -06:00
2023-05-18 09:50:20 -05: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 ]({{< relref "../introduction" >}} ).
2015-03-10 02:55:42 -05:00
2023-05-22 15:45:28 -05: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-14 10:24:22 -06:00
2022-05-25 08:19:36 -05:00
#### Install Grafana
2018-08-14 06:21:52 -05:00
2023-05-18 09:50:20 -05: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 ]({{< relref "../setup-grafana/installation" >}} ).
2018-08-23 10:39:39 -05:00
2022-05-25 08:19:36 -05:00
#### Sign in to Grafana
2020-02-26 12:39:47 -06:00
2022-05-25 08:19:36 -05:00
To sign in to Grafana for the first time:
2020-02-26 12:39:47 -06:00
2022-07-27 08:44:18 -05: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.
1. On the sign-in page, enter `admin` for the username and password.
1. Click **Sign in** .
If successful, you will see a prompt to change the password.
2022-05-25 08:19:36 -05:00
1. Click **OK** on the prompt and change your password.
2020-02-26 12:39:47 -06:00
2023-05-22 15:45:28 -05:00
{{% admonition type="note" %}}
We strongly recommend that you change the default administrator password.
{{% /admonition %}}
2020-02-26 12:39:47 -06:00
2022-05-25 08:19:36 -05:00
#### Create a dashboard
2020-02-26 12:39:47 -06:00
2023-05-18 09:50:20 -05:00
If you've already set up a data source that you know how to query, refer to [Create a dashboard ]({{< relref "../dashboards/build-dashboards/create-dashboard" >}} ) instead.
2023-05-03 12:49:31 -05:00
2023-06-05 13:45:36 -05:00
To create your first dashboard using the built-in `-- Grafana --` data source:
2018-08-14 06:21:52 -05:00
2023-03-17 11:12:40 -05:00
1. Click **Dashboards** in the left-side menu.
2023-04-03 10:33:55 -05:00
1. On the Dashboards page, click **New** and select **New Dashboard** from the dropdown menu.
1. On the dashboard, click ** + Add visualization**.
2023-05-08 13:24:23 -05:00

2023-06-05 13:45:36 -05:00
1. In the modal that opens, click `-- Grafana --` :
2022-07-27 08:44:18 -05:00
2023-06-05 13:45:36 -05:00
{{< figure class = "float-right" src = "/media/docs/grafana/dashboards/screenshot-data-source-selector-10.0.png" max-width = "800px" alt = "Select data source modal" > }}
This configures your [query ]({{< relref "../panels-visualizations/query-transform-data#add-a-query" >}} ) and generates the Random Walk dashboard.
2022-07-27 08:44:18 -05:00
2023-05-03 12:49:31 -05:00
1. Click the Refresh dashboard icon to query the data source.

1. When you've finished editing your panel, click **Save** to save the dashboard.
Alternatively, click **Apply** if you want to see your changes applied to the dashboard first. Then click the save icon in the dashboard header.
2023-04-03 10:33:55 -05:00
1. Add a descriptive name for the dashboard, and then click **Save** .
2020-10-22 17:14:30 -05:00
2021-08-06 08:52:36 -05:00
Congratulations, you have created your first dashboard and it is displaying results.
2018-08-14 06:21:52 -05:00
2022-05-25 08:19:36 -05:00
#### Next steps
2018-08-14 06:21:52 -05:00
2023-05-18 09:50:20 -05:00
Continue to experiment with what you have built, try the [explore workflow ]({{< relref "../explore" >}} ) or another visualization feature. Refer to [Data sources ]({{< relref "../datasources" >}} ) for a list of supported data sources and instructions on how to [add a data source ]({{< relref "../administration/data-source-management#add-a-data-source" >}} ). The following topics will be of interest to you:
2018-08-14 06:21:52 -05:00
2023-05-18 09:50:20 -05:00
- [Panels and visualizations ]({{< relref "../panels-visualizations" >}} )
- [Dashboards ]({{< relref "../dashboards" >}} )
- [Keyboard shortcuts ]({{< relref "../dashboards/use-dashboards#keyboard-shortcuts" >}} )
- [Plugins ](/grafana/plugins?orderBy=weight&direction=asc )
2018-08-14 06:21:52 -05:00
2022-05-25 08:19:36 -05:00
##### Admins
2018-08-14 06:21:52 -05:00
2020-10-22 17:14:30 -05:00
The following topics are of interest to Grafana server admin users:
2018-08-14 06:21:52 -05:00
2023-05-18 09:50:20 -05:00
- [Grafana configuration ]({{< relref "../setup-grafana/configure-grafana" >}} )
- [Authentication ]({{< relref "../setup-grafana/configure-security/configure-authentication" >}} )
- [User permissions and roles ]({{< relref "../administration/roles-and-permissions" >}} )
- [Provisioning ]({{< relref "../administration/provisioning" >}} )
- [Grafana CLI ]({{< relref "../cli" >}} )