Merge pull request #1869 from influxdata/oss-202

InfluxDB OSS 2.0.2
pull/1873/head
noramullen1 2020-11-19 11:38:36 -08:00 committed by GitHub
commit 5cb301c056
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
32 changed files with 650 additions and 201 deletions

View File

@ -1873,6 +1873,7 @@ paths:
$ref: "#/components/schemas/Error"
/delete:
post:
operationId: PostDelete
summary: Delete time series data from InfluxDB
requestBody:
description: Predicate delete request
@ -1990,7 +1991,7 @@ paths:
operationId: PostSources
tags:
- Sources
summary: Creates a source
summary: Create a source
parameters:
- $ref: "#/components/parameters/TraceSpan"
requestBody:
@ -2814,7 +2815,7 @@ paths:
operationId: GetDashboardsIDLabels
tags:
- Dashboards
summary: list all labels for a dashboard
summary: List all labels for a dashboard
parameters:
- $ref: "#/components/parameters/TraceSpan"
- in: path
@ -3305,7 +3306,7 @@ paths:
operationId: DeleteAuthorizationsID
tags:
- Authorizations
summary: Delete a authorization
summary: Delete an authorization
parameters:
- $ref: "#/components/parameters/TraceSpan"
- in: path
@ -3681,7 +3682,7 @@ paths:
operationId: DeleteBucketsIDLabelsID
tags:
- Buckets
summary: delete a label from a bucket
summary: Delete a label from a bucket
parameters:
- $ref: "#/components/parameters/TraceSpan"
- in: path
@ -8479,45 +8480,6 @@ components:
TaskStatusType:
type: string
enum: [active, inactive]
Invite:
properties:
id:
description: the idpe id of the invite
readOnly: true
type: string
email:
type: string
role:
type: string
enum:
- member
- owner
expiresAt:
format: date-time
type: string
links:
type: object
readOnly: true
example:
self: "/api/v2/invites/1"
properties:
self:
type: string
format: uri
required: [id, email, role]
Invites:
type: object
properties:
links:
type: object
properties:
self:
type: string
format: uri
invites:
type: array
items:
$ref: "#/components/schemas/Invite"
User:
properties:
id:
@ -8978,8 +8940,32 @@ components:
$ref: "#/components/schemas/Legend"
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow:
type: boolean
hoverDimension:
@ -8990,6 +8976,8 @@ components:
enum: [overlaid, stacked]
geom:
$ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9039,8 +9027,32 @@ components:
$ref: "#/components/schemas/Legend"
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
upperColumn:
type: string
mainColumn:
@ -9052,6 +9064,8 @@ components:
enum: [auto, x, y, xy]
geom:
$ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9101,8 +9115,32 @@ components:
$ref: "#/components/schemas/Legend"
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow:
type: boolean
hoverDimension:
@ -9117,6 +9155,8 @@ components:
type: string
decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9167,6 +9207,18 @@ components:
type: boolean
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
ySeriesColumns:
type: array
items:
@ -9197,6 +9249,8 @@ components:
type: string
ySuffix:
type: string
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9248,8 +9302,32 @@ components:
type: boolean
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
fillColumns:
type: array
items:
@ -9280,6 +9358,8 @@ components:
type: string
ySuffix:
type: string
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9330,8 +9410,32 @@ components:
type: boolean
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
xDomain:
type: array
items:
@ -9356,6 +9460,8 @@ components:
type: string
binSize:
type: number
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9409,11 +9515,6 @@ components:
$ref: "#/components/schemas/Legend"
decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces"
legendOpacity:
type: number
format: float
legendOrientationThreshold:
type: integer
HistogramViewProperties:
type: object
required:
@ -9468,6 +9569,8 @@ components:
enum: [overlaid, stacked]
binCount:
type: integer
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9635,6 +9738,8 @@ components:
type: array
items:
$ref: "#/components/schemas/DashboardColor"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -10159,6 +10264,10 @@ components:
bucketID:
type: string
description: The ID of the bucket to write to.
allowInsecure:
type: boolean
description: Skip TLS verification on endpoint.
default: false
ScraperTargetResponse:
type: object
allOf:
@ -11704,12 +11813,7 @@ components:
type: string
enum: ["slack", "pagerduty", "http", "telegram"]
DBRP:
required:
- orgID
- org
- bucketID
- database
- retention_policy
type: object
properties:
id:
type: string
@ -11735,6 +11839,17 @@ components:
description: Specify if this mapping represents the default retention policy for the database specificed.
links:
$ref: "#/components/schemas/Links"
oneOf:
- required:
- orgID
- bucketID
- database
- retention_policy
- required:
- org
- bucketID
- database
- retention_policy
DBRPs:
properties:
notificationEndpoints:

View File

@ -1,17 +1,17 @@
openapi: "3.0.0"
info:
title: InfluxDB API Service (v1 compatible endpoints)
title: Influx API Service (V1 compatible endpoints)
version: 0.1.0
servers:
- url: /
description: InfluxDB v1 compatible API endpoints.
description: V1 compatible api endpoints.
paths:
/write:
post: # technically this functions with other methods as well
operationId: PostWriteV1
tags:
- Write
summary: Write time series data into InfluxDB in a v1 compatible format
summary: Write time series data into InfluxDB in a V1 compatible format
requestBody:
description: Line protocol body
required: true
@ -103,7 +103,7 @@ paths:
operationId: PostQueryV1
tags:
- Query
summary: Query InfluxDB in a v1 compatible format
summary: Query InfluxDB in a V1 compatible format
requestBody:
description: InfluxQL query to execute.
content:
@ -305,4 +305,4 @@ components:
description: Max length in bytes for a body of line-protocol.
type: integer
format: int32
required: [code, message, maxLength]
required: [code, message, maxLength]

