commit
a51ee713ed
|
@ -270,6 +270,7 @@ label:after {
|
|||
color: $article-tab-code-text;
|
||||
}
|
||||
}
|
||||
li .url-trigger { padding: 0rem .5rem; }
|
||||
|
||||
.code-tab-content {
|
||||
.select-url{margin-top: -3.25rem}
|
||||
|
|
|
@ -1,72 +1,114 @@
|
|||
---
|
||||
title: Use Grafana with InfluxDB 2.0
|
||||
title: Use Grafana with InfluxDB
|
||||
description: >
|
||||
Use the Grafana Flux datasource plugin to connect Grafana to InfluxDB 2.0 or
|
||||
InfluxDB Cloud 2.0.
|
||||
Use [Grafana](https://grafana.com/) to visualize data from **InfluxDB 2.0** and **InfluxDB Cloud**.
|
||||
menu:
|
||||
v2_0:
|
||||
name: Use Grafana
|
||||
parent: Other visualization tools
|
||||
weight: 201
|
||||
v2.0/tags: [grafana]
|
||||
related:
|
||||
- https://grafana.com/docs/, Grafana documentation
|
||||
- /v2.0/query-data/get-started/
|
||||
- /v2.0/query-data/influxql/
|
||||
---
|
||||
|
||||
Use the [Grafana Flux Data Source plugin](https://grafana.com/grafana/plugins/grafana-influxdb-flux-datasource)
|
||||
to connect Grafana to InfluxDB 2.0 or InfluxDB Cloud 2.0.
|
||||
Use [Grafana](https://grafana.com/) or [Grafana Cloud](https://grafana.com/products/cloud/)
|
||||
to visualize data from **InfluxDB 2.0** and **{{< cloud-name "short" >}}**.
|
||||
|
||||
{{% warn %}}
|
||||
The **Grafana Flux Data Source plugin** is currently in beta.
|
||||
{{% /warn %}}
|
||||
{{% note %}}
|
||||
The instructions in this guide require **Grafana Cloud** or **Grafana v7.1+**.
|
||||
{{% /note %}}
|
||||
|
||||
1. [Sign up for {{< cloud-name >}}](/v2.0/get-started/) or
|
||||
[Start InfluxDB 2.0 OSS](/v2.0/get-started/#start-with-influxdb-oss).
|
||||
2. [Download and install Grafana](https://grafana.com/grafana/download).
|
||||
3. Install the **Grafana Flux Data Source plugin** manually or with `grafana-cli` (installed
|
||||
with Grafana).
|
||||
|
||||
{{< tabs-wrapper >}}
|
||||
{{% tabs %}}
|
||||
[Install with Grafana CLI](#)
|
||||
[Install manually](#)
|
||||
{{% /tabs %}}
|
||||
{{% tab-content %}}
|
||||
```sh
|
||||
grafana-cli plugins install grafana-influxdb-flux-datasource
|
||||
```
|
||||
{{% /tab-content %}}
|
||||
{{% tab-content %}}
|
||||
Download the [latest release](https://github.com/grafana/influxdb-flux-datasource/releases)
|
||||
of the Flux Datasource Plugin into the Grafana `data/plugins` directory and unzip it.
|
||||
{{% /tab-content %}}
|
||||
{{< /tabs-wrapper >}}
|
||||
|
||||
4. [Start Grafana](https://grafana.com/docs/grafana/latest/installation/) and
|
||||
visit `http://localhost:3000` in your browser.
|
||||
5. In the left navigation of the Grafana user interface (UI), hover over the gear
|
||||
[start InfluxDB 2.0 OSS](/v2.0/get-started/#start-with-influxdb-oss).
|
||||
2. [Sign up for Grafana Cloud](https://grafana.com/products/cloud/) or
|
||||
[download and install Grafana](https://grafana.com/grafana/download).
|
||||
3. Visit your **Grafana Cloud user interface** (UI) or, if running Grafana locally,
|
||||
[start Grafana](https://grafana.com/docs/grafana/latest/installation/) and visit
|
||||
`http://localhost:3000` in your browser.
|
||||
4. In the left navigation of the Grafana UI, hover over the gear
|
||||
icon to expand the **Configuration** section. Click **Data Sources**.
|
||||
6. Click **Add data source**.
|
||||
7. Select **Flux (InfluxDB) [BETA]** from the list of available plugins.
|
||||
5. Click **Add data source**.
|
||||
6. Select **InfluxDB** from the list of available data sources.
|
||||
7. On the **Data Source configuration page**, enter a **name** for your InfluxDB data source.
|
||||
8. Under **Query Language**, select one of the following:
|
||||
|
||||
## Configure your InfluxDB 2.0 connection
|
||||
1. Enter a name for your Flux datasource.
|
||||
2. Under **HTTP**, enter your [InfluxDB URL](/v2.0/reference/urls/).
|
||||
3. Under **Auth**, select **With Credentials**.
|
||||
4. Under **InfluxDB 2.0.0 Details**, enter your **organization name** _or_ **organization ID**,
|
||||
**default bucket**, and **authentication token**.
|
||||
{{< tabs-wrapper >}}
|
||||
{{% tabs %}}
|
||||
[Flux](#)
|
||||
[InfluxQL](#)
|
||||
{{% /tabs %}}
|
||||
<!---------------------------- BEGIN FLUX CONTENT ---------------------------->
|
||||
{{% tab-content %}}
|
||||
## Configure Grafana to use Flux
|
||||
With **Flux** selected as the query language in your InfluxDB data source,
|
||||
configure your InfluxDB connection:
|
||||
|
||||
_For information about retrieving your organization name and ID, see
|
||||
[View organizations](/v2.0/organizations/view-orgs/).
|
||||
For information about viewing your authentication token, see
|
||||
[View tokens](/v2.0/security/tokens/view-tokens/)._
|
||||
1. Under **Connection**, enter the following:
|
||||
|
||||
{{< img-hd src="/img/2-0-visualize-grafana-flux-plugin.png" />}}
|
||||
- **URL**: Your [InfluxDB URL](/v2.0/reference/urls/) **with the `/api/v2` path**.
|
||||
|
||||
```sh
|
||||
http://localhost:9999/api/v2
|
||||
```
|
||||
|
||||
- **Organization**: Your InfluxDB [organization name **or** ID](/v2.0/organizations/view-orgs/).
|
||||
- **Token**: Your InfluxDB [authentication token](/v2.0/security/tokens/).
|
||||
- **Default Bucket**: The default [bucket](/v2.0/organizations/buckets/) to use in Flux queries.
|
||||
- **Min time interval**: The [Grafana minimum time interval](https://grafana.com/docs/grafana/latest/features/datasources/influxdb/#min-time-interval).
|
||||
|
||||
{{< img-hd src="/img/2-0-visualize-grafana.png" />}}
|
||||
|
||||
2. Click **Save & Test**. Grafana attempts to connect to the InfluxDB 2.0 datasource
|
||||
and returns the results of the test.
|
||||
{{% /tab-content %}}
|
||||
<!----------------------------- END FLUX CONTENT ----------------------------->
|
||||
<!-------------------------- BEGIN INFLUXQL CONTENT -------------------------->
|
||||
{{% tab-content %}}
|
||||
## Configure Grafana to use InfluxQL
|
||||
|
||||
{{% cloud %}}
|
||||
**{{< cloud-name "short" >}}** supports InfluxQL, but **InfluxDB 2.0 OSS** does not.
|
||||
{{% /cloud %}}
|
||||
|
||||
With **InfluxQL** selected as the query language in your InfluxDB data source,
|
||||
configure your InfluxDB connection:
|
||||
|
||||
1. Under **HTTP**, enter the following:
|
||||
|
||||
- **URL**: Your [InfluxDB URL](/v2.0/reference/urls/).
|
||||
|
||||
```sh
|
||||
http://localhost:9999
|
||||
```
|
||||
- **Access**: Server (default)
|
||||
|
||||
2. Under **Auth**, enable **Basic Auth**.
|
||||
3. Under **Basic Auth Details**, provide your InfluxDB authentication credentials:
|
||||
|
||||
- **username**: InfluxDB username
|
||||
- **password**: InfluxDB [authentication token](/v2.0/security/tokens/)
|
||||
|
||||
4. Under **InfluxDB details**, set the following:
|
||||
|
||||
- **Database**: The database to use when querying InfluxDB 2.0.
|
||||
_See [Database and retention policy mapping](/v2.0/reference/api/influxdb-1x/dbrp/)._
|
||||
- **HTTP Method**: Select **GET**.
|
||||
- **Min time interval**: The [Grafana minimum time interval](https://grafana.com/docs/grafana/latest/features/datasources/influxdb/#min-time-interval).
|
||||
|
||||
{{< img-hd src="/img/2-0-visualize-grafana-influxql.png" />}}
|
||||
|
||||
5. Click **Save & Test**. Grafana attempts to connect to the InfluxDB 2.0 datasource
|
||||
and returns the results of the test.
|
||||
{{% /tab-content %}}
|
||||
<!--------------------------- END INFLUXQL CONTENT --------------------------->
|
||||
{{< /tabs-wrapper >}}
|
||||
|
||||
## Query and visualize data
|
||||
With your InfluxDB connection configured, use Grafana and Flux to query and
|
||||
visualize time series data stored in InfluxDB 2.0 or {{< cloud-name >}}.
|
||||
visualize time series data stored in **InfluxDB 2.0** or **{{< cloud-name >}}**.
|
||||
|
||||
[Grafana documentation](https://grafana.com/docs/grafana/latest/).
|
||||
If you're just learning Flux, see [Getting started with Flux](/v2.0/query-data/get-started/).
|
||||
For more information about using Grafana, see the [Grafana documentation](https://grafana.com/docs/).
|
||||
If you're just learning Flux, see [Get started with Flux](/v2.0/query-data/get-started/).
|
||||
|
|
Binary file not shown.
Before Width: | Height: | Size: 59 KiB |
Binary file not shown.
After Width: | Height: | Size: 66 KiB |
Binary file not shown.
After Width: | Height: | Size: 37 KiB |
Loading…
Reference in New Issue