opensource/grafana
1
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-08-03 01:56:56 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: slight update to grafana fundamentals (#84287)

Browse Source
This commit is contained in:
Marie Cruz
2024-03-12 14:23:45 +00:00
committed by GitHub
parent d69b19e431
commit 90ff576cb7
1 changed files with 9 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
docs/sources/tutorials/grafana-fundamentals/index.md
View File

@ -47,7 +47,9 @@ Alternatively, you can also watch our Grafana for Beginners series where we disc
This tutorial uses a sample application to demonstrate some of the features in Grafana. To complete the exercises in this tutorial, you need to download the files to your local machine.
In this step, you'll set up the sample application, as well as supporting services, such as [Prometheus](https://prometheus.io/) and [Loki](/oss/loki/).
In this step, you'll set up the sample application, as well as supporting services, such as [Loki](/oss/loki/).
> **Note:** [Prometheus](https://prometheus.io/), a popular time series database (TSDB), has already been configured as a data source as part of this tutorial.
1. Clone the [github.com/grafana/tutorial-environment](https://github.com/grafana/tutorial-environment) repository.
@ -103,47 +105,13 @@ To add a link:
To vote for a link, click the triangle icon next to the name of the link.
## Log in to Grafana
Grafana is an open-source platform for monitoring and observability that lets you visualize and explore the state of your systems.
1. Open a new tab.
1. Browse to [localhost:3000](http://localhost:3000).
1. In **email or username**, enter **admin**.
1. In **password**, enter **admin**.
1. Click **Log In**.
The first time you log in, you're asked to change your password:
1. In **New password**, enter your new password.
1. In **Confirm new password**, enter the same password.
1. Click **Save**.
The first thing you see is the Home dashboard, which helps you get started.
In the top left corner, you can see the menu icon. Clicking it will open the _sidebar_, the main menu for navigating Grafana.
## Add a metrics data source
The sample application exposes metrics which are stored in [Prometheus](https://prometheus.io/), a popular time series database (TSDB).
To be able to visualize the metrics from Prometheus, you first need to add it as a data source in Grafana.
1. In the sidebar, click **Connections** and then **Data sources**.
1. Click **Add data source**.
1. In the list of data sources, click **Prometheus**.
1. In the URL box, enter **http\://prometheus:9090**.
1. Scroll to the bottom of the page and click **Save & test**.
You should see the message "Successfully queried the Prometheus API." This means Prometheus is now available as a data source in Grafana.
## Explore your metrics
Grafana Explore is a workflow for troubleshooting and data exploration. In this step, you'll be using Explore to create ad-hoc queries to understand the metrics exposed by the sample application.
> Ad-hoc queries are queries that are made interactively, with the purpose of exploring data. An ad-hoc query is commonly followed by another, more specific query.
1. Click the menu icon and, in the sidebar, click **Explore**. A dropdown menu for the list of available data sources is on the upper-left side. The Prometheus data source that you added will already be selected. If not, choose Prometheus.
1. Click the menu icon and, in the sidebar, click **Explore**. A dropdown menu for the list of available data sources is on the upper-left side. The Prometheus data source will already be selected. If not, choose Prometheus.
1. Confirm that you're in code mode by checking the **Builder/Code** toggle at the top right corner of the query panel.
1. In the query editor, where it says _Enter a PromQL query…_, enter `tns_request_duration_seconds_count` and then press Shift + Enter.
A graph appears.
@ -386,7 +354,11 @@ Once the query `sum(rate(tns_request_duration_seconds_count[5m])) by(route)` ret
### Display Grafana Alerts to your dashboard
In most cases, it's also valuable to display Grafana Alerts as annotations to your dashboard. Let's see how we can configure this.
In most cases, it's also valuable to display Grafana Alerts as annotations to your dashboard. Check out the video tutorial below to learn how to display alerting to your dashboard.
{{< youtube id="ClLp-iSoaSY" >}}
Let's see how we can configure this.
1. In Grafana's sidebar, hover over the **Alerting** (bell) icon and then click **Alert rules**.
1. Expand the `fundamentals > fundamentals` folder to view our created alert rule.