Add 1.x Grafana docs (#2232)

* updated influxdb oss and cloud grafana/influxql instructions, closes #1340, closes #2165

* updated grafana cloud instructions to use token auth

* updated cloud grafana config screenshot

* show auth options with influxql in grafana doc

* added tab onload js, WIP grafana rework

* updated content for influxql in grafana

* minor updates to grafana doc, closes #2211

* added information about downloading and configuring the influx cli to cloud grafana doc

* minor update in cloud grafana doc

* updated grafana influxql decision tree

* fixed some typos

* Apply suggestions from code review

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* addressed PR feedback

* added updates to grafana

* scaffolding for grafana doc in 1.7

* add grafana docs for influxdb 1.7 and 1.8, closes influxdata/DAR#125

* updates to 1.x grafana docs

* added grafana docs to enterprise 1.7 and 1.8, closes influxdata/DAR#107

* adjusted menu order of enterprise tools section

* updated enterprise grafana docs to address PR feedback

* added information about RPs and more examples, closes #2215

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

content/enterprise_influxdb/v1.7/tools/_index.md

@@ -0,0 +1,17 @@
+---
+title: InfluxDB Enterprise tools
+description: >
+  Learn more about available tools for working with InfluxDB Enterprise.
+menu:
+  enterprise_influxdb_1_7:
+    name: Tools
+    weight: 70
+---
+
+Use the following tools to work with InfluxDB Enterprise:
+
+{{< children >}}
+
+## InfluxDB open source tools
+Tools built for InfluxDB OSS v1.8 also work with InfluxDB Enterprise v1.7.
+For more information, see [InfluxDB tools](/influxdb/v1.7/tools/).

content/enterprise_influxdb/v1.7/tools/grafana.md

@@ -0,0 +1,79 @@
+---
+title: Use Grafana with InfluxDB Enterprise
+seotitle: Use Grafana with InfluxDB Enterprise v1.7
+description: >
+  Configure Grafana to query and visualize data from InfluxDB Enterprise v1.7.
+menu:
+  enterprise_influxdb_1_7:
+    name: Grafana
+    weight: 60
+    parent: Tools
+canonical: /{{< latest "influxdb" >}}/tools/grafana/
+---
+
+Use [Grafana](https://grafana.com/) or [Grafana Cloud](https://grafana.com/products/cloud/)
+to visualize data from your **InfluxDB Enterprise v1.7** instance.
+
+{{% note %}}
+The instructions in this guide require **Grafana Cloud** or **Grafana v7.1+**.
+For information about using InfluxDB with other versions of Grafana,
+see the [Grafana documentation](https://grafana.com/docs/grafana/v7.0/features/datasources/influxdb/).
+{{% /note %}}
+
+1. [Set up an InfluxDB Enterprise cluster](/enterprise_influxdb/v1.7/install-and-deploy/).
+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**.
+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:
+
+{{< tabs-wrapper >}}
+{{% tabs %}}
+[InfluxQL](#)
+[Flux](#)                 
+{{% /tabs %}}
+{{% tab-content %}}
+## Configure Grafana to use InfluxQL
+
+With **InfluxQL** selected as the query language in your InfluxDB data source settings:
+
+1. Under **HTTP**, enter the following:
+
+    - **URL**: Your **InfluxDB Enterprise URL** or **load balancer URL**.
+
+        ```sh
+        http://localhost:8086/
+        ```
+    - **Access**: Server (default)
+
+2. Under **InfluxDB Details**, enter the following:
+
+    - **Database**: your database name
+    - **User**: your InfluxDB Enterprise username _(if [authentication is enabled](/influxdb/v1.7/administration/authentication_and_authorization/))_
+    - **Password**: your InfluxDB Enterprise password _(if [authentication is enabled](/influxdb/v1.7/administration/authentication_and_authorization/))_
+    - **HTTP Method**: select **GET** or **POST** _(for differences between the two,
+      see the [query HTTP endpoint documentation](/influxdb/v1.7/tools/api/#query-http-endpoint))_
+
+3. Provide a **[Min time interval](https://grafana.com/docs/grafana/latest/datasources/influxdb/#min-time-interval)**
+   (default is 10s).
+
+    {{< img-hd src="/img/enterprise/1-7-tools-grafana-influxql.png" />}}
+
+4. Click **Save & Test**. Grafana attempts to connect to InfluxDB Enterprise and returns
+   the result of the test.
+{{% /tab-content %}}
+
+{{% tab-content %}}
+## Configure Grafana to use Flux
+To query InfluxDB Enterprise using Flux from Grafana, **upgrade to InfluxDB Enterprise 1.8.1+**:
+
+- [Upgrade to InfluxDB Enterprise 1.8.x](/enterprise_influxdb/v1.8/administration/upgrading/)
+- [Use Grafana with InfluxDB Enterprise 1.8](/enterprise_influxdb/v1.8/tools/grafana/).
+{{% /tab-content %}}
+{{< /tabs-wrapper >}}

content/enterprise_influxdb/v1.8/tools/_index.md

@@ -0,0 +1,17 @@
+---
+title: InfluxDB Enterprise tools
+description: >
+  Learn more about available tools for working with InfluxDB Enterprise.
+menu:
+  enterprise_influxdb_1_8:
+    name: Tools
+    weight: 70
+---
+
+Use the following tools to work with InfluxDB Enterprise:
+
+{{< children >}}
+
+## InfluxDB open source tools
+Tools built for InfluxDB OSS v1.8 also work with InfluxDB Enterprise v1.8.
+For more information, see [InfluxDB tools](/influxdb/v1.8/tools/).

content/enterprise_influxdb/v1.8/tools/grafana.md

@@ -0,0 +1,128 @@
+---
+title: Use Grafana with InfluxDB Enterprise
+seotitle: Use Grafana with InfluxDB Enterprise v1.8
+description: >
+  Configure Grafana to query and visualize data from InfluxDB Enterprise v1.8.
+menu:
+  enterprise_influxdb_1_8:
+    name: Grafana
+    weight: 60
+    parent: Tools
+canonical: /{{< latest "influxdb" >}}/tools/grafana/
+---
+
+Use [Grafana](https://grafana.com/) or [Grafana Cloud](https://grafana.com/products/cloud/)
+to visualize data from your **InfluxDB Enterprise v1.8** instance.
+
+{{% note %}}
+#### Required
+- The instructions in this guide require **Grafana Cloud** or **Grafana v7.1+**.
+  For information about using InfluxDB with other versions of Grafana,
+  see the [Grafana documentation](https://grafana.com/docs/grafana/v7.0/features/datasources/influxdb/).
+- To use **Flux**, use **InfluxDB Enterprise 1.8.1+** and [enable Flux](/influxdb/v1.8/flux/installation/)
+  in your InfluxDB data node configuration file.
+{{% /note %}}
+
+1. [Set up an InfluxDB Enterprise cluster](/enterprise_influxdb/v1.8/install-and-deploy/).
+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**.
+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:
+
+{{< tabs-wrapper >}}
+{{% tabs %}}
+[InfluxQL](#)
+[Flux](#)                 
+{{% /tabs %}}
+<!--------------------------- BEGIN INFLUXQL CONTENT -------------------------->
+{{% tab-content %}}
+## Configure Grafana to use InfluxQL
+
+With **InfluxQL** selected as the query language in your InfluxDB data source settings:
+
+1. Under **HTTP**, enter the following:
+
+    - **URL**: Your **InfluxDB Enterprise URL** or **load balancer URL**.
+
+        ```sh
+        http://localhost:8086/
+        ```
+    - **Access**: Server (default)
+
+2. Under **InfluxDB Details**, enter the following:
+
+    - **Database**: your database name
+    - **User**: your InfluxDB Enterprise username _(if [authentication is enabled](/influxdb/v1.8/administration/authentication_and_authorization/))_
+    - **Password**: your InfluxDB Enterprise password _(if [authentication is enabled](/influxdb/v1.8/administration/authentication_and_authorization/))_
+    - **HTTP Method**: select **GET** or **POST** _(for differences between the two,
+      see the [query HTTP endpoint documentation](/influxdb/v1.8/tools/api/#query-http-endpoint))_
+
+3. Provide a **[Min time interval](https://grafana.com/docs/grafana/latest/datasources/influxdb/#min-time-interval)**
+   (default is 10s).
+
+    {{< img-hd src="/img/enterprise/1-7-tools-grafana-influxql.png" />}}
+
+4. Click **Save & Test**. Grafana attempts to connect to InfluxDB Enterprise and returns
+   the result of the test.
+{{% /tab-content %}}
+<!---------------------------- END INFLUXQL CONTENT --------------------------->
+<!----------------------------- 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:
+
+1. Ensure [Flux is enabled](/influxdb/v1.8/flux/installation/) in InfluxDB Enterprise data nodes.
+
+2. Under **Connection**, enter the following:
+
+    - **URL**: Your **InfluxDB Enterprise URL** or **load balancer URL**.
+
+        ```sh
+        http://localhost:8086/
+        ```
+
+    - **Organization**: Provide an arbitrary value.
+    - **Token**: Provide your InfluxDB Enterprise username and password using the following syntax:
+
+      ```sh
+      # Syntax
+      username:password
+
+      # Example
+      johndoe:mY5uP3rS3crE7pA5Sw0Rd
+      ```
+
+      We recommend [enabling authentication](/influxdb/v1.8/administration/authentication_and_authorization/)
+      on all InfluxDB Enterprise clusters. If you choose to leave authentication disabled,
+      leave this field blank.
+
+    - **Default Bucket**: Provide a default database and retention policy combination
+      using the following syntax:
+
+      ```sh
+      # Syntax
+      database-name/retention-policy-name
+
+      # Examples
+      example-db/example-rp
+      telegraf/autogen
+      ```
+
+    - **Min time interval**: [Grafana minimum time interval](https://grafana.com/docs/grafana/latest/features/datasources/influxdb/#min-time-interval).
+
+      {{< img-hd src="/img/enterprise/1-8-tools-grafana-flux.png" />}}
+
+3. Click **Save & Test**. Grafana attempts to connect to InfluxDB Enterprise and returns
+   the result of the test.
+{{% /tab-content %}}
+<!------------------------------ END FLUX CONTENT ----------------------------->
+{{< /tabs-wrapper >}}

content/influxdb/cloud/tools/grafana.md

@@ -105,6 +105,10 @@ Use the [`influx v1 dbrp create` command](/influxdb/cloud/reference/cli/influx/v
 command to create a database/retention policy (DBRP) mapping that associates a database
 and retention policy combination with an InfluxDB Cloud [bucket](/influxdb/cloud/reference/glossary/#bucket).
 
+DBRP mappings do not affect the retention period of the target bucket.
+These mappings allow queries following InfluxDB 1.x conventions to successfully
+query InfluxDB Cloud buckets.
+
 {{% note %}}
 ##### Automatically create DBRP mappings on write
 When using the InfluxDB 1.x compatibility API to write data to InfluxDB Cloud,
@@ -116,9 +120,19 @@ For more information, see [Database and retention policy mapping – Writing dat
 Provide the following:
 
 - database name
-- retention policy
+- retention policy name _(not retention period)_
 - [bucket ID](/influxdb/cloud/organizations/buckets/view-buckets/)
+- _(optional)_ `--default` flag if you want the retention policy to be the default retention
+  policy for the specified database
 
+#### Examples
+
+{{< code-tabs-wrapper >}}
+{{% code-tabs %}}
+[DB with one RP](#)
+[DB with multiple RPs](#)
+{{% /code-tabs %}}
+{{< code-tab-content >}}
 ```sh
 influx v1 dbrp create \
   --db example-db \
@@ -126,6 +140,28 @@ influx v1 dbrp create \
   --bucket-id 00xX00o0X001 \
   --default
 ```
+{{< /code-tab-content >}}
+{{< code-tab-content >}}
+```sh
+# Create telegraf/autogen DBRP mapping with autogen
+# as the default RP for the telegraf DB
+
+influx v1 dbrp create \
+  --db telegraf \
+  --rp autogen \
+  --bucket-id 00xX00o0X001 \
+  --default
+
+# Create telegraf/downsampled-daily DBRP mapping that
+# writes to a different bucket
+
+influx v1 dbrp create \
+  --db telegraf \
+  --rp downsampled-daily \
+  --bucket-id 00xX00o0X002
+```
+{{< /code-tab-content >}}
+{{< /code-tabs-wrapper >}}
 
 _For more information about DBRP mapping, see [Database and retention policy mapping](/influxdb/cloud/reference/api/influxdb-1x/dbrp/)._
 

content/influxdb/v1.7/tools/grafana.md

@@ -1,12 +1,81 @@
 ---
-title: Grafana graphs and dashboards
+title: Use Grafana with InfluxDB
-
+seotitle: Use Grafana with InfluxDB v1.7
+description: >
+  Configure Grafana to query and visualize data from InfluxDB v1.7.
 menu:
   influxdb_1_7:
-    url: "https://grafana.com/docs/grafana/latest/features/datasources/influxdb/"
+    name: Grafana
     weight: 60
     parent: Tools
 v2: /influxdb/v2.0/tools/grafana/
+canonical: /{{< latest "influxdb" >}}/tools/grafana/
 ---
 
-Please see [Grafana's InfluxDB documentation](https://grafana.com/docs/grafana/latest/features/datasources/influxdb/).
+Use [Grafana](https://grafana.com/) or [Grafana Cloud](https://grafana.com/products/cloud/)
+to visualize data from your **InfluxDB v1.7** instance.
+
+{{% note %}}
+The instructions in this guide require **Grafana Cloud** or **Grafana v7.1+**.
+For information about using InfluxDB with other versions of Grafana,
+see the [Grafana documentation](https://grafana.com/docs/grafana/v7.0/features/datasources/influxdb/).
+{{% /note %}}
+
+1. [Start InfluxDB](/influxdb/v1.7/get-started/).
+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**.
+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:
+
+{{< tabs-wrapper >}}
+{{% tabs %}}
+[InfluxQL](#)
+[Flux](#)                 
+{{% /tabs %}}
+{{% tab-content %}}
+## Configure Grafana to use InfluxQL
+
+With **InfluxQL** selected as the query language in your InfluxDB data source settings:
+
+1. Under **HTTP**, enter the following:
+
+    - **URL**: Your **InfluxDB URL**.
+
+        ```sh
+        http://localhost:8086/
+        ```
+    - **Access**: Server (default)
+
+2. Under **InfluxDB Details**, enter the following:
+
+    - **Database**: your database name
+    - **User**: your InfluxDB username _(if [authentication is enabled](/influxdb/v1.7/administration/authentication_and_authorization/))_
+    - **Password**: your InfluxDB password _(if [authentication is enabled](/influxdb/v1.7/administration/authentication_and_authorization/))_
+    - **HTTP Method**: select **GET** or **POST** _(for differences between the two,
+      see the [query HTTP endpoint documentation](/influxdb/v1.7/tools/api/#query-http-endpoint))_
+
+3. Provide a **[Min time interval](https://grafana.com/docs/grafana/latest/datasources/influxdb/#min-time-interval)**
+   (default is 10s).
+
+    {{< img-hd src="/img/influxdb/2-0-tools-grafana-influxql.png" />}}
+
+4. Click **Save & Test**. Grafana attempts to connect to InfluxDB and returns
+   the result of the test.
+
+{{% /tab-content %}}
+
+{{% tab-content %}}
+## Configure Grafana to use Flux
+To query InfluxDB using Flux from Grafana, **upgrade to InfluxDB 1.8.1+**:
+
+- [Upgrade to InfluxDB 1.8.x](/influxdb/v1.8/administration/upgrading/)
+- [Use Grafana with InfluxDB 1.8](/influxdb/v1.8/tools/grafana/).
+{{% /tab-content %}}
+{{< /tabs-wrapper >}}

content/influxdb/v1.8/tools/grafana.md

@@ -1,13 +1,129 @@
 ---
-title: Grafana graphs and dashboards
+title: Use Grafana with InfluxDB
+seotitle: Use Grafana with InfluxDB v1.8
 description: >
-  See Grafana's documentation for details about Grafana graphs and dashboards.
+  Configure Grafana to query and visualize data from InfluxDB v1.8.
 menu:
   influxdb_1_8:
-    url: "https://grafana.com/docs/grafana/latest/features/datasources/influxdb/"
+    name: Grafana
     weight: 60
     parent: Tools
 v2: /influxdb/v2.0/tools/grafana/
+canonical: /{{< latest "influxdb" >}}/tools/grafana/
 ---
 
-Please see [Grafana's InfluxDB documentation](https://grafana.com/docs/grafana/latest/features/datasources/influxdb/).
+Use [Grafana](https://grafana.com/) or [Grafana Cloud](https://grafana.com/products/cloud/)
+to visualize data from your **InfluxDB v1.8** instance.
+
+{{% note %}}
+#### Required
+- The instructions in this guide require **Grafana Cloud** or **Grafana v7.1+**.
+  For information about using InfluxDB with other versions of Grafana,
+  see the [Grafana documentation](https://grafana.com/docs/grafana/v7.0/features/datasources/influxdb/).
+- To use **Flux**, use **InfluxDB 1.8.1+** and [enable Flux](/influxdb/v1.8/flux/installation/)
+  in your InfluxDB configuration file.
+{{% /note %}}
+
+1. [Start InfluxDB](/influxdb/v1.8/get-started/).
+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**.
+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:
+
+{{< tabs-wrapper >}}
+{{% tabs %}}
+[InfluxQL](#)
+[Flux](#)                 
+{{% /tabs %}}
+<!--------------------------- BEGIN INFLUXQL CONTENT -------------------------->
+{{% tab-content %}}
+## Configure Grafana to use InfluxQL
+
+With **InfluxQL** selected as the query language in your InfluxDB data source settings:
+
+1. Under **HTTP**, enter the following:
+
+    - **URL**: Your **InfluxDB URL**.
+
+        ```sh
+        http://localhost:8086/
+        ```
+    - **Access**: Server (default)
+
+2. Under **InfluxDB Details**, enter the following:
+
+    - **Database**: your database name
+    - **User**: your InfluxDB username _(if [authentication is enabled](/influxdb/v1.8/administration/authentication_and_authorization/))_
+    - **Password**: your InfluxDB password _(if [authentication is enabled](/influxdb/v1.8/administration/authentication_and_authorization/))_
+    - **HTTP Method**: Select **GET** or **POST** _(for differences between the two,
+      see the [query HTTP endpoint documentation](/influxdb/v1.8/tools/api/#query-http-endpoint))_
+
+3. Provide a **[Min time interval](https://grafana.com/docs/grafana/latest/datasources/influxdb/#min-time-interval)**
+   (default is 10s).
+
+    {{< img-hd src="/img/influxdb/2-0-tools-grafana-influxql.png" />}}
+
+4. Click **Save & Test**. Grafana attempts to connect to InfluxDB and returns
+   the result of the test.
+
+{{% /tab-content %}}
+<!---------------------------- END INFLUXQL CONTENT --------------------------->
+<!----------------------------- 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:
+
+1. Ensure [Flux is enabled](/influxdb/v1.8/flux/installation/) in InfluxDB.
+
+2. Under **Connection**, enter the following:
+
+    - **URL**: Your **InfluxDB URL**.
+
+        ```sh
+        http://localhost:8086/
+        ```
+
+    - **Organization**: Provide an arbitrary value.
+    - **Token**: If [InfluxDB authentication is enabled](/influxdb/v1.8/administration/authentication_and_authorization/),
+      provide your InfluxDB username and password using the following syntax:
+
+      ```sh
+      # Syntax
+      username:password
+
+      # Example
+      johndoe:mY5uP3rS3crE7pA5Sw0Rd
+      ```
+
+      If authentication is not enabled, leave blank.
+
+    - **Default Bucket**: Provide a default database and retention policy combination
+      using the following syntax:
+
+      ```sh
+      # Syntax
+      database-name/retention-policy-name
+
+      # Examples
+      example-db/example-rp
+      telegraf/autogen
+      ```
+
+    - **Min time interval**: [Grafana minimum time interval](https://grafana.com/docs/grafana/latest/features/datasources/influxdb/#min-time-interval).
+
+      {{< img-hd src="/img/influxdb/1-8-tools-grafana-flux.png" />}}
+
+3. Click **Save & Test**. Grafana attempts to connect to InfluxDB and returns
+   the result of the test.
+{{% /tab-content %}}
+<!------------------------------ END FLUX CONTENT ----------------------------->
+{{< /tabs-wrapper >}}

content/influxdb/v2.0/tools/grafana.md

@@ -132,10 +132,15 @@ influx v1 auth create \
   --username example-user
 ```
 {{% /expand %}}
-{{% expand "View and create InfluxDB DBRP mappings" %}}
+{{< expand "View and create InfluxDB DBRP mappings" >}}
 
+When using InfluxQL to query InfluxDB, the query must specify a database and a retention policy.
 InfluxDB DBRP mappings associate database and retention policy combinations with
-InfluxDB 2.0 [buckets](/influxdb/v2.0/reference/glossary/#bucket)
+InfluxDB 2.0 [buckets](/influxdb/v2.0/reference/glossary/#bucket).
+
+DBRP mappings do not affect the retention period of the target bucket.
+These mappings allow queries following InfluxDB 1.x conventions to successfully
+query InfluxDB 2.0 buckets.
 
 #### View existing DBRP mappings
 Use the [`influx v1 dbrp list`](/influxdb/v2.0/reference/cli/influx/v1/dbrp/list/)
@@ -151,9 +156,19 @@ command to create a DBRP mapping.
 Provide the following:
 
 - database name
-- retention policy
+- retention policy name _(not retention period)_
 - [bucket ID](/influxdb/v2.0/organizations/buckets/view-buckets/)
+- _(optional)_ `--default` flag if you want the retention policy to be the default retention
+  policy for the specified database
 
+#### Examples
+
+{{< code-tabs-wrapper >}}
+{{% code-tabs %}}
+[DB with one RP](#)
+[DB with multiple RPs](#)
+{{% /code-tabs %}}
+{{< code-tab-content >}}
 ```sh
 influx v1 dbrp create \
   --db example-db \
@@ -161,9 +176,31 @@ influx v1 dbrp create \
   --bucket-id 00xX00o0X001 \
   --default
 ```
+{{< /code-tab-content >}}
+{{< code-tab-content >}}
+```sh
+# Create telegraf/autogen DBRP mapping with autogen
+# as the default RP for the telegraf DB
+
+influx v1 dbrp create \
+  --db telegraf \
+  --rp autogen \
+  --bucket-id 00xX00o0X001 \
+  --default
+
+# Create telegraf/downsampled-daily DBRP mapping that
+# writes to a different bucket
+
+influx v1 dbrp create \
+  --db telegraf \
+  --rp downsampled-daily \
+  --bucket-id 00xX00o0X002
+```
+{{< /code-tab-content >}}
+{{< /code-tabs-wrapper >}}
 
 _For more information about DBRP mapping, see [Database and retention policy mapping](/influxdb/v2.0/reference/api/influxdb-1x/dbrp/)._
-{{% /expand %}}
+{{< /expand >}}
 {{< /expand-wrapper >}}
 
 ### Configure your InfluxDB connection

layouts/shortcodes/expand.html

@@ -1,9 +1,10 @@
+{{ $_hugo_config := `{ "version": 1 }` }}
 {{ $expandLabel := .Get 0 }}
 <div class="expand" id="{{ $expandLabel | anchorize }}">
   <p class="expand-label">
       <span class="expand-toggle"></span><span>{{ $expandLabel }}</span>
   </p>
   <div class="expand-content" style="display: none;" >
-      {{ .Inner | markdownify | safeHTML }}
+      {{ .Inner }}
   </div>
 </div>