From cb7454be18d8601e3bd19f68396bc1f0d896fd65 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Wed, 9 Dec 2020 16:19:14 -0700 Subject: [PATCH] updated influxdb v2 chronograf doc --- content/influxdb/v2.0/tools/chronograf.md | 20 +++++++++++++++--- .../influxdb/2-0-tools-chronograf-v2-auth.png | Bin 0 -> 5538 bytes 2 files changed, 17 insertions(+), 3 deletions(-) create mode 100644 static/img/influxdb/2-0-tools-chronograf-v2-auth.png diff --git a/content/influxdb/v2.0/tools/chronograf.md b/content/influxdb/v2.0/tools/chronograf.md index 115c58b15..91e2be741 100644 --- a/content/influxdb/v2.0/tools/chronograf.md +++ b/content/influxdb/v2.0/tools/chronograf.md @@ -30,6 +30,9 @@ For example, you **cannot** do the following: - Modify retention policies - Add users +When connected to an InfluxDB Cloud or InfluxDB 2.0 database, the **InfluxDB Admin** +section of Chronograf is disabled. + To complete administrative tasks, use the following: - **InfluxDB user interface (UI)** @@ -44,7 +47,11 @@ For more information, see [InfluxQL support](/influxdb/v2.0/query-data/influxql/ ## Create an InfluxDB connection 1. In Choronograf, click **Configuration** in the left navigation bar, and then click **{{< icon "plus" >}} Add Connection**. -2. Enter your InfluxDB connection credentials: +2. Toggle the **InfluxDB v2 Auth** option at the bottom of the form. + + {{< img-hd src="/img/influxdb/2-0-tools-chronograf-v2-auth.png" alt="InfluxDB v2 Auth toggle" />}} + +3. Enter your InfluxDB connection credentials: - **Connection URL:** InfluxDB URL _(see [InfluxDB Cloud regions](/influxdb/cloud/reference/regions/) or [InfluxDB OSS URLs](/influxdb/v2.0/reference/urls/))_ @@ -53,8 +60,8 @@ For more information, see [InfluxQL support](/influxdb/v2.0/query-data/influxql/ ``` - **Connection Name:** Name to uniquely identify this connection configuration - - **Username:** InfluxDB username - - **Password:** InfluxDB [authentication token](/influxdb/v2.0/security/tokens/) + - **Organization:** InfluxDB organization name + - **Token:** InfluxDB [authentication token](/influxdb/v2.0/security/tokens/) - **Telegraf Database Name:** Default database name - **Default Retention Policy:** Default retention policy @@ -73,3 +80,10 @@ and [Map unmapped buckets](/influxdb/v2.0/query-data/influxql/#map-unmapped-buck _For information about using Kapacitor with InfluxDB Cloud or InfluxDB OSS 2.0, see [Use Kapacitor with InfluxDB](/influxdb/v2.0/tools/kapacitor/)._ 6. Click **Finish**. + +### Update upgraded InfluxDB connections +If using Chronograf with an InfluxDB instance that was upgraded from 1.x +to 2.x, update your connection configuration to use the **InfluxDB v2 Auth** option +and provide an organization and a token. +**Without an organization, Chronograf cannot use Flux to query InfluxDB.** + diff --git a/static/img/influxdb/2-0-tools-chronograf-v2-auth.png b/static/img/influxdb/2-0-tools-chronograf-v2-auth.png new file mode 100644 index 0000000000000000000000000000000000000000..b619dcdf47332312707db6b94498df975e175749 GIT binary patch literal 5538 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 WYP9uXXm9>&YGdVKdHG0S>i+