* manually replce all shared relrefs
* relref replace - previous grafana versions
* update test
* prettier
(cherry picked from commit 2cb999c4f3)
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Robby Milo <robbymilo@fastmail.com>
This commit is contained in:
Jack Baldry
co-authored by
Robby Milo
Robby Milo
parent
d4703cc677
commit
8980faf989
@@ -14,6 +14,6 @@ weight: 9
|
||||
|
||||
Grafana helps you collect, correlate, and visualize data with beautiful dashboards — the open source data visualization and monitoring solution that drives informed decisions, enhances system performance, and streamlines troubleshooting.
|
||||
|
||||
This section provides guidance to our open source community about how to build your first dashboard after you have installed Grafana. It also provides step-by-step instructions on how to add a Prometheus, InfluxDB, or an MS SQL Server data source. If you are connecting a different data source, please refer to our complete list of supported [Data sources]({{< relref "../datasources" >}}). If you would like to learn how to get started with Grafana Cloud, our fully managed observability stack, visit the [Grafana Cloud documentation](https://grafana.com/docs/grafana-cloud/quickstart/) for more information.
|
||||
This section provides guidance to our open source community about how to build your first dashboard after you have installed Grafana. It also provides step-by-step instructions on how to add a Prometheus, InfluxDB, or an MS SQL Server data source. If you are connecting a different data source, please refer to our complete list of supported [Data sources](../datasources/). If you would like to learn how to get started with Grafana Cloud, our fully managed observability stack, visit the [Grafana Cloud documentation](https://grafana.com/docs/grafana-cloud/quickstart/) for more information.
|
||||
|
||||
{{< section >}}
|
||||
|
||||
@@ -14,7 +14,7 @@ weight: 200
|
||||
|
||||
# Build your first dashboard
|
||||
|
||||
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" >}}).
|
||||
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](../../introduction/).
|
||||
|
||||
{{% 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.
|
||||
@@ -22,7 +22,7 @@ Grafana also offers a [free account with Grafana Cloud](/signup/cloud/connect-ac
|
||||
|
||||
#### 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 "../setup-grafana/installation" >}}).
|
||||
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](../../setup-grafana/installation/).
|
||||
|
||||
#### Sign in to Grafana
|
||||
|
||||
@@ -45,7 +45,7 @@ We strongly recommend that you change the default administrator password.
|
||||
|
||||
#### Create a dashboard
|
||||
|
||||
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.
|
||||
If you've already set up a data source that you know how to query, refer to [Create a dashboard](../../dashboards/build-dashboards/create-dashboard/) instead.
|
||||
|
||||
To create your first dashboard using the built-in `-- Grafana --` data source:
|
||||
|
||||
@@ -59,7 +59,7 @@ To create your first dashboard using the built-in `-- Grafana --` data source:
|
||||
|
||||
{{< 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" >}}
|
||||
|
||||
This configures your [query]({{< relref "../panels-visualizations/query-transform-data#add-a-query" >}}) and generates the Random Walk dashboard.
|
||||
This configures your [query](../../panels-visualizations/query-transform-data/#add-a-query) and generates the Random Walk dashboard.
|
||||
|
||||
1. Click the Refresh dashboard icon to query the data source.
|
||||
|
||||
@@ -75,19 +75,19 @@ Congratulations, you have created your first dashboard and it's displaying resul
|
||||
|
||||
#### Next steps
|
||||
|
||||
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 "../datasources#add-a-data-source" >}}). The following topics will be of interest to you:
|
||||
Continue to experiment with what you have built, try the [explore workflow](../../explore/) or another visualization feature. Refer to [Data sources](../../datasources/) for a list of supported data sources and instructions on how to [add a data source](../../datasources/#add-a-data-source). The following topics will be of interest to you:
|
||||
|
||||
- [Panels and visualizations]({{< relref "../panels-visualizations" >}})
|
||||
- [Dashboards]({{< relref "../dashboards" >}})
|
||||
- [Keyboard shortcuts]({{< relref "../dashboards/use-dashboards#keyboard-shortcuts" >}})
|
||||
- [Panels and visualizations](../../panels-visualizations/)
|
||||
- [Dashboards](../../dashboards/)
|
||||
- [Keyboard shortcuts](../../dashboards/use-dashboards/#keyboard-shortcuts)
|
||||
- [Plugins](/grafana/plugins?orderBy=weight&direction=asc)
|
||||
|
||||
##### Admins
|
||||
|
||||
The following topics are of interest to Grafana server admin users:
|
||||
|
||||
- [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" >}})
|
||||
- [Grafana configuration](../../setup-grafana/configure-grafana/)
|
||||
- [Authentication](../../setup-grafana/configure-security/configure-authentication/)
|
||||
- [User permissions and roles](../../administration/roles-and-permissions/)
|
||||
- [Provisioning](../../administration/provisioning/)
|
||||
- [Grafana CLI](../../cli/)
|
||||
|
||||
@@ -38,11 +38,11 @@ Windows users might need to make additional adjustments. Look for special instru
|
||||
|
||||
You can have more than one InfluxDB data source defined in Grafana.
|
||||
|
||||
1. Follow the general instructions to [add a data source]({{< relref "../datasources#add-a-data-source" >}}).
|
||||
1. Follow the general instructions to [add a data source](../../datasources/#add-a-data-source).
|
||||
1. Decide if you will use InfluxQL or Flux as your query language.
|
||||
- [Configure the data source]({{< relref "../datasources/influxdb#configure-the-data-source" >}}) for your chosen query language.
|
||||
- [Configure the data source](../../datasources/influxdb/#configure-the-data-source) for your chosen query language.
|
||||
Each query language has its own unique data source settings.
|
||||
- For querying features specific to each language, see the data source's [query editor documentation]({{< relref "../datasources/influxdb/query-editor" >}}).
|
||||
- For querying features specific to each language, see the data source's [query editor documentation](../../datasources/influxdb/query-editor/).
|
||||
|
||||
##### InfluxDB guides
|
||||
|
||||
@@ -75,8 +75,8 @@ Grafana displays a list of possible series. Click one to select it, and Grafana
|
||||
|
||||
Create a simple Flux query.
|
||||
|
||||
1. [Add a panel]({{< relref "../dashboards/build-dashboards/create-dashboard" >}}).
|
||||
1. In the query editor, select your InfluxDB-Flux data source. For more information, refer to [Queries]({{< relref "../panels-visualizations/query-transform-data" >}}).
|
||||
1. [Add a panel](../../dashboards/build-dashboards/create-dashboard/).
|
||||
1. In the query editor, select your InfluxDB-Flux data source. For more information, refer to [Queries](../../panels-visualizations/query-transform-data/).
|
||||
1. Select the **Table** visualization.
|
||||
1. In the query editor text field, enter `buckets()` and then click outside of the query editor.
|
||||
|
||||
@@ -96,12 +96,12 @@ You can also create Flux queries in the InfluxDB Explore view.
|
||||
|
||||
|
||||
|
||||
1. In Grafana, [add a panel]({{< relref "../dashboards/build-dashboards/create-dashboard" >}}) and then paste your Flux code into the query editor.
|
||||
1. In Grafana, [add a panel](../../dashboards/build-dashboards/create-dashboard/) and then paste your Flux code into the query editor.
|
||||
1. Click **Apply**. Your new panel should be visible with data from your Flux query.
|
||||
|
||||
#### Check InfluxDB metrics in Grafana Explore
|
||||
|
||||
In your Grafana instance, go to the [Explore]({{< relref "../explore" >}}) view and build queries to experiment with the metrics you want to monitor. Here you can also debug issues related to collecting metrics.
|
||||
In your Grafana instance, go to the [Explore](../../explore/) view and build queries to experiment with the metrics you want to monitor. Here you can also debug issues related to collecting metrics.
|
||||
|
||||
#### Start building dashboards
|
||||
|
||||
@@ -109,5 +109,5 @@ There you go! Use Explore and Data Explorer to experiment with your data, and ad
|
||||
|
||||
Here are some resources to learn more:
|
||||
|
||||
- Grafana documentation: [InfluxDB data source]({{< relref "../datasources/influxdb" >}})
|
||||
- Grafana documentation: [InfluxDB data source](../../datasources/influxdb/)
|
||||
- InfluxDB documentation: [Comparison of Flux vs InfluxQL](https://docs.influxdata.com/influxdb/v1.8/flux/flux-vs-influxql/)
|
||||
|
||||
@@ -99,6 +99,6 @@ Optionally, play around this dashboard and customize it to:
|
||||
|
||||
Now that you have gained some idea of using the pre-packaged MS SQL data source and some test data, the next step is to setup your own instance of MS SQL Server database and data your development or sandbox area.
|
||||
|
||||
To fetch data from your own instance of MS SQL Server, add the data source using instructions in Step 4 of this topic. In Grafana [Explore]({{< relref "../explore" >}}) build queries to experiment with the metrics you want to monitor.
|
||||
To fetch data from your own instance of MS SQL Server, add the data source using instructions in Step 4 of this topic. In Grafana [Explore](../../explore/) build queries to experiment with the metrics you want to monitor.
|
||||
|
||||
Once you have a curated list of queries, create [dashboards]({{< relref "../dashboards" >}}) to render metrics from the SQL Server database. For troubleshooting, user permissions, known issues, and query examples, refer to [Using Microsoft SQL Server in Grafana]({{< relref "../datasources/mssql" >}}).
|
||||
Once you have a curated list of queries, create [dashboards](../../dashboards/) to render metrics from the SQL Server database. For troubleshooting, user permissions, known issues, and query examples, refer to [Using Microsoft SQL Server in Grafana](../../datasources/mssql/).
|
||||
|
||||
@@ -114,11 +114,11 @@ To configure your Prometheus instance to work with Grafana locally instead of Gr
|
||||
|
||||
#### Check Prometheus metrics in Grafana Explore view
|
||||
|
||||
In your Grafana instance, go to the [Explore]({{< relref "../explore" >}}) view and build queries to experiment with the metrics you want to monitor. Here you can also debug issues related to collecting metrics from Prometheus.
|
||||
In your Grafana instance, go to the [Explore](../../explore/) view and build queries to experiment with the metrics you want to monitor. Here you can also debug issues related to collecting metrics from Prometheus.
|
||||
|
||||
#### Start building dashboards
|
||||
|
||||
Now that you have a curated list of queries, create [dashboards]({{< relref "../dashboards" >}}) to render system metrics monitored by Prometheus. When you install Prometheus and node_exporter or windows_exporter, you will find recommended dashboards for use.
|
||||
Now that you have a curated list of queries, create [dashboards](../../dashboards/) to render system metrics monitored by Prometheus. When you install Prometheus and node_exporter or windows_exporter, you will find recommended dashboards for use.
|
||||
|
||||
The following image shows a dashboard with three panels showing some system metrics.
|
||||
|
||||
@@ -126,5 +126,5 @@ The following image shows a dashboard with three panels showing some system metr
|
||||
|
||||
To learn more:
|
||||
|
||||
- Grafana documentation: [Prometheus data source]({{< relref "../datasources/prometheus" >}})
|
||||
- Grafana documentation: [Prometheus data source](../../datasources/prometheus/)
|
||||
- Prometheus documentation: [What is Prometheus?](https://prometheus.io/docs/introduction/overview/)
|
||||
|
||||
Reference in New Issue
Block a user