grafana/docs/sources/getting-started/getting-started.md
Christopher Moyer 46360ca0c3
Docs: refactored manage users and permissions content (#44343)
* initial refactor

* initial draft for teams

* restructed topics, added front matter

* modified aliases

* removes old files

* removed files

* initial refactor

* initial draft for teams

* restructed topics, added front matter

* modified aliases

* removes old files

* removed files

* final xrefs updates

* xref adjustment

* copy updates

* copy and content updates to about, add to org, add user, admin

* copy updates to remove user from org

* update org vs server admin section names, cross-link

* cross-link add and invite users to org

* add remaining cross-links between org and server admin

* add dashboard permissions table

* add permissions information to teams

* add copy invite instructions to invite management

* tweaks and link updates

* incorporated PM feedback

* fixed xrefs

* yarn prettier

* fix codespell

* combined teams and dashboard permissions content

Co-authored-by: Mitchel Seaman <mitchel.seaman@gmail.com>
2022-02-15 13:20:45 -06:00

3.3 KiB

+++ title = "With Grafana" description = "Guide for getting started with Grafana" keywords = ["grafana", "intro", "guide", "started"] aliases = ["/docs/grafana/latest/guides/gettingstarted","/docs/grafana/latest/guides/getting_started"] weight = 200 +++

Getting started with Grafana

This topic helps you get started with Grafana and build your first dashboard. To learn more about Grafana, refer to [What is Grafana?]({{< relref "_index.md" >}}).

Note: Grafana also offers a free account with Grafana Cloud to help getting started even easier and faster. You can install Grafana to self-host or get a free Grafana Cloud account.

Step 1: Install Grafana

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 "../installation/_index.md" >}}).

Step 2: Log in

To log in to Grafana for the first time:

  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.
  2. On the login page, enter admin for username and password.
  3. Click Log in. If login is successful, then you will see a prompt to change the password.
  4. Click OK on the prompt, then change your password.

Note: We strongly recommend that you follow Grafana's best practices and change the default administrator password. Don't forget to record your credentials!

Step 3: Create a dashboard

To create your first dashboard:

  1. Click the + icon on the side menu.
  2. On the dashboard, click Add an empty panel.
  3. In the New dashboard/Edit panel view, go to the Query tab.
  4. Configure your [query]({{< relref "../panels/query-a-data-source/add-a-query" >}}) by selecting -- Grafana -- from the data source selector. This generates the Random Walk dashboard.
  5. Click the Save icon in the top right corner of your screen to save the dashboard.
  6. Add a descriptive name, and then click Save.

Congratulations, you have created your first dashboard and it is displaying results.

Next steps

Continue to experiment with what you have built, try the [explore workflow]({{< relref "../explore/_index.md" >}}) 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 "../datasources/add-a-data-source.md" >}}). The following topics will be of interest to you:

  • [Panels]({{< relref "../panels/_index.md" >}})
  • [Dashboards]({{< relref "../dashboards/_index.md" >}})
  • [Keyboard shortcuts]({{< relref "../dashboards/shortcuts.md" >}})
  • Plugins

Admins

The following topics are of interest to Grafana server admin users:

  • [Grafana configuration]({{< relref "../administration/configuration.md" >}})
  • [Authentication]({{< relref "../auth/overview.md" >}})
  • [User permissions and roles]({{< relref "../administration/manage-users-and-permissions/about-users-and-permissions.md" >}})
  • [Provisioning]({{< relref "../administration/provisioning.md" >}})
  • [Grafana CLI]({{< relref "../administration/cli.md" >}})