View File

@ -1873,6 +1873,7 @@ paths:
$ref: "#/components/schemas/Error"
/delete:
post:
operationId: PostDelete
summary: Delete time series data from InfluxDB
requestBody:
description: Predicate delete request
@ -1990,7 +1991,7 @@ paths:
operationId: PostSources
tags:
- Sources
summary: Creates a source
summary: Create a source
parameters:
- $ref: "#/components/parameters/TraceSpan"
requestBody:
@ -2814,7 +2815,7 @@ paths:
operationId: GetDashboardsIDLabels
tags:
- Dashboards
summary: list all labels for a dashboard
summary: List all labels for a dashboard
parameters:
- $ref: "#/components/parameters/TraceSpan"
- in: path
@ -3305,7 +3306,7 @@ paths:
operationId: DeleteAuthorizationsID
tags:
- Authorizations
summary: Delete a authorization
summary: Delete an authorization
parameters:
- $ref: "#/components/parameters/TraceSpan"
- in: path
@ -3681,7 +3682,7 @@ paths:
operationId: DeleteBucketsIDLabelsID
tags:
- Buckets
summary: delete a label from a bucket
summary: Delete a label from a bucket
parameters:
- $ref: "#/components/parameters/TraceSpan"
- in: path
@ -8479,45 +8480,6 @@ components:
TaskStatusType:
type: string
enum: [active, inactive]
Invite:
properties:
id:
description: the idpe id of the invite
readOnly: true
type: string
email:
type: string
role:
type: string
enum:
- member
- owner
expiresAt:
format: date-time
type: string
links:
type: object
readOnly: true
example:
self: "/api/v2/invites/1"
properties:
self:
type: string
format: uri
required: [id, email, role]
Invites:
type: object
properties:
links:
type: object
properties:
self:
type: string
format: uri
invites:
type: array
items:
$ref: "#/components/schemas/Invite"
User:
properties:
id:
@ -8978,8 +8940,32 @@ components:
$ref: "#/components/schemas/Legend"
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow:
type: boolean
hoverDimension:
@ -8990,6 +8976,8 @@ components:
enum: [overlaid, stacked]
geom:
$ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9039,8 +9027,32 @@ components:
$ref: "#/components/schemas/Legend"
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
upperColumn:
type: string
mainColumn:
@ -9052,6 +9064,8 @@ components:
enum: [auto, x, y, xy]
geom:
$ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9101,8 +9115,32 @@ components:
$ref: "#/components/schemas/Legend"
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow:
type: boolean
hoverDimension:
@ -9117,6 +9155,8 @@ components:
type: string
decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9167,6 +9207,18 @@ components:
type: boolean
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
ySeriesColumns:
type: array
items:
@ -9197,6 +9249,8 @@ components:
type: string
ySuffix:
type: string
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9248,8 +9302,32 @@ components:
type: boolean
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
fillColumns:
type: array
items:
@ -9280,6 +9358,8 @@ components:
type: string
ySuffix:
type: string
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9330,8 +9410,32 @@ components:
type: boolean
xColumn:
type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn:
type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
xDomain:
type: array
items:
@ -9356,6 +9460,8 @@ components:
type: string
binSize:
type: number
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9409,11 +9515,6 @@ components:
$ref: "#/components/schemas/Legend"
decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces"
legendOpacity:
type: number
format: float
legendOrientationThreshold:
type: integer
HistogramViewProperties:
type: object
required:
@ -9468,6 +9569,8 @@ components:
enum: [overlaid, stacked]
binCount:
type: integer
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -9635,6 +9738,8 @@ components:
type: array
items:
$ref: "#/components/schemas/DashboardColor"
legendColorizeRows:
type: boolean
legendOpacity:
type: number
format: float
@ -10159,6 +10264,10 @@ components:
bucketID:
type: string
description: The ID of the bucket to write to.
allowInsecure:
type: boolean
description: Skip TLS verification on endpoint.
default: false
ScraperTargetResponse:
type: object
allOf:
@ -11704,12 +11813,7 @@ components:
type: string
enum: ["slack", "pagerduty", "http", "telegram"]
DBRP:
required:
- orgID
- org
- bucketID
- database
- retention_policy
type: object
properties:
id:
type: string
@ -11735,6 +11839,17 @@ components:
description: Specify if this mapping represents the default retention policy for the database specificed.
links:
$ref: "#/components/schemas/Links"
oneOf:
- required:
- orgID
- bucketID
- database
- retention_policy
- required:
- org
- bucketID
- database
- retention_policy
DBRPs:
properties:
notificationEndpoints:

View File

@ -1,17 +1,17 @@
openapi: "3.0.0"
info:
title: InfluxDB API Service (v1 compatible endpoints)
title: Influx API Service (V1 compatible endpoints)
version: 0.1.0
servers:
- url: /
description: InfluxDB v1 compatible API endpoints.
description: V1 compatible api endpoints.
paths:
/write:
post: # technically this functions with other methods as well
operationId: PostWriteV1
tags:
- Write
summary: Write time series data into InfluxDB in a v1 compatible format
summary: Write time series data into InfluxDB in a V1 compatible format
requestBody:
description: Line protocol body
required: true
@ -103,7 +103,7 @@ paths:
operationId: PostQueryV1
tags:
- Query
summary: Query InfluxDB in a v1 compatible format
summary: Query InfluxDB in a V1 compatible format
requestBody:
description: InfluxQL query to execute.
content:
@ -305,4 +305,4 @@ components:
description: Max length in bytes for a body of line-protocol.
type: integer
format: int32
required: [code, message, maxLength]
required: [code, message, maxLength]

View File

@ -90,7 +90,7 @@ To use the `influx` CLI to manage and interact with your InfluxDB Cloud instance
Click the following button to download and install `influx` CLI for macOS.
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.1_darwin_amd64.tar.gz" download>influx CLI (macOS)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.2_darwin_amd64.tar.gz" download>influx CLI (macOS)</a>
#### Step 2: Unpackage the influx binary
@ -102,7 +102,7 @@ or run the following command in a macOS command prompt application such
```sh
# Unpackage contents to the current working directory
tar zxvf ~/Downloads/influxdb_client_2.0.1_darwin_amd64.tar.gz
tar zxvf ~/Downloads/influxdb_client_2.0.2_darwin_amd64.tar.gz
```
#### Step 3: (Optional) Place the binary in your $PATH
@ -114,7 +114,7 @@ prefix the executable with `./` to run in place. If the binary is on your $PATH,
```sh
# Copy the influx binary to your $PATH
sudo cp influxdb_client_2.0.1_darwin_amd64/influx /usr/local/bin/
sudo cp influxdb_client_2.0.2_darwin_amd64/influx /usr/local/bin/
```
{{% note %}}
@ -158,8 +158,8 @@ To see all available `influx` commands, type `influx -h` or check out [influx -
Click one of the following buttons to download and install the `influx` CLI appropriate for your chipset.
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.1_linux_amd64.tar.gz" download >influx CLI (amd64)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.1_linux_arm64.tar.gz" download >influx CLI (arm)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.2_linux_amd64.tar.gz" download >influx CLI (amd64)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.2_linux_arm64.tar.gz" download >influx CLI (arm)</a>
#### Step 2: Unpackage the influx binary
@ -167,7 +167,7 @@ Click one of the following buttons to download and install the `influx` CLI appr
```sh
# Unpackage contents to the current working directory
tar xvfz influxdb_client_2.0.1_linux_amd64.tar.gz
tar xvfz influxdb_client_2.0.2_linux_amd64.tar.gz
```
#### Step 3: (Optional) Place the binary in your $PATH
@ -179,7 +179,7 @@ prefix the executable with `./` to run in place. If the binary is on your $PATH,
```sh
# Copy the influx and influxd binary to your $PATH
sudo cp influxdb_client_2.0.1_linux_amd64/influx /usr/local/bin/
sudo cp influxdb_client_2.0.2_linux_amd64/influx /usr/local/bin/
```
{{% note %}}

View File

@ -31,7 +31,7 @@ _See [Differences between InfluxDB Cloud and InfluxDB OSS](#differences-between-
Download InfluxDB v2.0 for macOS.
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb-2.0.1_darwin_amd64.tar.gz" download>InfluxDB v2.0 (macOS)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb-2.0.2_darwin_amd64.tar.gz" download>InfluxDB v2.0 (macOS)</a>
### (Optional) Verify the authenticity of downloaded binary
@ -49,13 +49,13 @@ If `gpg` is not available, see the [GnuPG homepage](https://gnupg.org/download/)
For example:
```
wget https://dl.influxdata.com/influxdb/releases/influxdb-2.0.1_darwin_amd64.tar.gz.asc
wget https://dl.influxdata.com/influxdb/releases/influxdb-2.0.2_darwin_amd64.tar.gz.asc
```
3. Verify the signature with `gpg --verify`:
```
gpg --verify influxdb-2.0.1_darwin_amd64.tar.gz.asc influxdb-2.0.1_darwin_amd64.tar.gz
gpg --verify influxdb-2.0.2_darwin_amd64.tar.gz.asc influxdb-2.0.2_darwin_amd64.tar.gz
```
The output from this command should include the following:
@ -72,7 +72,7 @@ or run the following command in a macOS command prompt application such
```sh
# Unpackage contents to the current working directory
tar zxvf ~/Downloads/influxdb-2.0.1_darwin_amd64.tar.gz
tar zxvf ~/Downloads/influxdb-2.0.2_darwin_amd64.tar.gz
```
#### (Optional) Place the binaries in your $PATH
@ -82,7 +82,7 @@ prefix the executables with `./` to run then in place.
```sh
# (Optional) Copy the influx and influxd binary to your $PATH
sudo cp influxdb-2.0.1_darwin_amd64/{influx,influxd} /usr/local/bin/
sudo cp influxdb-2.0.2_darwin_amd64/{influx,influxd} /usr/local/bin/
```
{{% note %}}
@ -151,7 +151,7 @@ influxd --reporting-disabled
Download InfluxDB v2.0 for Linux.
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb-2.0.1_linux_amd64.tar.gz" download >InfluxDB v2.0 (amd64)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb-2.0.2_linux_amd64.tar.gz" download >InfluxDB v2.0 (amd64)</a>
### (Optional) Verify the authenticity of downloaded binary
@ -169,13 +169,13 @@ If `gpg` is not available, see the [GnuPG homepage](https://gnupg.org/download/)
For example:
```
wget https://dl.influxdata.com/influxdb/releases/influxdb-2.0.1-linux_amd64.tar.gz.asc
wget https://dl.influxdata.com/influxdb/releases/influxdb-2.0.2_linux_amd64.tar.gz.asc
```
3. Verify the signature with `gpg --verify`:
```
gpg --verify influxdb-2.0.1-linux_amd64.tar.gz.asc influxdb-2.0.1-linux_amd64.tar.gz
gpg --verify influxdb-2.0.2_linux_amd64.tar.gz.asc influxdb-2.0.2_linux_amd64.tar.gz
```
The output from this command should include the following:
@ -192,10 +192,10 @@ _**Note:** The following commands are examples. Adjust the file names, paths, an
```sh
# Unpackage contents to the current working directory
tar xvzf path/to/influxdb-2.0.1_linux_amd64.tar.gz
tar xvzf path/to/influxdb-2.0.2_linux_amd64.tar.gz
# Copy the influx and influxd binary to your $PATH
sudo cp influxdb-2.0.1_linux_amd64/{influx,influxd} /usr/local/bin/
sudo cp influxdb-2.0.2_linux_amd64/{influx,influxd} /usr/local/bin/
```
{{% note %}}
@ -247,20 +247,12 @@ influxd --reporting-disabled
{{% tab-content %}}
### Download and run InfluxDB v2.0
{{% note %}}
#### Upgrading from InfluxDB 1.x
We are working on the upgrade process to ensure a smooth upgrade from InfluxDB 1.x to InfluxDB 2.0 on Docker.
If you're upgrading from InfluxDB 1.x on Docker, we recommend waiting to upgrade until we finalize an updated Docker release given the current upgrade process is undefined.
{{% /note %}}
Use `docker run` to download and run the InfluxDB v2.0 Docker image.
Expose port `8086`, which InfluxDB uses for client-server communication over
the [InfluxDB HTTP API](/influxdb/v2.0/reference/api/).
```sh
docker run --name influxdb -p 8086:8086 quay.io/influxdb/influxdb:v2.0.1
docker run --name influxdb -p 8086:8086 quay.io/influxdb/influxdb:2.0.0-rc
```
_To run InfluxDB in [detached mode](https://docs.docker.com/engine/reference/run/#detached-vs-foreground), include the `-d` flag in the `docker run` command._
@ -275,7 +267,7 @@ To opt-out of sending telemetry data back to InfluxData, include the
`--reporting-disabled` flag when starting the InfluxDB container.
```bash
docker run -p 8086:8086 quay.io/influxdb/influxdb:v2.0.1 --reporting-disabled
docker run -p 8086:8086 quay.io/influxdb/influxdb:2.0.0-rc --reporting-disabled
```
{{% /note %}}

View File

@ -1,7 +1,7 @@
---
title: Query in Data Explorer
description: >
Query your data in the InfluxDB user interface (UI) Data Explorer.
Query InfluxDB using the InfluxDB user interface (UI) Data Explorer. Discover how to query data in InfluxDB 2.0 using the InfluxDB UI.
aliases:
- /influxdb/v2.0/visualize-data/explore-metrics/
weight: 201

View File

@ -1,6 +1,6 @@
---
title: Query in the Flux REPL
description: Use the Flux REPL to query InfluxDB data.
description: Query InfluxDB using the Flux REPL. Discover how to query data in InfluxDB 2.0 using the Flux REPL.
weight: 203
menu:
influxdb_2_0:

View File

@ -1,6 +1,6 @@
---
title: Query with the InfluxDB API
description: Use the InfluxDB API to query InfluxDB data.
description: Query InfluxDB with the InfluxDB API. Discover how to query data in InfluxDB 2.0 using the InfluxDB API.
weight: 202
menu:
influxdb_2_0:

View File

@ -1,6 +1,6 @@
---
title: Use the `influx query` command
description: Use the influx CLI to query InfluxDB data.
description: Query InfluxDB using the influx CLI. Discover how to query data in InfluxDB 2.0 using `influx query`.
weight: 204
menu:
influxdb_2_0:

View File

@ -36,7 +36,7 @@ the default retention policy for the specified database.
### When writing data
When writing data to InfluxDB Cloud and InfluxDB OSS 2.0 using the
When writing data using the
[`/write` compatibility endpoint](/influxdb/v2.0/reference/api/influxdb-1x/write/),
the DBRP mapping service checks for a bucket mapped to the database and retention policy:
@ -47,14 +47,6 @@ the DBRP mapping service checks for a bucket mapped to the database and retentio
- **database** exists (without a specified retention policy), the default
database retention policy is used, a DBRP mapping is added to the bucket,
and data is written to the bucket.
- If no matching bucket is found, a new **database/retention-policy** bucket is
automatically created with a DBRP mapping, and data is written to the bucket.
If no retention policy is specified, `autogen` is used.
{{% note %}}
To automatically create new buckets, the authentication token used for the
write request must be an **All Access token**.
{{% /note %}}
### When querying data

View File

@ -22,6 +22,7 @@ influx v1 [command]
| Subcommand | Description |
|:-----------------------------------------------------|:----------------------------------------------|
| [auth](/influxdb/v2.0/reference/cli/influx/v1/auth/) | Authorization management commands for v1 APIs |
| [dbrp](/influxdb/v2.0/reference/cli/influx/v1/dbrp/) | Database retention policy mapping management commands for v1 APIs |
## Flags
| Flag | | Description |

View File

@ -0,0 +1,34 @@
---
title: influx v1 dbrp
description: >
The `influx v1 dbrp` subcommands provide database retention policy (DBRP) mapping management for the InfluxDB 1.x compatibility API.
menu:
influxdb_2_0_ref:
name: influx v1 dbrp
parent: influx v1
weight: 101
influxdb/v2.0/tags: [DBRP]
---
The `influx v1 dbrp` subcommands provide database retention policy (DBRP) management for the [InfluxDB 1.x compatibility API](/influxdb/v2.0/reference/api/influxdb-1x/).
## Usage
```
influx v1 dbrp [flags]
influx v1 dbrp [command]
```
## Commands
| Command | Description |
|:----------------------------------------------------------------------------|----------------------------------------------|
| [`create`](/influxdb/v2.0/reference/cli/influx/v1/dbrp/create/) | Create a DBRP mapping |
| [`delete`](/influxdb/v2.0/reference/cli/influx/v1/dbrp/delete/) | Delete a DBRP mapping |
| [`list`](/influxdb/v2.0/reference/cli/influx/v1/dbrp/list/) | List DBRP mappings |
| [`update`](/influxdb/v2.0/reference/cli/influx/v1/dbrp/update/) | Update a DBRP mapping |
## Flags
| Flag | | Description |
|:-----|:---------|:--------------------------------|
| `-h` | `--help` | Help for the `v1 dbrp ` command |

View File

@ -0,0 +1,50 @@
---
title: influx v1 dbrp create
description: >
The `influx v1 dbrp create` command creates a DBRP mapping in the InfluxDB 1.x compatibility API.
menu:
influxdb_2_0_ref:
name: influx v1 dbrp create
parent: influx v1 dbrp
weight: 101
influxdb/v2.0/tags: [DBRP]
---
The `influx v1 dbrp create` command creates a DBRP mapping with the [InfluxDB 1.x compatibility API](/influxdb/v2.0/reference/api/influxdb-1x/).
## Usage
```
influx v1 dbrp create [flags]
```
## Flags
| Flag | | Description | Input type | {{< cli/mapped >}} |
|-------|-------------------|--------------------------------------------------------------------------------------------|------------|-------------------------|
| `-c` | `--active-config` | Config name to use for command | string | `$INFLUX_ACTIVE_CONFIG` |
| | `--bucket-id` | Bucket ID to map to | | |
| | `--configs-path` | Path to the influx CLI configurations (default: `~/.influxdbv2/configs`) | string | `$INFLUX_CONFIGS_PATH` |
| | `--db` | InfluxDB v1 database to map from | | |
| | `--default` | Set DBRP mapping's retention policy as default | | |
| `-h` | `--help` | Help for the `create` command | | |
| | `--hide-headers` | Hide table headers (default: `false`) | | `$INFLUX_HIDE_HEADERS` |
| | `--host` | HTTP address of InfluxDB | string | `$INFLUX_HOST` |
| | `--json` | Output data as JSON (default: `false`) | | `$INFLUX_OUTPUT_JSON` |
| `-o` | `--org` | Organization name | string | `$INFLUX_ORG` |
| | `--org-id` | Organization ID | string | `$INFLUX_ORG_ID` |
| | `--rp` | InfluxDB v1 retention policy to map from | | |
| | `--skip-verify` | Skip TLS certificate verification | | |
| `-t` | `--token` | Authentication token | string | `$INFLUX_TOKEN` |
## Examples
##### Create a DBRP mapping
```
influx v1 dbrp create \
--bucket-id 12ab34cd56ef \
--database example-db \
--rp example-rp \
--org example-org \
--token $INFLUX_TOKEN \
--default
```

View File

@ -0,0 +1,33 @@
---
title: influx v1 dbrp delete
description: >
The `influx v1 dbrp delete` command deletes a DBRP mapping in the InfluxDB 1.x compatibility API.
menu:
influxdb_2_0_ref:
name: influx v1 dbrp delete
parent: influx v1 dbrp
weight: 101
influxdb/v2.0/tags: [DBRP]
---
The `influx v1 dbrp delete` command deletes a DBRP mapping in the [InfluxDB 1.x compatibility API](/influxdb/v2.0/reference/api/influxdb-1x/).
## Usage
```
influx v1 dbrp delete [flags]
```
## Flags
| Flag | | Description | Input type | {{< cli/mapped >}} |
|------|-------------------|--------------------------------------------------------------------------|------------|-------------------------|
| `-c` | `--active-config` | Config name to use for command | string | `$INFLUX_ACTIVE_CONFIG` |
| | `--configs-path` | Path to the influx CLI configurations (default: `~/.influxdbv2/configs`) | string | `$INFLUX_CONFIGS_PATH` |
| `-h` | `--help` | Help for the `delete` command | | |
| | `--hide-headers` | Hide the table headers (default: `false`) | | `$INFLUX_HIDE_HEADERS` |
| | `--host` | HTTP address of InfluxDB | string | `$INFLUX_HOST` |
| | `--id` | DBRP ID (required) | string | |
| | `--json` | Output data as JSON (default: `false`) | | `$INFLUX_OUTPUT_JSON` |
| `-o` | `--org` | Organization name | string | `$INFLUX_ORG` |
| | `--org-id` | Organization ID | string | `$INFLUX_ORG_ID` |
| | `--skip-verify` | Skip TLS certificate verification | | |
| `-t` | `--token` | Authentication token | string | `$INFLUX_TOKEN` |

View File

@ -0,0 +1,38 @@
---
title: influx v1 dbrp list
description: >
The `influx v1 dbrp list` command lists and searches DBRP mappings in the InfluxDB 1.x compatibility API.
menu:
influxdb_2_0_ref:
name: influx v1 dbrp list
parent: influx v1 dbrp
weight: 101
influxdb/v2.0/tags: [dbrp]
---
The `influx v1 dbrp list` command lists and searches DBRP mappings in the [InfluxDB 1.x compatibility API](/influxdb/v2.0/reference/api/influxdb-1x/).
## Usage
```
influx v1 dbrp list [flags]
```
## Flags
| Flag | | Description | Input type | {{< cli/mapped >}} |
|------|-------------------|--------------------------------------------------------------------------------------------|------------|-------------------------|
| `-c` | `--active-config` | Config name to use for command | string | `$INFLUX_ACTIVE_CONFIG` |
| | `--bucket-id` | Bucket ID | | |
| | `--configs-path` | Path to the influx CLI configurations (default: `~/.influxdbv2/configs`) | string | `$INFLUX_CONFIGS_PATH` |
| | `--db` | Filter DBRP mappings by database | | |
| | `--default` | Limit results to default mapping | | |
| `-h` | `--help` | Help for the `list` command | | |
| | `--hide-headers` | Hide the table headers (default: `false`) | | `$INFLUX_HIDE_HEADERS` |
| | `--host` | HTTP address of InfluxDB | string | `$INFLUX_HOST` |
| | `--id` | Limit results to a specified mapping | string | |
| | `--json` | Output data as JSON (default: `false`) | | `$INFLUX_OUTPUT_JSON` |
| `-o` | `--org` | Organization name | string | `$INFLUX_ORG` |
| | `--org-id` | Organization ID | string | `$INFLUX_ORG_ID` |
| | `--rp` | Filter DBRP mappings by InfluxDB v1 retention policy | string | `$INFLUX_ORG` |
| | `--skip-verify` | Skip TLS certificate verification | | |
| `-t` | `--token` | Authentication token | string | `$INFLUX_TOKEN` |

View File

@ -0,0 +1,35 @@
---
title: influx v1 dbrp update
description: >
The `influx v1 dbrp update` command updates a DBRP mapping in the InfluxDB 1.x compatibility API.
menu:
influxdb_2_0_ref:
name: influx v1 dbrp set-active
parent: influx v1 dbrp
weight: 101
influxdb/v2.0/tags: [DBRP]
---
The `influx v1 dbrp update` command updates a DBRP mapping in the [InfluxDB 1.x compatibility API](/influxdb/v2.0/reference/api/influxdb-1x/).
## Usage
```
influx v1 dbrp update [flags]
```
## Flags
| Flag | | Description | Input type | {{< cli/mapped >}} |
|------|-------------------|--------------------------------------------------------------------------------------------|------------|-------------------------|
| `-c` | `--active-config` | Config name to use for command | string | `$INFLUX_ACTIVE_CONFIG` |
| | `--configs-path` | Path to the influx CLI configurations (default: `~/.influxdbv2/configs`) | string | `$INFLUX_CONFIGS_PATH` |
| | `--default` | Set DBRP mapping's retention policy as default | | |
| `-h` | `--help` | Help for the `update` command | | |
| | `--hide-headers` | Hide the table headers (default: `false`) | | `$INFLUX_HIDE_HEADERS` |
| | `--host` | HTTP address of InfluxDB | string | `$INFLUX_HOST` |
| | `--id` | DBRP ID (required) | string | |
| | `--json` | Output data as JSON (default: `false`) | | `$INFLUX_OUTPUT_JSON` |
| `-o` | `--org` | Organization name | string | `$INFLUX_ORG` |
| | `--org-id` | Organization ID | string | `$INFLUX_ORG_ID` |
| `-r` | `--rp` | InfluxDB v1 retention policy to map from | | |
| | `--skip-verify` | Skip TLS certificate verification | | |
| `-t` | `--token` | Authentication token | string | `$INFLUX_TOKEN` |

View File

@ -17,19 +17,19 @@ influxd inspect [subcommand]
```
## Subcommands
| Subcommand | Description |
|:---------- |:----------- |
| [build-tsi](/influxdb/v2.0/reference/cli/influxd/inspect/build-tsi/) | Rebuild the TSI index and series file |
| [compact-series-file](/influxdb/v2.0/reference/cli/influxd/inspect/compact-series-file) | Compact the series file |
| [dump-tsi](/influxdb/v2.0/reference/cli/influxd/inspect/dump-tsi/) | Output low level TSI information |
| [dumpwal](/influxdb/v2.0/reference/cli/influxd/inspect/dumpwal/) | Output TSM data from WAL files |
| [export-blocks](/influxdb/v2.0/reference/cli/influxd/inspect/export-blocks/) | Export block data |
| [export-index](/influxdb/v2.0/reference/cli/influxd/inspect/export-index/) | Export TSI index data |
| [report-tsi](/influxdb/v2.0/reference/cli/influxd/inspect/report-tsi/) | Report the cardinality of TSI files |
| [report-tsm](/influxdb/v2.0/reference/cli/influxd/inspect/report-tsm/) | Run TSM report |
| [verify-seriesfile](/influxdb/v2.0/reference/cli/influxd/inspect/verify-seriesfile/) | Verify the integrity of series files |
| [verify-tsm](/influxdb/v2.0/reference/cli/influxd/inspect/verify-tsm/) | Check the consistency of TSM files |
| [verify-wal](/influxdb/v2.0/reference/cli/influxd/inspect/verify-wal/) | Check for corrupt WAL files |
| Subcommand | Description |
|:---------- |:----------- |
| [export-index](/influxdb/v2.0/reference/cli/influxd/inspect/export-index/) | Export TSI index data |
<!-- | [build-tsi](/influxdb/v2.0/reference/cli/influxd/inspect/build-tsi/) | Rebuild the TSI index and series file | -->
<!-- | [compact-series-file](/influxdb/v2.0/reference/cli/influxd/inspect/compact-series-file) | Compact the series file | -->
<!-- | [dump-tsi](/influxdb/v2.0/reference/cli/influxd/inspect/dump-tsi/) | Output low level TSI information | -->
<!-- | [dumpwal](/influxdb/v2.0/reference/cli/influxd/inspect/dumpwal/) | Output TSM data from WAL files | -->
<!-- | [export-blocks](/influxdb/v2.0/reference/cli/influxd/inspect/export-blocks/) | Export block data | -->
<!-- | [report-tsi](/influxdb/v2.0/reference/cli/influxd/inspect/report-tsi/) | Report the cardinality of TSI files | -->
<!-- | [report-tsm](/influxdb/v2.0/reference/cli/influxd/inspect/report-tsm/) | Run TSM report | -->
<!-- | [verify-seriesfile](/influxdb/v2.0/reference/cli/influxd/inspect/verify-seriesfile/) | Verify the integrity of series files | -->
<!-- | [verify-tsm](/influxdb/v2.0/reference/cli/influxd/inspect/verify-tsm/) | Check the consistency of TSM files | -->
<!-- | [verify-wal](/influxdb/v2.0/reference/cli/influxd/inspect/verify-wal/) | Check for corrupt WAL files | -->
## Flags
| Flag | | Description |

View File

@ -8,7 +8,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect build-tsi` command rebuilds the TSI index and, if necessary,

View File

@ -8,7 +8,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect compact-series-file` command compacts the [series file](/influxdb/v2.0/reference/glossary/#series-file)

View File

@ -7,7 +7,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect dump-tsi` command outputs low-level information about

View File

@ -7,7 +7,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect dumpwal` command outputs data from Write Ahead Log (WAL) files.

View File

@ -8,7 +8,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect export-blocks` command exports all blocks in one or more

View File

@ -8,7 +8,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect report-tsi` command analyzes Time Series Index (TSI) files

View File

@ -9,7 +9,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect report-tsm` command analyzes Time-Structured Merge Tree (TSM)

View File

@ -7,7 +7,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect verify-seriesfile` command verifies the integrity of series files.

View File

@ -8,7 +8,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect verify-tsm` command analyzes a set of TSM files for inconsistencies

View File

@ -8,7 +8,7 @@ menu:
influxdb_2_0_ref:
parent: influxd inspect
weight: 301
products: [oss]
draft: true
---
The `influxd inspect verify-wal` command analyzes the Write-Ahead Log (WAL)

View File

@ -36,21 +36,22 @@ influxd upgrade [command]
## Flags
| Flag | | Description | Input type |
|:-----|:------------------------|:-----------------------------------------------------------------------------------------------------------|:----------:|
| `-m` | `--bolt-path` | Path for boltdb database (default `~/.influxdbv2/influxd.bolt`) | string |
| `-b` | `--bucket` | Primary bucket name | string |
| | `--config-file` | (Optional) Custom InfluxDB 1.x config file path, else the default config file | string |
| `-e` | `--engine-path` | Path for persistent engine files (default `~/.influxdbv2/engine`) | string |
| `-f` | `--force` | Skip the confirmation prompt | |
| `-h` | `--help` | Help for `influxd upgrade` | |
| | `--influx-command-path` | Path to influx command (default `~/go/bin/influx`) | string |
| | `--log-level` | Supported log levels are `debug`, `info`, `warn`, and `error` (default `info`) | string |
| | `--log-path` | (Optional) Custom log file path (default `~/upgrade.log`) | string |
| `-o` | `--org` | Primary organization name | string |
| `-p` | `--password` | Password for username | string |
| `-r` | `--retention` | (Optional) Duration bucket will retain data (default `0`; retains data infinitely) | string |
| `-t` | `--token` | (Optional) Token for username. If not specified, a token is auto-generated. | string |
| `-u` | `--username` | Primary username | string |
| | `--v1-dir` | Path to source 1.x `db` directory containing `meta`, `data`, and `wal` sub-folders (default `~/.influxdb`) | string |
| `-v` | `--verbose` | Verbose output (default: `true`) | boolean |
| Flag | | Description | Input type |
|:-----|:------------------------ |:-----------------------------------------------------------------------------------------------------------|:----------:|
| `-m` | `--bolt-path` | Path for boltdb database (default `~/.influxdbv2/influxd.bolt`) | string |
| `-b` | `--bucket` | Primary bucket name | string |
| | `--config-file` | Custom InfluxDB 1.x config file path (default `~/.influxdb/influxdb.conf`) | string |
| | `--continuous-query-export-path`| Path for exported 1.x continuous queries (default `~/continuous_queries.txt`) | string |
| `-e` | `--engine-path` | Path for persistent engine files (default `~/.influxdbv2/engine`) | string |
| `-f` | `--force` | Skip the confirmation prompt | |
| `-h` | `--help` | Help for `influxd upgrade` | |
| | `--influx-command-path` | Path to influx command (default `~/go/bin/influx`) | string |
| | `--log-level` | Supported log levels are `debug`, `info`, `warn`, and `error` (default `info`) | string |
| | `--log-path` | Custom log file path (default `~/upgrade.log`) | string |
| `-o` | `--org` | Primary organization name | string |
| `-p` | `--password` | Password for username | string |
| `-r` | `--retention` | Duration bucket will retain data (default `0`; retains data infinitely) | string |
| `-t` | `--token` | Token for username. If not specified, a token is auto-generated. | string |
| `-u` | `--username` | Primary username | string |
| | `--v1-dir` | Path to source 1.x `db` directory containing `meta`, `data`, and `wal` sub-folders (default `~/.influxdb`) | string |
| `-v` | `--verbose` | Verbose output | |

View File

@ -8,6 +8,40 @@ menu:
weight: 101
---
## v2.0.2 General Availability [2020-11-19]
### Breaking changes
#### DBRP HTTP API now matches swagger spec
Previously, the database retention policy (DBRP) mapping API did not match the swagger spec. If you're using scripts based on the previous implementation instead of the swagger spec, you'll need to either update them or use the new [DBRP CLI commands](/influxdb/v2.0/reference/cli/influx/v1/dbrp/) instead.
### Features
- Improvements to upgrade from 1.x to 2.x:
- Warning appears if auth is not enabled in 1.x (`auth-enabled = false`), which is not an option in 2.x. For details, see [Upgrade from InfluxDB 1.x to InfluxDB 2.0](/influxdb/v2.0/upgrade/v1-to-v2/).
- `upgrade` command now checks to see if continuous queries are running and automatically exports them to a local file.
- Upgrade to [Flux v0.95.0](/influxdb/v2.0/reference/release-notes/flux/#v0-95-0-2020-11-17).
- Upgrade `flux-lsp-browser` to v.0.5.23.
- Manage database retention policy (DBRP) mappings via CLI. See [`influx v1 dbrp`](/influxdb/v2.0/reference/cli/influx/v1/dbrp/).
- Filter task runs by time.
### Bug Fixes
- Fixes to `influx upgrade` command:
- Remove internal subcommands from help text.
- Validate used input paths upfront.
- Add locking during TSI iteration creation.
- Fix various typos.
- Use `--skip-verify` flag for backup/restore CLI command. This is passed to the underlying HTTP client for the `BackupService` and `RestoreService` to support backup and restore on servers with self-signed certificates.
- Don't automatically print help on `influxd` errors.
- Add `SameSite=Strict` flag to session cookie.
- Ensure `SHOW DATABASES` returns a list of the unique databases only.
- Allow scraper to ignore insecure certificates on an endpoint.
- Ensure Flux reads across all shards.
- Use the associated default retention policies defined within the DBRP mapping if no retention policy is specified as part of a v1 write API call.
- Add locking during TSI iterator creation.
- Allow self-signed certificates for scraper targets.
- Bump version in `package.json` so it appears correctly.
## v2.0.1 General Availability [2020-11-10]
InfluxDB 2.0 general availability (GA) introduces the first **production-ready** open source version of InfluxDB 2.0. This release comprises all features and bug fixes included in prior alpha, beta, and release candidate versions.

View File

@ -60,6 +60,7 @@ but are planned for subsequent releases.
### Continuous queries
Continuous queries are replaced by **tasks** in InfluxDB 2.0.
By default, `influxd upgrade` writes all continuous queries to `~/continuous_queries.txt`.
To convert continuous queries to InfluxDB tasks, see
[Migrate continuous queries to tasks](/influxdb/v2.0/upgrade/v1-to-v2/migrate-cqs/).

View File

@ -20,8 +20,16 @@ To migrate continuous queries to InfluxDB 2.0 tasks, do the following:
## Output all InfluxDB 1.x continuous queries
To output and save all continuous queries that exist in your InfluxDB 1.x instance,
do the following:
If using the `influxd upgrade` command, by default, all continuous queries are
output to `~/continuous_queries.txt` during the upgrade process.
To customize the destination path of the continuous queries file,
use the `--continuous-query-export-path` flag with the `influxd upgrade` command.
```sh
influxd upgrade --continuous-query-export-path /path/to/continuous_queries.txt
```
**To manually output continuous queries:**
1. Use the InfluxDB 1.x `influx` interactive shell to run `show continuous queries`: