InfluxDB link fixes (#1377)

* fixed influxdb v2.0 links

* fixed links in influxdb 1.8

* fixed influxdb 1.7 links

* fix links in influxdb 1.6

* fixed links in influxdb 1.5

* fixed links in influxdb 1.4

* fixed links for influxdb 1.3
pull/1387/head
Scott Anderson 2020-08-31 22:01:48 -06:00 committed by Scott Anderson
parent 3770b2e2c3
commit 7bc8a4722e
107 changed files with 548 additions and 561 deletions

View File

@ -759,7 +759,7 @@ Environment variable: `INFLUXDB_GRAPHITE_PROTOCOL`
The number of nodes that must confirm the write.
If the requirement is not met the return value will be either `partial write` if some points in the batch fail or `write failure` if all points in the batch fail.
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.3/write_protocols/write_syntax/).
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.3/write_protocols/line_protocol_reference/).
Environment variable: `INFLUXDB_GRAPHITE_CONSISTENCY_LEVEL`

View File

@ -17,25 +17,25 @@ If you're using version 1.2, please see [Differences Between InfluxDB 1.3 and 1.
Users looking to upgrade to InfluxDB 1.3 from versions prior to 1.2 should view the following pages in our documentation.
##### 1.1 users:
[Differences Between InfluxDB 1.2 and 1.1](/influxdb/v1.2/administration/differences/)
[Differences Between InfluxDB 1.2 and 1.1](https://archive.docs.influxdata.com/influxdb/v1.2/administration/differences/)
##### 1.0 users:
[Differences Between InfluxDB 1.1 and 1.0](/influxdb/v1.1/administration/differences/)
[Differences Between InfluxDB 1.1 and 1.0](https://archive.docs.influxdata.com/influxdb/v1.1/administration/differences/)
##### 0.13 users:
[Differences Between InfluxDB 1.0 and 0.13](/influxdb/v1.0/administration/013_vs_1/)
[Differences Between InfluxDB 1.0 and 0.13](https://archive.docs.influxdata.com/influxdb/v1.0/administration/013_vs_1/)
##### 0.12 users:
[Differences Between InfluxDB 0.13 and 0.12](/influxdb/v0.13/administration/012_vs_013/)
[Differences Between InfluxDB 0.13 and 0.12](https://archive.docs.influxdata.com/influxdb/v0.13/administration/012_vs_013/)
##### 0.11 users:
[Differences between InfluxDB 0.12 and InfluxDB 0.11](/influxdb/v0.12/concepts/011_vs_012/)
[Differences between InfluxDB 0.12 and InfluxDB 0.11](https://archive.docs.influxdata.com/influxdb/v0.12/concepts/011_vs_012/)
##### 0.10 users:
[Differences between InfluxDB 0.11 and InfluxDB 0.10](/influxdb/v1.3/concepts/010_vs_011/)
[Differences between InfluxDB 0.11 and InfluxDB 0.10](https://archive.docs.influxdata.com/influxdb/v0.11/concepts/010_vs_011/)
##### 0.9 users:
[Differences between InfluxDB 0.9 and InfluxDB 0.10](/influxdb/v0.10/concepts/09_vs_010/)
[Differences between InfluxDB 0.9 and InfluxDB 0.10](https://archive.docs.influxdata.com/influxdb/v0.10/concepts/09_vs_010/)
##### 0.8 users:
[Differences between InfluxDB 0.8 and InfluxDB 0.10](/influxdb/v0.10/concepts/08_vs_010/)
[Differences between InfluxDB 0.8 and InfluxDB 0.10](https://archive.docs.influxdata.com/influxdb/v0.10/concepts/08_vs_010/)

View File

@ -290,7 +290,7 @@ Related entries: [tag](/influxdb/v1.3/concepts/glossary/#tag), [tag key](/influx
The date and time associated with a point.
All time in InfluxDB is UTC.
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.3/write_protocols/write_syntax/).
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.3/write_protocols/line_protocol_reference/).
For how to specify time when querying data, see [Data Exploration](/influxdb/v1.3/query_language/data_exploration/#time-syntax).
Related entries: [point](/influxdb/v1.3/concepts/glossary/#point)

View File

@ -7,7 +7,7 @@ menu:
parent: Guides
---
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.3/tools/shell/), [client libraries](/influxdb/v1.3/clients/api/) and plugins for common data formats such as [Graphite](/influxdb/v1.3/write_protocols/graphite/).
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.3/tools/shell/), [client libraries](/influxdb/v1.3/tools/api_client_libraries/) and plugins for common data formats such as **Graphite**.
Here we'll show you how to create a database and write data to it using the built-in HTTP API.
## Creating a database using the HTTP API
@ -62,7 +62,7 @@ cpu_load_short,direction=in,host=server01,region=us-west value=2.0 1422568543702
### Writing points from a file
---
Write points from a file by passing `@filename` to `curl`.
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.3/write_protocols/write_syntax/).
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.3/write_protocols/line_protocol_reference/).
Example of a properly-formatted file (`cpu_data.txt`):
<br>

View File

@ -125,7 +125,7 @@ stock,symbol=AAPL bid=127.46,ask=127.48
temperature,machine=unit42,type=assembly external=25,internal=37 1434067467000000000
```
> **Note:** More information on the line protocol can be found on the [Write Syntax](/influxdb/v1.3/write_protocols/write_syntax/) page.
> **Note:** More information on the line protocol can be found on the [Write Syntax](/influxdb/v1.3/write_protocols/line_protocol_reference/) page.
To insert a single time-series datapoint into InfluxDB using the CLI, enter `INSERT` followed by a point:

View File

@ -656,7 +656,7 @@ Environment variable: `INFLUXDB_GRAPHITE_PROTOCOL`
The number of nodes that must confirm the write.
If the requirement is not met the return value will be either `partial write` if some points in the batch fail or `write failure` if all points in the batch fail.
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.4/write_protocols/write_syntax/).
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.4/write_protocols/line_protocol_reference/).
Environment variable: `INFLUXDB_GRAPHITE_CONSISTENCY_LEVEL`

View File

@ -290,7 +290,7 @@ Related entries: [tag](/influxdb/v1.4/concepts/glossary/#tag), [tag key](/influx
The date and time associated with a point.
All time in InfluxDB is UTC.
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.4/write_protocols/write_syntax/).
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.4/write_protocols/line_protocol_reference/).
For how to specify time when querying data, see [Data Exploration](/influxdb/v1.4/query_language/data_exploration/#time-syntax).
Related entries: [point](/influxdb/v1.4/concepts/glossary/#point)

View File

@ -7,7 +7,7 @@ menu:
parent: Guides
---
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.4/tools/shell/), [client libraries](/influxdb/v1.4/clients/api/) and plugins for common data formats such as [Graphite](https://github.com/influxdata/influxdb/blob/master/services/graphite/README.md).
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.4/tools/shell/), [client libraries](/influxdb/v1.4/tools/api_client_libraries/) and plugins for common data formats such as [Graphite](https://github.com/influxdata/influxdb/blob/master/services/graphite/README.md).
Here we'll show you how to create a database and write data to it using the built-in HTTP API.
## Creating a database using the HTTP API
@ -62,7 +62,7 @@ cpu_load_short,direction=in,host=server01,region=us-west value=2.0 1422568543702
### Writing points from a file
---
Write points from a file by passing `@filename` to `curl`.
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.4/write_protocols/write_syntax/).
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.4/write_protocols/line_protocol_reference/).
Example of a properly-formatted file (`cpu_data.txt`):
<br>

View File

@ -717,7 +717,7 @@ Environment variable: `INFLUXDB_GRAPHITE_PROTOCOL`
The number of nodes that must confirm the write.
If the requirement is not met the return value will be either `partial write` if some points in the batch fail or `write failure` if all points in the batch fail.
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.5/write_protocols/write_syntax/).
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.5/write_protocols/line_protocol_reference/).
Environment variable: `INFLUXDB_GRAPHITE_CONSISTENCY_LEVEL`

View File

@ -8,9 +8,9 @@ menu:
parent: Administration
---
* [Upgrading from 1.3 / 1.4 (no TSI Preview) to 1.5.x (TSI enabled)](#upgrading-from-13-14-no-tsi-preview-to-15-tsi-enabled)
* [Upgrading from 1.4 (TSI Preview enabled) to 1.5.x (TSI enabled)](#upgrading-from-13-14-tsi-preview-enabled-to-15-tsi-enabled)
* [Upgrading from 1.3 to 1.5.x (TSI enabled)](#upgrading-from-13-to-15-tsi-enabled)
* [Upgrading from 1.3 / 1.4 (no TSI Preview) to 1.5.x (TSI enabled)](#upgrading-from-1-3-1-4-no-tsi-preview-to-1-5-x-tsi-enabled)
* [Upgrading from 1.4 (TSI Preview enabled) to 1.5.x (TSI enabled)](#upgrading-influxdb-1-3-1-4-tsi-preview-enabled-to-1-5-x-tsi-enabled)
* [Upgrading from 1.0-1.4 to 1.5.x (TSI enabled)](#upgrading-influxdb-1-0-1-4-to-1-5-x)
* [Upgrading InfluxDB Enterprise clusters](#upgrading-influxdb-enterprise-clusters)
## Upgrading from 1.3 / 1.4 (no TSI Preview) to 1.5.x (TSI enabled)
@ -48,7 +48,7 @@ Follow these steps to upgrade an earlier InfluxDB instance (versions 1.0 to 1.4)
4. Convert existing TSM-based shards to TSI-supported shards.
- Use [influx_inspect buildtsi](/influxdb/v1.5/tools/influx_inspect/#influx-inspect-buildtsi) for converting your TSM-based shards to TSI-based shards.
- Use [influx_inspect buildtsi](/influxdb/v1.5/tools/influx_inspect/#buildtsi) for converting your TSM-based shards to TSI-based shards.
5. Restart the `influxdb` service.
@ -82,7 +82,7 @@ Follow these steps to upgrade an earlier InfluxDB instance (versions 1.3 and 1.4
5. Convert existing shards to support TSI.
- When Time Series Index (TSI) is enabled, new shards use the TSI index. Existing shards must be converted to support TSI.
- Run the [influx_inspect buildtsi](/influxdb/v1.5/tools/influx_inspect/#influx-inspect-buildtsi) command to convert existing TSM-based shards to TSI-based shards.
- Run the [influx_inspect buildtsi](/influxdb/v1.5/tools/influx_inspect/#buildtsi) command to convert existing TSM-based shards to TSI-based shards.
5. Restart the `influxdb` service.

View File

@ -290,7 +290,7 @@ Related entries: [tag](/influxdb/v1.5/concepts/glossary/#tag), [tag key](/influx
The date and time associated with a point.
All time in InfluxDB is UTC.
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.5/write_protocols/write_syntax/).
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.5/write_protocols/line_protocol_reference/).
For how to specify time when querying data, see [Data Exploration](/influxdb/v1.5/query_language/data_exploration/#time-syntax).
Related entries: [point](/influxdb/v1.5/concepts/glossary/#point)

View File

@ -55,8 +55,6 @@ In no particular order, we recommend that you:
[Tags](/influxdb/v1.5/concepts/glossary/#tag) containing highly variable information like UUIDs, hashes, and random strings will lead to a large number of series in the database, known colloquially as high series cardinality.
High series cardinality is a primary driver of high memory usage for many database workloads.
See [Hardware sizing guidelines](/influxdb/v1.5/guides/hardware_sizing/#general-hardware-guidelines-for-a-single-node) for [series cardinality](/influxdb/v1.5/concepts/glossary/#series-cardinality) recommendations based on your hardware. If the system has memory constraints, consider storing high-cardinality data as a field rather than a tag.
### *Don't encode data in measurement names*
In general, taking this step will simplify your queries.
@ -141,7 +139,7 @@ InfluxDB stores data in shard groups.
Shard groups are organized by [retention policy](/influxdb/v1.5/concepts/glossary/#retention-policy-rp) (RP) and store data with timestamps that fall within a specific time interval.
The length of that time interval is called the [shard group duration](/influxdb/v1.5/concepts/glossary/#shard-duration).
If no shard group duration is provided, the shard group duration is determined by the RP's [duration](/influxdb/v1.5/concepts/glossary/#duration) at the time the RP is created. The default values are:
If no shard group duration is provided, the shard group duration is determined by the RP's [duration](/influxdb/v1.5/concepts/glossary/#duration) at the time the RP is created. The default values are:
| RP Duration | Shard Group Duration |
|---|---|

View File

@ -29,7 +29,7 @@ If you are troubleshooting an issue with an index, you can use the `influx_inspe
This command allows you to print summary statistics on an index, file, or a set of files.
This command only works on one index at a time.
For details on this command, see [influx_inspect dumptsi](/influxdb/v1.5/tools/influx_inspect/#influx-inspect-dumptsi).
For details on this command, see [influx_inspect dumptsi](/influxdb/v1.5/tools/influx_inspect/#dumptsi).
### `influx_inspect buildtsi`
@ -38,7 +38,7 @@ If you have an existing TSI index that you want to rebuild, first delete the `in
This command works at the server-level but you can optionally add database, retention policy and shard filters to only apply to a subset of shards.
For details on this command, see [influx inspect buildtsi](/influxdb/v1.5/tools/influx_inspect/#influx-inspect-buildtsi).
For details on this command, see [influx inspect buildtsi](/influxdb/v1.5/tools/influx_inspect/#buildtsi).
## Understanding TSI

View File

@ -7,7 +7,7 @@ menu:
parent: Guides
---
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.5/tools/shell/), [client libraries](/influxdb/v1.5/clients/api/) and plugins for common data formats such as [Graphite](/influxdb/v1.5/write_protocols/graphite/).
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.5/tools/shell/), [client libraries](/influxdb/v1.5/tools/api_client_libraries/) and plugins for common data formats such as [Graphite](/influxdb/v1.5/write_protocols/graphite/).
Here we'll show you how to create a database and write data to it using the built-in HTTP API.
## Creating a database using the HTTP API
@ -62,7 +62,7 @@ cpu_load_short,direction=in,host=server01,region=us-west value=2.0 1422568543702
### Writing points from a file
---
Write points from a file by passing `@filename` to `curl`.
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.5/write_protocols/write_syntax/).
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.5/write_protocols/line_protocol_reference/).
Example of a properly-formatted file (`cpu_data.txt`):
<br>

View File

@ -37,7 +37,7 @@ InfluxDB shell 1.4.x
* The InfluxDB HTTP API runs on port `8086` by default.
Therefore, `influx` will connect to port `8086` and `localhost` by default.
If you need to alter these defaults, run `influx --help`.
* The [`-precision` argument](/influxdb/v1.5/tools/shell/#influx-arguments) specifies the format/precision of any returned timestamps.
* The [`-precision` argument](/influxdb/v1.5/tools/shell/#precision-rfc3339-h-m-s-ms-u-ns) specifies the format/precision of any returned timestamps.
In the example above, `rfc3339` tells InfluxDB to return timestamps in [RFC3339 format](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ`).
The command line is now ready to take input in the form of the Influx Query Language (a.k.a InfluxQL) statements.

View File

@ -32,7 +32,7 @@ InfluxDB shell 1.4.x
* The InfluxDB HTTP API runs on port `8086` by default.
Therefore, `influx` will connect to port `8086` and `localhost` by default.
If you need to alter these defaults, run `influx --help`.
* The [`-precision` argument](/influxdb/v1.5/tools/shell/#influx-arguments) specifies the format/precision of any returned timestamps.
* The [`-precision` argument](/influxdb/v1.5/tools/shell/#precision-rfc3339-h-m-s-ms-u-ns) specifies the format/precision of any returned timestamps.
In the example above, `rfc3339` tells InfluxDB to return timestamps in [RFC3339 format](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ`).
The command line is now ready to take input in the form of the Influx Query Language (a.k.a InfluxQL) statements.

View File

@ -2724,7 +2724,7 @@ the lower bound to `now()` such that the query's time range is between
The [CLI](/influxdb/v1.5/tools/shell/) returns timestamps in
nanosecond epoch format by default.
Specify alternative formats with the
[`precision <format>` command](/influxdb/v1.5/tools/shell/#influx-commands).
[`precision <format>` command](/influxdb/v1.5/tools/shell/#commands).
The [HTTP API](/influxdb/v1.5/tools/api/) returns timestamps
in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format by default.
Specify alternative formats with the

View File

@ -613,7 +613,7 @@ SIZE OF BLOCKS: 931
### EXPLAIN ANALYZE
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution_time) and [planning time](#planning_time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution-time) and [planning time](#planning-time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
For example, executing the following statement:
@ -972,7 +972,6 @@ Estimates or counts exactly the cardinality of the series for the current databa
[Series cardinality](/influxdb/v1.5/concepts/glossary/#series-cardinality) is the major factor that affects RAM requirements. For more information, see:
- [When do I need more RAM?](/influxdb/v1.5/guides/hardware_sizing/#when-do-i-need-more-ram) in [Hardware Sizing Guidelines](/influxdb/v1.5/guides/hardware_sizing/)
- [Don't have too many series](/influxdb/v1.5/concepts/schema_and_data_layout/#don-t-have-too-many-series)
> **Note:** `ON <database>`, `FROM <sources>`, `WITH KEY = <key>`, `WHERE <condition>`, `GROUP BY <dimensions>`, and `LIMIT/OFFSET` clauses are optional.

View File

@ -15,7 +15,7 @@ The [collectd](https://collectd.org) input allows InfluxDB to accept data transm
## A note on UDP/IP buffer sizes
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.5/supported_protocols/udp/#a-note-on-udpip-os-buffer-sizes)
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.5/supported_protocols/udp/#a-note-on-udp-ip-os-buffer-sizes)
## Configuration

View File

@ -23,7 +23,7 @@ and view query output in different formats:
Go straight to the documentation on:
* [Launching `influx`](/influxdb/v1.5/tools/shell/#launch-influx)
* [Launching `influx`](/influxdb/v1.5/tools/shell/#using-influx)
* [Writing data with `influx`](/influxdb/v1.5/tools/shell/#write-data-to-influxdb-with-insert)
## [InfluxDB HTTP API Reference](/influxdb/v1.5/tools/api/)

View File

@ -32,7 +32,6 @@ The `influx_inspect` commands are summarized here, with links to detailed inform
* [`dumptsi`](#dumptsi): Dump low-level details about TSI files.
* [`dumptsm`](#dumptsm): Dump low-level details about TSM files.
* [`export`](#export): Export raw data from a shard in Line Protocol format.
* [`help`](#help): Display this help message format.
* [`report`](#report): Display a shard level report.
* [`verify`](#verify): Verify the integrity of TSM files.
@ -112,7 +111,9 @@ $ influx_inspect buildtsi -database stress -shard 1 -datadir ~/.influxdb/data -w
Bulk deletes a measurement from a raw TSM file.
{{% warn %}} **Warning:** Use the `deletetsm` command only when your InfluxDB instance is offline (`influxd` service is not running).{{% /warn %}}
{{% warn %}}
**Warning:** Use the `deletetsm` command only when your InfluxDB instance is offline (`influxd` service is not running).
{{% /warn %}}
#### Syntax

View File

@ -12,7 +12,7 @@ The InfluxDB command line interface utility (`influx`) is an interactive shell f
Use `influx` to write data (manually or from a file), query data interactively, and view query output in different formats.
* [Using `influx`](/influxdb/v1.5/tools/shell/#using-influx)
* [Arguments](/influxdb/v1.5/tools/shell/#arguments)
* [Arguments](#global-options)
* [Commands](/influxdb/v1.5/tools/shell/#commands)
### Using `influx`

View File

@ -455,7 +455,7 @@ and more examples, see the [API Reference](/influxdb/v1.5/tools/api/#write).
#### CLI
Write data to InfluxDB using InfluxDB's Command Line Interface (CLI).
[Launch](/influxdb/v1.5/tools/shell/#launch-influx) the CLI, use the relevant
[Launch](/influxdb/v1.5/tools/shell/#using-influx) the CLI, use the relevant
database, and put `INSERT` in
front of your Line Protocol:
@ -474,7 +474,7 @@ on the [HTTP API](/influxdb/v1.5/tools/api/#write), the
[UDP](/influxdb/v1.5/tools/udp/),
[Graphite](/influxdb/v1.5/tools/graphite/),
[CollectD](/influxdb/v1.5/tools/collectd/), and
[OpenTSDB](/influxdb/v1.5/tools/opentsdb/)).
[OpenTSDB](/influxdb/v1.5/supported_protocols/opentsdb/)).
### Duplicate points

View File

@ -744,7 +744,7 @@ Environment variable: `INFLUXDB_GRAPHITE_PROTOCOL`
The number of nodes that must confirm the write.
If the requirement is not met the return value will be either `partial write` if some points in the batch fail or `write failure` if all points in the batch fail.
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.6/write_protocols/write_syntax/).
For more information, see the Query String Parameters for Writes section in the [Line Protocol Syntax Reference ](/influxdb/v1.6/write_protocols/line_protocol_reference/).
Environment variable: `INFLUXDB_GRAPHITE_CONSISTENCY_LEVEL`

View File

@ -290,7 +290,7 @@ Related entries: [tag](/influxdb/v1.6/concepts/glossary/#tag), [tag key](/influx
The date and time associated with a point.
All time in InfluxDB is UTC.
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.6/write_protocols/write_syntax/).
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.6/write_protocols/line_protocol_reference/).
For how to specify time when querying data, see [Data Exploration](/influxdb/v1.6/query_language/data_exploration/#time-syntax).
Related entries: [point](/influxdb/v1.6/concepts/glossary/#point)

View File

@ -55,8 +55,6 @@ In no particular order, we recommend that you:
[Tags](/influxdb/v1.6/concepts/glossary/#tag) containing highly variable information like UUIDs, hashes, and random strings will lead to a large number of series in the database, known colloquially as high series cardinality.
High series cardinality is a primary driver of high memory usage for many database workloads.
See [Hardware sizing guidelines](/influxdb/v1.6/guides/hardware_sizing/#general-hardware-guidelines-for-a-single-node) for [series cardinality](/influxdb/v1.6/concepts/glossary/#series-cardinality) recommendations based on your hardware. If the system has memory constraints, consider storing high-cardinality data as a field rather than a tag.
### *Don't encode data in measurement names*
In general, taking this step will simplify your queries.
@ -141,7 +139,7 @@ InfluxDB stores data in shard groups.
Shard groups are organized by [retention policy](/influxdb/v1.6/concepts/glossary/#retention-policy-rp) (RP) and store data with timestamps that fall within a specific time interval.
The length of that time interval is called the [shard group duration](/influxdb/v1.6/concepts/glossary/#shard-duration).
If no shard group duration is provided, the shard group duration is determined by the RP's [duration](/influxdb/v1.6/concepts/glossary/#duration) at the time the RP is created. The default values are:
If no shard group duration is provided, the shard group duration is determined by the RP's [duration](/influxdb/v1.6/concepts/glossary/#duration) at the time the RP is created. The default values are:
| RP Duration | Shard Group Duration |
|---|---|

View File

@ -7,10 +7,4 @@ menu:
---
## [Writing data with the HTTP API](/influxdb/v1.6/guides/writing_data/)
## [Querying data with the HTTP API](/influxdb/v1.6/guides/querying_data/)
## [Downsampling and data retention](/influxdb/v1.6/guides/downsampling_and_retention/)
## [Hardware sizing guidelines](/influxdb/v1.6/guides/hardware_sizing/)
{{< children >}}

View File

@ -7,7 +7,7 @@ menu:
parent: Guides
---
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.6/tools/shell/), [client libraries](/influxdb/v1.6/clients/api/) and plugins for common data formats such as [Graphite](/influxdb/v1.6/write_protocols/graphite/).
There are many ways to write data into InfluxDB including the [command line interface](/influxdb/v1.6/tools/shell/), [client libraries](/influxdb/v1.6/tools/api_client_libraries/) and plugins for common data formats such as [Graphite](/influxdb/v1.6/write_protocols/graphite/).
Here we'll show you how to create a database and write data to it using the built-in HTTP API.
## Creating a database using the HTTP API
@ -62,7 +62,7 @@ cpu_load_short,direction=in,host=server01,region=us-west value=2.0 1422568543702
### Writing points from a file
---
Write points from a file by passing `@filename` to `curl`.
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.6/write_protocols/write_syntax/).
The data in the file should follow InfluxDB's [line protocol syntax](/influxdb/v1.6/write_protocols/line_protocol_reference/).
Example of a properly-formatted file (`cpu_data.txt`):
<br>

View File

@ -614,7 +614,7 @@ SIZE OF BLOCKS: 931
### EXPLAIN ANALYZE
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution_time) and [planning time](#planning_time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution-time) and [planning time](#planning-time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
For example, executing the following statement:
@ -837,7 +837,7 @@ SHOW DATABASES
### SHOW DIAGNOSTICS
Displays node information, such as build information, uptime, hostname, server configuration, memory usage, and Go runtime diagnostics.
Displays node information, such as build information, uptime, hostname, server configuration, memory usage, and Go runtime diagnostics.
For more information on using the `SHOW DIAGNOSTICS` command, see [Using the SHOW DIAGNOSTICS command for monitoring InfluxDB](/platform/monitoring/influxdata-platform/tools/show-diagnostics/).
@ -984,7 +984,6 @@ Estimates or counts exactly the cardinality of the series for the current databa
[Series cardinality](/influxdb/v1.6/concepts/glossary/#series-cardinality) is the major factor that affects RAM requirements. For more information, see:
- [When do I need more RAM?](/influxdb/v1.6/guides/hardware_sizing/#when-do-i-need-more-ram) in [Hardware Sizing Guidelines](/influxdb/v1.6/guides/hardware_sizing/)
- [Don't have too many series](/influxdb/v1.6/concepts/schema_and_data_layout/#don-t-have-too-many-series)
> **Note:** `ON <database>`, `FROM <sources>`, `WITH KEY = <key>`, `WHERE <condition>`, `GROUP BY <dimensions>`, and `LIMIT/OFFSET` clauses are optional.

View File

@ -15,7 +15,7 @@ The [collectd](https://collectd.org) input allows InfluxDB to accept data transm
## A note on UDP/IP buffer sizes
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.6/supported_protocols/udp/#a-note-on-udpip-os-buffer-sizes)
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.6/supported_protocols/udp/#a-note-on-udp-ip-os-buffer-sizes)
## Configuration

View File

@ -474,7 +474,7 @@ on the [HTTP API](/influxdb/v1.6/tools/api/#write-http-endpoint), the
[UDP](/influxdb/v1.6/tools/udp/),
[Graphite](/influxdb/v1.6/tools/graphite/),
[CollectD](/influxdb/v1.6/tools/collectd/), and
[OpenTSDB](/influxdb/v1.6/tools/opentsdb/)).
[OpenTSDB](/influxdb/v1.6/supported_protocols/opentsdb/)).
### Duplicate points

View File

@ -197,7 +197,7 @@ Chunked query was added into the Go client v2 interface. If you compiled against
Support for the Flux language and queries has been added in this release. To begin exploring Flux 0.7 (technical preview):
* Enable Flux using the new configuration setting [`[http] flux-enabled = true`](/influxdb/v1.7/administration/config/#flux-enabled-false).
* Use the new [`influx -type=flux`](/influxdb/v1.7/tools/shell/#type) option to enable the Flux REPL shell for creating Flux queries.
* Use the new [`influx -type=flux`](/influxdb/v1.7/tools/shell/) option to enable the Flux REPL shell for creating Flux queries.
* Read about Flux and the Flux language, enabling Flux, or jump into the getting started and other guides.
#### Time Series Index (TSI) query performance and throughputs improvements

View File

@ -51,6 +51,6 @@ Management of breaking changes, upgrades, and ongoing support.
## Downgrading
To revert to a prior version, complete the same steps as when [Upgrading to InfluxDB 1.7.x](/influxdb/v1.7/administration/upgrading/), replacing 1.7.x with the version you want to downgrade to. After downloading the release, migrating your configuration settings, and enabling TSI or TSM, make sure to [rebuild your index](/influxdb/v1.7/administration/rebuild-tsi-index/#sidebar).
To revert to a prior version, complete the same steps as when [Upgrading to InfluxDB 1.7.x](/influxdb/v1.7/administration/upgrading/), replacing 1.7.x with the version you want to downgrade to. After downloading the release, migrating your configuration settings, and enabling TSI or TSM, make sure to [rebuild your index](/influxdb/v1.7/administration/rebuild-tsi-index/).
>**Note:** Some versions of InfluxDB may have breaking changes that impact your ability to upgrade and downgrade. For example, you cannot downgrade from InfluxDB 1.3 or later to an earlier version. Please review the applicable version of release notes to check for compatibility issues between releases.

View File

@ -51,7 +51,7 @@ Switch index types at any time by doing one of the following:
## Downgrade InfluxDB
To downgrade to an earlier version, complete the procedures above in [Upgrade to InfluxDB 1.7.x](#upgrade-to-influxdb-1-7-x), replacing the version numbers with the version that you want to downgrade to.
After downloading the release, migrating your configuration settings, and enabling TSI or TSM, make sure to [rebuild your index](/influxdb/v1.7/administration/rebuild-tsi-index/#sidebar).
After downloading the release, migrating your configuration settings, and enabling TSI or TSM, make sure to [rebuild your index](/influxdb/v1.7/administration/rebuild-tsi-index/).
>**Note:** Some versions of InfluxDB may have breaking changes that impact your ability to upgrade and downgrade. For example, you cannot downgrade from InfluxDB 1.3 or later to an earlier version. Please review the applicable version of release notes to check for compatibility issues between releases.

View File

@ -55,7 +55,7 @@ In no particular order, we recommend that you:
[Tags](/influxdb/v1.7/concepts/glossary/#tag) containing highly variable information like UUIDs, hashes, and random strings will lead to a large number of series in the database, known colloquially as high series cardinality.
High series cardinality is a primary driver of high memory usage for many database workloads.
See [Hardware sizing guidelines](/influxdb/v1.7/guides/hardware_sizing/#general-hardware-guidelines-for-a-single-node) for [series cardinality](/influxdb/v1.7/concepts/glossary/#series-cardinality) recommendations based on your hardware. If the system has memory constraints, consider storing high-cardinality data as a field rather than a tag.
See [Hardware sizing guidelines](/influxdb/v1.7/guides/hardware_sizing/) for [series cardinality](/influxdb/v1.7/concepts/glossary/#series-cardinality) recommendations based on your hardware. If the system has memory constraints, consider storing high-cardinality data as a field rather than a tag.
### Don't use the same name for a tag and a field

View File

@ -322,7 +322,7 @@ _For a complete list of Flux functions, [view all Flux functions](/{{< latest "i
| [SHOW SERIES](/influxdb/v1.7/query_language/schema_exploration/#show-series) | -- |
| [CREATE DATABASE](/influxdb/v1.7/query_language/database_management/#create-database) | -- |
| [DROP DATABASE](/influxdb/v1.7/query_language/database_management/#delete-a-database-with-drop-database) | -- |
| [DROP SERIES](/influxdb/v1.7/query_language/database_management/#drop-series-from-the-index-with-drop-serie) | -- |
| [DROP SERIES](/influxdb/v1.7/query_language/database_management/#drop-series-from-the-index-with-drop-series) | -- |
| [DELETE](/influxdb/v1.7/query_language/database_management/#delete-series-with-delete) | -- |
| [DROP MEASUREMENT](/influxdb/v1.7/query_language/database_management/#delete-measurements-with-drop-measurement) | -- |
| [DROP SHARD](/influxdb/v1.7/query_language/database_management/#delete-a-shard-with-drop-shard) | -- |
@ -361,9 +361,9 @@ _For a complete list of Flux functions, [view all Flux functions](/{{< latest "i
| [FLOOR](/influxdb/v1.7/query_language/functions#floor) | [math.floor()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/floor/) |
| [HISTOGRAM](/influxdb/v1.7/query_language/functions#histogram) | [histogram()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/histogram/) |
| [LN](/influxdb/v1.7/query_language/functions#ln) | [math.log()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log/) |
| [LOG](/influxdb/v1.7/query_language/functions#log) | [math.logb()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/logb/) |
| [LOG2](/influxdb/v1.7/query_language/functions#log2) | [math.log2()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log2/) |
| [LOG10](/influxdb/v1.7/query_language/functions#logt10) | [math.log10()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log10/) |
| [LOG](/influxdb/v1.7/query_language/functions/#log) | [math.logb()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/logb/) |
| [LOG2](/influxdb/v1.7/query_language/functions/#log2) | [math.log2()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log2/) |
| [LOG10](/influxdb/v1.7/query_language/functions/#log10) | [math.log10()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log10/) |
| [MOVING_AVERAGE](/influxdb/v1.7/query_language/functions#moving-average) | [movingAverage()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/movingaverage/) |
| [NON_NEGATIVE_DERIVATIVE](/influxdb/v1.7/query_language/functions#non-negative-derivative) | [derivative(nonNegative:true)](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |
| [NON_NEGATIVE_DIFFERENCE](/influxdb/v1.7/query_language/functions#non-negative-difference) | [difference(nonNegative:true)](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |

View File

@ -37,7 +37,7 @@ InfluxDB shell 1.7.x
* The InfluxDB API runs on port `8086` by default.
Therefore, `influx` will connect to port `8086` and `localhost` by default.
If you need to alter these defaults, run `influx --help`.
* The [`-precision` argument](/influxdb/v1.7/tools/shell/#influx-options) specifies the format/precision of any returned timestamps.
* The [`-precision` argument](/influxdb/v1.7/tools/shell/#influx-arguments) specifies the format/precision of any returned timestamps.
In the example above, `rfc3339` tells InfluxDB to return timestamps in [RFC3339 format](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ`).
The command line is now ready to take input in the form of the Influx Query Language (a.k.a InfluxQL) statements.

View File

@ -360,7 +360,7 @@ Note that the basic syntax does not support using
to change the value reported for intervals with no data.
Basic syntax CQs ignore `fill()` if it's included in the CQ query.
A possible workaround is to use the
[advanced CQ syntax](#example-4-configuring-cq-time-ranges-and-filling-empty-results).
[advanced CQ syntax](#advanced-syntax).
##### Resampling previous time intervals

View File

@ -32,7 +32,7 @@ InfluxDB shell 1.4.x
* The InfluxDB API runs on port `8086` by default.
Therefore, `influx` will connect to port `8086` and `localhost` by default.
If you need to alter these defaults, run `influx --help`.
* The [`-precision` argument](/influxdb/v1.7/tools/shell/#influx-options) specifies the format/precision of any returned timestamps.
* The [`-precision` argument](/influxdb/v1.7/tools/shell/#influx-arguments) specifies the format/precision of any returned timestamps.
In the example above, `rfc3339` tells InfluxDB to return timestamps in [RFC3339 format](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ`).
The command line is now ready to take input in the form of the Influx Query Language (a.k.a InfluxQL) statements.

View File

@ -616,7 +616,7 @@ SIZE OF BLOCKS: 931
### EXPLAIN ANALYZE
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution_time) and [planning time](#planning_time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution-time) and [planning time](#planning-time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
For example, executing the following statement:

View File

@ -15,7 +15,7 @@ The [collectd](https://collectd.org) input allows InfluxDB to accept data transm
## A note on UDP/IP buffer sizes
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.7/supported_protocols/udp/#a-note-on-udpip-os-buffer-sizes)
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.7/supported_protocols/udp/#a-note-on-udp-ip-os-buffer-sizes)
## Configuration

View File

@ -248,7 +248,7 @@ The import file has two sections:
* **DDL (Data Definition Language)**: Contains the [InfluxQL commands](/influxdb/v1.7/query_language/database_management/) for creating the relevant [database](/influxdb/v1.7/concepts/glossary/) and managing the [retention policy](/influxdb/v1.7/concepts/glossary/#retention-policy-rp).
If your database and retention policy already exist, your file can skip this section.
* **DML (Data Manipulation Language)**: Lists the relevant database and (if desired) retention policy and contains the data in [line protocol](/influxdb/v1.7/concepts/glossary/#line-protocol).
* **DML (Data Manipulation Language)**: Lists the relevant database and (if desired) retention policy and contains the data in [line protocol](/influxdb/v1.7/concepts/glossary/#influxdb-line-protocol).
Example:
@ -374,7 +374,7 @@ If you do not specify the retention policy, `influx` automatically queries the `
#### Write data to InfluxDB with `insert`
Enter `insert` followed by the data in [line protocol](/influxdb/v1.7/concepts/glossary/#line-protocol) to write data to InfluxDB.
Enter `insert` followed by the data in [line protocol](/influxdb/v1.7/concepts/glossary/#influxdb-line-protocol) to write data to InfluxDB.
Use `insert into <retention policy> <line protocol>` to write data to a specific [retention policy](/influxdb/v1.7/concepts/glossary/#retention-policy-rp).
Write data to a single field in the measurement `treasures` with the tag `captain_id = pirate_king`.

View File

@ -214,7 +214,7 @@ If you anticipate growing over 16TB per volume/file system, we recommend finding
## How do I manually trigger a compaction?
Trigger a full compaction after startup by adjusting the [`compact-full-write-cold-duration`](/influxdb/v1.7/administration/config/#compact-full-write-cold-duration-4h) setting in your InfluxDB configuration file. For more information, see [Using the configuration file](/influxdb/v1.7/administration/config/#using-the-configuration-file/). Consider the following items may affect the schedule for compaction:
Trigger a full compaction after startup by adjusting the [`compact-full-write-cold-duration`](/influxdb/v1.7/administration/config/#compact-full-write-cold-duration-4h) setting in your InfluxDB configuration file. For more information, see [Using the configuration file](/influxdb/v1.7/administration/config/#using-the-configuration-file). Consider the following items may affect the schedule for compaction:
- Shard duration and write patterns. For example, frequently writing to old shards may affect compaction.
- Number of concurrent compactions (`max-concurrent-compactions`). For example, multiple shards pending compaction may affect when a compaction is run.
@ -606,7 +606,7 @@ time sunflowers time mean
The most common reasons why your query returns no data or partial data:
- [Querying the wrong retention policy](#querying-wrong-retention-policy) (no data returned)
- [Querying the wrong retention policy](#querying-the-wrong-retention-policy) (no data returned)
- [No field key in the SELECT clause](#no-field-key-in-the-select-clause) (no data returned)
- [SELECT query includes `GROUP BY time()`](#select-query-includes-group-by-time) (partial data before `now()` returned)
- [Tag and field key with the same name](#tag-and-field-key-with-the-same-name)

View File

@ -28,4 +28,4 @@ It compiles into a single binary with no external dependencies.
* Continuous queries automatically compute aggregate data to make frequent queries more efficient.
The open source edition of InfluxDB runs on a single node.
If you require high availability to eliminate a single point of failure, consider the [InfluxDB Enterprise Edition](/{{< latest "influxdb" "v1" >}}/high_availability/).
If you require high availability to eliminate a single point of failure, consider the [InfluxDB Enterprise Edition](/{{< latest "enterprise_influxdb" "v1" >}}/high_availability/).

View File

@ -36,7 +36,7 @@ menu:
This release updates support for the Flux language and queries. To learn about Flux design principles and see how to get started with Flux, see [Introduction to Flux](/influxdb/v1.8/flux/).
* Use the new [`influx -type=flux`](/influxdb/v1.8/tools/shell/#type) option to enable the Flux REPL shell for creating Flux queries.
* Use the new [`influx -type=flux`](/influxdb/v1.8/tools/influx-cli/#flags) option to enable the Flux REPL shell for creating Flux queries.
* Flux v0.65 includes the following capabilities:
- Join data residing in multiple measurements, buckets, or data sources
@ -64,7 +64,7 @@ while readying your implementation for a move to InfluxDB 2.0 Cloud when you're
- Add [`influx inspect verify-tombstone` command](/influxdb/v1.8/tools/influx_inspect/#verify-tombstone)
- Add [offline series compaction to `influx_inspect buildtsi`](/influxdb/v1.8/administration/compact-series-file/).
If you're currently using the Time Series Index [(tsi1)](/influxdb/v1.8/concepts/time-series-index/), the index files grow over time and aren't automatically compacted. This tool enables an administrator to perform a compaction while the database is offline.
- Add support for connecting to a custom HTTP endpoint using `-url-prefix` in the [`influx` CLI](/influxdb/v1.8/tools/influx-cli/_index). This allows the Influx CLI to connect to an InfluxDB instance running behind a reverse proxy with a custom subpath `/` endpoint.
- Add support for connecting to a custom HTTP endpoint using `-url-prefix` in the [`influx` CLI](/influxdb/v1.8/tools/influx-cli/). This allows the Influx CLI to connect to an InfluxDB instance running behind a reverse proxy with a custom subpath `/` endpoint.
#### Security enhancements
- Add support for [TLS 1.3 configuration](/influxdb/v1.8/administration/config/#transport-layer-security-tls-settings) and update current list of [Go ciphers](https://golang.org/pkg/crypto/tls/#pkg-constants).

View File

@ -258,7 +258,7 @@ Database management:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`CREATE RETENTION POLICY`, `ALTER RETENTION POLICY`, and `DROP RETENTION POLICY`
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`CREATE CONTINUOUS QUERY` and `DROP CONTINUOUS QUERY`
See the [database management](/influxdb/v1.8/query_language/database_management/) and [continuous queries](/influxdb/v1.8/query_language/continuous_queries/) pages for a complete discussion of the commands listed above.
See the [database management](/influxdb/v1.8/query_language/manage-database/) and [continuous queries](/influxdb/v1.8/query_language/continuous_queries/) pages for a complete discussion of the commands listed above.
User management:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Admin user management:
@ -278,7 +278,7 @@ Non-admin users can have one of the following three privileges per database:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`ALL` (both `READ` and `WRITE` access)
`READ`, `WRITE`, and `ALL` privileges are controlled per user per database. A new non-admin user has no access to any database until they are specifically [granted privileges to a database](#grant-read-write-or-all-database-privileges-to-an-existing-user) by an admin user.
Non-admin users can [`SHOW`](/influxdb/v1.8/query_language/schema_exploration/#show-databases) the databases on which they have `READ` and/or `WRITE` permissions.
Non-admin users can [`SHOW`](/influxdb/v1.8/query_language/explore-schema/#show-databases) the databases on which they have `READ` and/or `WRITE` permissions.
### User management commands

View File

@ -276,7 +276,7 @@ Optional flags also include:
- `-retention <retention-policy-name>`
- This flag can be used to backup a specific retention policy. For more information on retention policies, see
[Retention policy management](/influxdb/v1.8/query_language/database_management/#retention-policy-management). If unspecified, all retention policies will be backed up.
[Retention policy management](/influxdb/v1.8/query_language/manage-database/#retention-policy-management). If unspecified, all retention policies will be backed up.
- `-shard <shard ID>` - This flag can be used to backup a specific
shard ID. To see which shards are available, you can run the command

View File

@ -522,7 +522,7 @@ The `[monitor]` section settings control the InfluxDB [system self-monitoring](h
By default, InfluxDB writes the data to the `_internal` database.
If that database does not exist, InfluxDB creates it automatically.
The `DEFAULT` retention policy on the `_internal` database is seven days.
If you want to use a retention policy other than the seven-day retention policy, you must [create](/influxdb/v1.8/query_language/database_management/#retention-policy-management) it.
If you want to use a retention policy other than the seven-day retention policy, you must [create](/influxdb/v1.8/query_language/manage-database/#retention-policy-management) it.
#### `store-enabled = true`

View File

@ -9,7 +9,7 @@ menu:
---
We recommend enabling Time Series Index (TSI) (step 3 of Upgrade to InfluxDB 1.8.x). [Switch between TSM and TSI](#switch-between-tsm-and-tsi-indexes) as needed. To learn more about TSI, see:
We recommend enabling Time Series Index (TSI) (step 3 of Upgrade to InfluxDB 1.8.x). [Switch between TSM and TSI](#switch-index-types) as needed. To learn more about TSI, see:
- [Time Series Index (TSI) overview](/influxdb/v1.8/concepts/time-series-index/)
- [Time Series Index (TSI) details](/influxdb/v1.8/concepts/tsi-details/)
@ -47,13 +47,13 @@ and see [Migrate to InfluxDB Enterprise](/{{< latest "enterprise_influxdb" >}}/g
Switch index types at any time by doing one of the following:
- To switch from to `inmem` to `tsi1`, complete steps 3 and 4 above in [Upgrade to InfluxDB 1.8.x](#upgrade-to-influxdb-1.8.x).
- To switch from to `tsi1` to `inmem`, change `tsi1` to `inmem` by completing steps 3a-3c and 4 above in [Upgrade to InfluxDB 1.8.x](#upgrade-to-influxdb-1.8.x).
- To switch from to `inmem` to `tsi1`, complete steps 3 and 4 above in [Upgrade to InfluxDB 1.8.x](#upgrade-to-influxdb-1-8-x).
- To switch from to `tsi1` to `inmem`, change `tsi1` to `inmem` by completing steps 3a-3c and 4 above in [Upgrade to InfluxDB 1.8.x](#upgrade-to-influxdb-1-8-x).
## Downgrade InfluxDB
To downgrade to an earlier version, complete the procedures above in [Upgrade to InfluxDB 1.8.x](#upgrade-to-influxdb-1-7-x), replacing the version numbers with the version that you want to downgrade to.
After downloading the release, migrating your configuration settings, and enabling TSI or TSM, make sure to [rebuild your index](/influxdb/v1.8/administration/rebuild-tsi-index/#sidebar).
To downgrade to an earlier version, complete the procedures above in [Upgrade to InfluxDB 1.8.x](#upgrade-to-influxdb-1-8-x), replacing the version numbers with the version that you want to downgrade to.
After downloading the release, migrating your configuration settings, and enabling TSI or TSM, make sure to [rebuild your index](/influxdb/v1.8/administration/rebuild-tsi-index/).
>**Note:** Some versions of InfluxDB may have breaking changes that impact your ability to upgrade and downgrade. For example, you cannot downgrade from InfluxDB 1.3 or later to an earlier version. Please review the applicable version of release notes to check for compatibility issues between releases.

View File

@ -123,7 +123,7 @@ InfluxDB supports multiple query languages:
[Flux](/flux/latest/introduction) is a data scripting language designed for querying, analyzing, and acting on time series data.
Beginning with **InfluxDB 1.8.0**, Flux is available for production use along side InfluxQL.
For those familiar with [InfluxQL](#influxql-and-sql), Flux is intended to address
For those familiar with [InfluxQL](#influxql), Flux is intended to address
many of the outstanding feature requests that we've received since introducing InfluxDB 1.0.
For a comparison between Flux and InfluxQL, see [Flux vs InfluxQL](/flux/latest/introduction/flux-vs-influxql).
@ -194,7 +194,7 @@ The options for specifying time durations with `now()` are:
| w | weeks |
InfluxQL also supports regular expressions, arithmetic in expressions, `SHOW` statements, and `GROUP BY` statements.
See our [data exploration](/influxdb/v1.8/query_language/data_exploration/) page for an in-depth discussion of those topics.
See our [data exploration](/influxdb/v1.8/query_language/explore-data/) page for an in-depth discussion of those topics.
InfluxQL functions include `COUNT`, `MIN`, `MAX`, `MEDIAN`, `DERIVATIVE` and more.
For a full list check out the [functions](/influxdb/v1.8/query_language/functions/) page.
@ -214,6 +214,6 @@ In addition, time series data is generally written once and rarely updated.
The result is that InfluxDB is not a full CRUD database but more like a CR-ud, prioritizing the performance of creating and reading data over update and destroy, and [preventing some update and destroy behaviors](/influxdb/v1.8/concepts/insights_tradeoffs/) to make create and read more performant:
* To update a point, insert one with [the same measurement, tag set, and timestamp](/influxdb/v1.8/troubleshooting/frequently-asked-questions/#how-does-influxdb-handle-duplicate-points).
* You can [drop or delete a series](/influxdb/v1.8/query_language/database_management/#drop-series-from-the-index-with-drop-series), but not individual points based on field values. As a workaround, you can search for the field value, retrieve the time, then [DELETE based on the `time` field](/influxdb/v1.8/query_language/database_management/#delete-series-with-delete).
* You can [drop or delete a series](/influxdb/v1.8/query_language/manage-database/#drop-series-from-the-index-with-drop-series), but not individual points based on field values. As a workaround, you can search for the field value, retrieve the time, then [DELETE based on the `time` field](/influxdb/v1.8/query_language/manage-database/#delete-series-with-delete).
* You can't update or rename tags yet - see GitHub issue [#4157](https://github.com/influxdata/influxdb/issues/4157) for more information. To modify the tag of a series of points, find the points with the offending tag value, change the value to the desired one, write the points back, then drop the series with the old tag value.
* You can't delete tags by tag key (as opposed to value) - see GitHub issue [#8604](https://github.com/influxdata/influxdb/issues/8604).

View File

@ -47,7 +47,7 @@ Related entries: [continuous query](/influxdb/v1.8/concepts/glossary/#continuous
The attribute of the retention policy that determines how long InfluxDB stores data.
Data older than the duration are automatically dropped from the database.
See [Database Management](/influxdb/v1.8/query_language/database_management/#create-retention-policies-with-create-retention-policy) for how to set duration.
See [Database Management](/influxdb/v1.8/query_language/manage-database/#create-retention-policies-with-create-retention-policy) for how to set duration.
Related entries: [retention policy](/influxdb/v1.8/concepts/glossary/#retention-policy-rp)
@ -160,7 +160,7 @@ Related entries: [point](/influxdb/v1.8/concepts/glossary/#point), [schema](/inf
## query
An operation that retrieves data from InfluxDB.
See [Data Exploration](/influxdb/v1.8/query_language/data_exploration/), [Schema Exploration](/influxdb/v1.8/query_language/schema_exploration/), [Database Management](/influxdb/v1.8/query_language/database_management/).
See [Data Exploration](/influxdb/v1.8/query_language/explore-data/), [Schema Exploration](/influxdb/v1.8/query_language/explore-schema/), [Database Management](/influxdb/v1.8/query_language/manage-database/).
## replication factor
@ -177,7 +177,7 @@ Related entries: [cluster](/influxdb/v0.10/concepts/glossary/#cluster), [duratio
Describes how long InfluxDB keeps data (duration), how many copies of the data to store in the cluster (replication factor), and the time range covered by shard groups (shard group duration). RPs are unique per database and along with the measurement and tag set define a series.
When you create a database, InfluxDB creates a retention policy called `autogen` with an infinite duration, a replication factor set to one, and a shard group duration set to seven days.
For more information, see [Retention policy management](/influxdb/v1.8/query_language/database_management/#retention-policy-management).
For more information, see [Retention policy management](/influxdb/v1.8/query_language/manage-database/#retention-policy-management).
Related entries: [duration](/influxdb/v1.8/concepts/glossary/#duration), [measurement](/influxdb/v1.8/concepts/glossary/#measurement), [replication factor](/influxdb/v1.8/concepts/glossary/#replication-factor), [series](/influxdb/v1.8/concepts/glossary/#series), [shard duration](/influxdb/v1.8/concepts/glossary/#shard-duration), [tag set](/influxdb/v1.8/concepts/glossary/#tag-set)
@ -275,7 +275,7 @@ Related entries: [series](/influxdb/v1.8/concepts/glossary/#series), [shard dura
The shard duration determines how much time each shard group spans.
The specific interval is determined by the `SHARD DURATION` of the retention policy.
See [Retention Policy management](/influxdb/v1.8/query_language/database_management/#retention-policy-management) for more information.
See [Retention Policy management](/influxdb/v1.8/query_language/manage-database/#retention-policy-management) for more information.
For example, given a retention policy with `SHARD DURATION` set to `1w`, each shard group will span a single week and contain all points with timestamps in that week.
@ -336,7 +336,7 @@ The date and time associated with a point.
All time in InfluxDB is UTC.
For how to specify time when writing data, see [Write Syntax](/influxdb/v1.8/write_protocols/write_syntax/).
For how to specify time when querying data, see [Data Exploration](/influxdb/v1.8/query_language/data_exploration/#time-syntax).
For how to specify time when querying data, see [Data Exploration](/influxdb/v1.8/query_language/explore-data/#time-syntax).
Related entries: [point](/influxdb/v1.8/concepts/glossary/#point)

View File

@ -162,7 +162,7 @@ The name `census` tells us that the field values record the number of `butterfli
A single measurement can belong to different retention policies.
A <a name="retention-policy"></a>_**retention policy**_ describes how long InfluxDB keeps data (`DURATION`) and how many copies of this data is stored in the cluster (`REPLICATION`).
If you're interested in reading more about retention policies, check out [Database Management](/influxdb/v1.8/query_language/database_management/#retention-policy-management).
If you're interested in reading more about retention policies, check out [Database Management](/influxdb/v1.8/query_language/manage-database/#retention-policy-management).
{{% warn %}} Replication factors do not serve a purpose with single node instances.
{{% /warn %}}

View File

@ -62,7 +62,7 @@ We recommend that you:
[Tags](/influxdb/v1.8/concepts/glossary/#tag) containing highly variable information like UUIDs, hashes, and random strings lead to a large number of [series](/influxdb/v1.8/concepts/glossary/#series) in the database, also known as high series cardinality. High series cardinality is a primary driver of high memory usage for many database workloads.
See [Hardware sizing guidelines](/influxdb/v1.8/guides/hardware_sizing/#general-hardware-guidelines-for-a-single-node) for [series cardinality](/influxdb/v1.8/concepts/glossary/#series-cardinality) recommendations based on your hardware. If the system has memory constraints, consider storing high-cardinality data as a field rather than a tag.
See [Hardware sizing guidelines](/influxdb/v1.8/guides/hardware_sizing/) for [series cardinality](/influxdb/v1.8/concepts/glossary/#series-cardinality) recommendations based on your hardware. If the system has memory constraints, consider storing high-cardinality data as a field rather than a tag.
#### Avoid the same name for a tag and a field
@ -197,7 +197,7 @@ If no shard group duration is provided, the shard group duration is determined b
| > 6 months | 7 days |
The shard group duration is also configurable per RP.
To configure the shard group duration, see [Retention Policy Management](/influxdb/v1.8/query_language/database_management/#retention-policy-management).
To configure the shard group duration, see [Retention Policy Management](/influxdb/v1.8/query_language/manage-database/#retention-policy-management).
### Shard group duration tradeoffs
@ -219,7 +219,7 @@ A shard group will only be removed once a shard group's duration *end time* is o
For example, if your RP has a duration of one day, InfluxDB will drop an hour's worth of data every hour and will always have 25 shard groups. One for each hour in the day and an extra shard group that is partially expiring, but isn't removed until the whole shard group is older than 24 hours.
>**Note:** A special use case to consider: filtering queries on schema data (such as tags, series, measurements) by time. For example, if you want to filter schema data within a one hour interval, you must set the shard group duration to 1h. For more information, see [filter schema data by time](/influxdb/v1.8/query_language/schema_exploration/#filter-meta-queries-by-time).
>**Note:** A special use case to consider: filtering queries on schema data (such as tags, series, measurements) by time. For example, if you want to filter schema data within a one hour interval, you must set the shard group duration to 1h. For more information, see [filter schema data by time](/influxdb/v1.8/query_language/explore-schema/#filter-meta-queries-by-time).
### Shard group duration recommendations
@ -234,7 +234,7 @@ Here are some recommendations for longer shard group durations:
| > 3 months | 30 days |
| infinite | 52 weeks or longer |
> **Note:** Note that `INF` (infinite) is not a [valid shard group duration](/influxdb/v1.8/query_language/database_management/#retention-policy-management).
> **Note:** Note that `INF` (infinite) is not a [valid shard group duration](/influxdb/v1.8/query_language/manage-database/#retention-policy-management).
In extreme cases where data covers decades and will never be deleted, a long shard group duration like `1040w` (20 years) is perfectly valid.
Other factors to consider before setting shard group duration:

View File

@ -30,11 +30,11 @@ index-version = "tsi1"
- To convert your data nodes to support TSI, see [Upgrade InfluxDB Enterprise clusters](/enterprise_influxdb/v1.8/administration/upgrading/).
- For detail on configuration, see [Configure InfluxDB Enterprise clusters](/enterprise_influxdb/v1.8/administration/configuration/#sidebar).
- For detail on configuration, see [Configure InfluxDB Enterprise clusters](/enterprise_influxdb/v1.8/administration/configuration/).
### InfluxDB OSS
- For detail on configuration, see [Configuring InfluxDB OSS](/influxdb/v1.8/administration/config/#sidebar).
- For detail on configuration, see [Configuring InfluxDB OSS](/influxdb/v1.8/administration/config/).
## Tooling

View File

@ -336,84 +336,84 @@ _For a complete list of Flux functions, [view all Flux functions](/{{< latest "i
### InfluxQL and Flux parity
| InfluxQL | Flux Functions |
| -------- | -------------- |
| [SELECT](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement) | [filter()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/filter/) |
| [WHERE](/influxdb/v1.8/query_language/explore-data/#the-where-clause) | [filter()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/filter/), [range()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/range/) |
| [GROUP BY](/influxdb/v1.8/query_language/explore-data/#the-group-by-clause) | [group()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/group/) |
| [INTO](/influxdb/v1.8/query_language/explore-data/#the-into-clause) | [to()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/outputs/to/) <span><a style="color:orange" href="#footnote">*</a></span> |
| [ORDER BY](/influxdb/v1.8/query_language/explore-data/#order-by-time-desc) | [sort()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/sort/) |
| [LIMIT](/influxdb/v1.8/query_language/explore-data/#the-limit-clause) | [limit()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/limit/) |
| [SLIMIT](/influxdb/v1.8/query_language/explore-data/#the-slimit-clause) | -- |
| [OFFSET](/influxdb/v1.8/query_language/explore-data/#the-offset-clause) | -- |
| [SOFFSET](/influxdb/v1.8/query_language/explore-data/#the-soffset-clause) | -- |
| [SHOW DATABASES](/influxdb/v1.8/query_language/explore-schema/#show-databases) | [buckets()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/inputs/buckets/) |
| [SHOW MEASUREMENTS](/influxdb/v1.8/query_language/explore-schema/#show-measurements) | [v1.measurements](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/measurements) |
| [SHOW FIELD KEYS](/influxdb/v1.8/query_language/explore-schema/#show-field-keys) | [keys()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/keys/) |
| [SHOW RETENTION POLICIES](/influxdb/v1.8/query_language/explore-schema/#show-retention-policies) | [buckets()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/inputs/buckets/) |
| [SHOW TAG KEYS](/influxdb/v1.8/query_language/explore-schema/#show-tag-keys) | [v1.tagKeys()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/tagkeys), [v1.measurementTagKeys()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/measurementtagkeys) |
| [SHOW TAG VALUES](/influxdb/v1.8/query_language/explore-schema/#show-tag-values) | [v1.tagValues()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/tagvalues), [v1.measurementTagValues()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/measurementtagvalues) |
| [SHOW SERIES](/influxdb/v1.8/query_language/explore-schema/#show-series) | -- |
| [CREATE DATABASE](/influxdb/v1.8/query_language/database_management/#create-database) | -- |
| [DROP DATABASE](/influxdb/v1.8/query_language/database_management/#delete-a-database-with-drop-database) | -- |
| [DROP SERIES](/influxdb/v1.8/query_language/database_management/#drop-series-from-the-index-with-drop-serie) | -- |
| [DELETE](/influxdb/v1.8/query_language/database_management/#delete-series-with-delete) | -- |
| [DROP MEASUREMENT](/influxdb/v1.8/query_language/database_management/#delete-measurements-with-drop-measurement) | -- |
| [DROP SHARD](/influxdb/v1.8/query_language/database_management/#delete-a-shard-with-drop-shard) | -- |
| [CREATE RETENTION POLICY](/influxdb/v1.8/query_language/database_management/#create-retention-policies-with-create-retention-policy) | -- |
| [ALTER RETENTION POLICY](/influxdb/v1.8/query_language/database_management/#modify-retention-policies-with-alter-retention-policy) | -- |
| [DROP RETENTION POLICY](/influxdb/v1.8/query_language/database_management/#delete-retention-policies-with-drop-retention-policy) | -- |
| [COUNT](/influxdb/v1.8/query_language/functions#count) | [count()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/count/) |
| [DISTINCT](/influxdb/v1.8/query_language/functions#distinct) | [distinct()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/distinct/) |
| [INTEGRAL](/influxdb/v1.8/query_language/functions#integral) | [integral()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/integral/) |
| [MEAN](/influxdb/v1.8/query_language/functions#mean) | [mean()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/mean/) |
| [MEDIAN](/influxdb/v1.8/query_language/functions#median) | [median()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/median/) |
| [MODE](/influxdb/v1.8/query_language/functions#mode) | [mode()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/mode/) |
| [SPREAD](/influxdb/v1.8/query_language/functions#spread) | [spread()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/spread/) |
| [STDDEV](/influxdb/v1.8/query_language/functions#stddev) | [stddev()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/stddev/) |
| [SUM](/influxdb/v1.8/query_language/functions#sum) | [sum()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/sum/) |
| [BOTTOM](/influxdb/v1.8/query_language/functions#bottom) | [bottom()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/bottom/) |
| [FIRST](/influxdb/v1.8/query_language/functions#first) | [first()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/first/) |
| [LAST](/influxdb/v1.8/query_language/functions#last) | [last()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/last/) |
| [MAX](/influxdb/v1.8/query_language/functions#max) | [max()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/max/) |
| [MIN](/influxdb/v1.8/query_language/functions#min) | [min()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/min/) |
| [PERCENTILE](/influxdb/v1.8/query_language/functions#percentile) | [quantile()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/quantile/) |
| [SAMPLE](/influxdb/v1.8/query_language/functions#sample) | [sample()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/sample/) |
| [TOP](/influxdb/v1.8/query_language/functions#top) | [top()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/top/) |
| [ABS](/influxdb/v1.8/query_language/functions#abs) | [math.abs()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/abs/) |
| [ACOS](/influxdb/v1.8/query_language/functions#acos) | [math.acos()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/acos/) |
| [ASIN](/influxdb/v1.8/query_language/functions#asin) | [math.asin()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/asin/) |
| [ATAN](/influxdb/v1.8/query_language/functions#atan) | [math.atan()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/atan/) |
| [ATAN2](/influxdb/v1.8/query_language/functions#atan2) | [math.atan2()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/atan2/) |
| [CEIL](/influxdb/v1.8/query_language/functions#ceil) | [math.ceil()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/ceil/) |
| [COS](/influxdb/v1.8/query_language/functions#cos) | [math.cos()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/cos/) |
| [CUMULATIVE_SUM](/influxdb/v1.8/query_language/functions#cumulative-sum) | [cumulativeSum()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/cumulativesum/) |
| [DERIVATIVE](/influxdb/v1.8/query_language/functions#derivative) | [derivative()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |
| [DIFFERENCE](/influxdb/v1.8/query_language/functions#difference) | [difference()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/difference/) |
| [ELAPSED](/influxdb/v1.8/query_language/functions#elapsed) | [elapsed()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/elapsed/) |
| [EXP](/influxdb/v1.8/query_language/functions#exp) | [math.exp()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/exp/) |
| [FLOOR](/influxdb/v1.8/query_language/functions#floor) | [math.floor()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/floor/) |
| [HISTOGRAM](/influxdb/v1.8/query_language/functions#histogram) | [histogram()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/histogram/) |
| [LN](/influxdb/v1.8/query_language/functions#ln) | [math.log()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log/) |
| [LOG](/influxdb/v1.8/query_language/functions#log) | [math.logb()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/logb/) |
| [LOG2](/influxdb/v1.8/query_language/functions#log2) | [math.log2()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log2/) |
| [LOG10](/influxdb/v1.8/query_language/functions#logt10) | [math.log10()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log10/) |
| [MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#moving-average) | [movingAverage()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/movingaverage/) |
| [NON_NEGATIVE_DERIVATIVE](/influxdb/v1.8/query_language/functions#non-negative-derivative) | [derivative(nonNegative:true)](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |
| [NON_NEGATIVE_DIFFERENCE](/influxdb/v1.8/query_language/functions#non-negative-difference) | [difference(nonNegative:true)](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |
| [POW](/influxdb/v1.8/query_language/functions#pow) | [math.pow()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/pow/) |
| [ROUND](/influxdb/v1.8/query_language/functions#round) | [math.round()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/round/) |
| [SIN](/influxdb/v1.8/query_language/functions#sin) | [math.sin()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/sin/) |
| [SQRT](/influxdb/v1.8/query_language/functions#sqrt) | [math.sqrt()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/sqrt/) |
| [TAN](/influxdb/v1.8/query_language/functions#tan) | [math.tan()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/tan/) |
| [HOLT_WINTERS](/influxdb/v1.8/query_language/functions#holt-winters) | [holtWinters()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/holtwinters/) |
| [CHANDE_MOMENTUM_OSCILLATOR](/influxdb/v1.8/query_language/functions#chande-momentum-oscillator) | [chandeMomentumOscillator()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/chandemomentumoscillator/) |
| [EXPONENTIAL_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#exponential-moving-average) | [exponentialMovingAverage()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/exponentialmovingaverage/) |
| [DOUBLE_EXPONENTIAL_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#double-exponential-moving-average) | [doubleEMA()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/doubleema/) |
| [KAUFMANS_EFFICIENCY_RATIO](/influxdb/v1.8/query_language/functions#kaufmans-efficiency-ratio) | [kaufmansER()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/kaufmanser/) |
| [KAUFMANS_ADAPTIVE_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#kaufmans-adaptive-moving-average) | [kaufmansAMA()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/kaufmansama/) |
| [TRIPLE_EXPONENTIAL_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#triple-exponential-moving-average) | [tripleEMA()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/tripleema/) |
| [TRIPLE_EXPONENTIAL_DERIVATIVE](/influxdb/v1.8/query_language/functions#triple-exponential-derivative) | [tripleExponentialDerivative()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/tripleexponentialderivative/) |
| [RELATIVE_STRENGTH_INDEX](/influxdb/v1.8/query_language/functions#relative-strength-index) | [relativeStrengthIndex()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/relativestrengthindex/) |
| InfluxQL | Flux Functions |
| -------- | -------------- |
| [SELECT](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement) | [filter()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/filter/) |
| [WHERE](/influxdb/v1.8/query_language/explore-data/#the-where-clause) | [filter()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/filter/), [range()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/range/) |
| [GROUP BY](/influxdb/v1.8/query_language/explore-data/#the-group-by-clause) | [group()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/group/) |
| [INTO](/influxdb/v1.8/query_language/explore-data/#the-into-clause) | [to()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/outputs/to/) <span><a style="color:orange" href="#footnote">*</a></span> |
| [ORDER BY](/influxdb/v1.8/query_language/explore-data/#order-by-time-desc) | [sort()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/sort/) |
| [LIMIT](/influxdb/v1.8/query_language/explore-data/#the-limit-clause) | [limit()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/limit/) |
| [SLIMIT](/influxdb/v1.8/query_language/explore-data/#the-slimit-clause) | -- |
| [OFFSET](/influxdb/v1.8/query_language/explore-data/#the-offset-clause) | -- |
| [SOFFSET](/influxdb/v1.8/query_language/explore-data/#the-soffset-clause) | -- |
| [SHOW DATABASES](/influxdb/v1.8/query_language/explore-schema/#show-databases) | [buckets()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/inputs/buckets/) |
| [SHOW MEASUREMENTS](/influxdb/v1.8/query_language/explore-schema/#show-measurements) | [v1.measurements](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/measurements) |
| [SHOW FIELD KEYS](/influxdb/v1.8/query_language/explore-schema/#show-field-keys) | [keys()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/keys/) |
| [SHOW RETENTION POLICIES](/influxdb/v1.8/query_language/explore-schema/#show-retention-policies) | [buckets()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/inputs/buckets/) |
| [SHOW TAG KEYS](/influxdb/v1.8/query_language/explore-schema/#show-tag-keys) | [v1.tagKeys()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/tagkeys), [v1.measurementTagKeys()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/measurementtagkeys) |
| [SHOW TAG VALUES](/influxdb/v1.8/query_language/explore-schema/#show-tag-values) | [v1.tagValues()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/tagvalues), [v1.measurementTagValues()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/influxdb-v1/measurementtagvalues) |
| [SHOW SERIES](/influxdb/v1.8/query_language/explore-schema/#show-series) | -- |
| [CREATE DATABASE](/influxdb/v1.8/query_language/manage-database/#create-database) | -- |
| [DROP DATABASE](/influxdb/v1.8/query_language/manage-database/#delete-a-database-with-drop-database) | -- |
| [DROP SERIES](/influxdb/v1.8/query_language/manage-database/#drop-series-from-the-index-with-drop-series) | -- |
| [DELETE](/influxdb/v1.8/query_language/manage-database/#delete-series-with-delete) | -- |
| [DROP MEASUREMENT](/influxdb/v1.8/query_language/manage-database/#delete-measurements-with-drop-measurement) | -- |
| [DROP SHARD](/influxdb/v1.8/query_language/manage-database/#delete-a-shard-with-drop-shard) | -- |
| [CREATE RETENTION POLICY](/influxdb/v1.8/query_language/manage-database/#create-retention-policies-with-create-retention-policy) | -- |
| [ALTER RETENTION POLICY](/influxdb/v1.8/query_language/manage-database/#modify-retention-policies-with-alter-retention-policy) | -- |
| [DROP RETENTION POLICY](/influxdb/v1.8/query_language/manage-database/#delete-retention-policies-with-drop-retention-policy) | -- |
| [COUNT](/influxdb/v1.8/query_language/functions#count) | [count()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/count/) |
| [DISTINCT](/influxdb/v1.8/query_language/functions#distinct) | [distinct()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/distinct/) |
| [INTEGRAL](/influxdb/v1.8/query_language/functions#integral) | [integral()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/integral/) |
| [MEAN](/influxdb/v1.8/query_language/functions#mean) | [mean()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/mean/) |
| [MEDIAN](/influxdb/v1.8/query_language/functions#median) | [median()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/median/) |
| [MODE](/influxdb/v1.8/query_language/functions#mode) | [mode()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/mode/) |
| [SPREAD](/influxdb/v1.8/query_language/functions#spread) | [spread()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/spread/) |
| [STDDEV](/influxdb/v1.8/query_language/functions#stddev) | [stddev()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/stddev/) |
| [SUM](/influxdb/v1.8/query_language/functions#sum) | [sum()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/sum/) |
| [BOTTOM](/influxdb/v1.8/query_language/functions#bottom) | [bottom()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/bottom/) |
| [FIRST](/influxdb/v1.8/query_language/functions#first) | [first()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/first/) |
| [LAST](/influxdb/v1.8/query_language/functions#last) | [last()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/last/) |
| [MAX](/influxdb/v1.8/query_language/functions#max) | [max()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/max/) |
| [MIN](/influxdb/v1.8/query_language/functions#min) | [min()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/min/) |
| [PERCENTILE](/influxdb/v1.8/query_language/functions#percentile) | [quantile()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/aggregates/quantile/) |
| [SAMPLE](/influxdb/v1.8/query_language/functions#sample) | [sample()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/sample/) |
| [TOP](/influxdb/v1.8/query_language/functions#top) | [top()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/selectors/top/) |
| [ABS](/influxdb/v1.8/query_language/functions#abs) | [math.abs()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/abs/) |
| [ACOS](/influxdb/v1.8/query_language/functions#acos) | [math.acos()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/acos/) |
| [ASIN](/influxdb/v1.8/query_language/functions#asin) | [math.asin()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/asin/) |
| [ATAN](/influxdb/v1.8/query_language/functions#atan) | [math.atan()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/atan/) |
| [ATAN2](/influxdb/v1.8/query_language/functions#atan2) | [math.atan2()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/atan2/) |
| [CEIL](/influxdb/v1.8/query_language/functions#ceil) | [math.ceil()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/ceil/) |
| [COS](/influxdb/v1.8/query_language/functions#cos) | [math.cos()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/cos/) |
| [CUMULATIVE_SUM](/influxdb/v1.8/query_language/functions#cumulative-sum) | [cumulativeSum()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/cumulativesum/) |
| [DERIVATIVE](/influxdb/v1.8/query_language/functions#derivative) | [derivative()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |
| [DIFFERENCE](/influxdb/v1.8/query_language/functions#difference) | [difference()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/difference/) |
| [ELAPSED](/influxdb/v1.8/query_language/functions#elapsed) | [elapsed()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/elapsed/) |
| [EXP](/influxdb/v1.8/query_language/functions#exp) | [math.exp()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/exp/) |
| [FLOOR](/influxdb/v1.8/query_language/functions#floor) | [math.floor()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/floor/) |
| [HISTOGRAM](/influxdb/v1.8/query_language/functions#histogram) | [histogram()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/histogram/) |
| [LN](/influxdb/v1.8/query_language/functions#ln) | [math.log()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log/) |
| [LOG](/influxdb/v1.8/query_language/functions#log) | [math.logb()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/logb/) |
| [LOG2](/influxdb/v1.8/query_language/functions#log2) | [math.log2()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log2/) |
| [LOG10](/influxdb/v1.8/query_language/functions/#log10) | [math.log10()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/log10/) |
| [MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#moving-average) | [movingAverage()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/movingaverage/) |
| [NON_NEGATIVE_DERIVATIVE](/influxdb/v1.8/query_language/functions#non-negative-derivative) | [derivative(nonNegative:true)](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |
| [NON_NEGATIVE_DIFFERENCE](/influxdb/v1.8/query_language/functions#non-negative-difference) | [difference(nonNegative:true)](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/derivative/) |
| [POW](/influxdb/v1.8/query_language/functions#pow) | [math.pow()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/pow/) |
| [ROUND](/influxdb/v1.8/query_language/functions#round) | [math.round()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/round/) |
| [SIN](/influxdb/v1.8/query_language/functions#sin) | [math.sin()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/sin/) |
| [SQRT](/influxdb/v1.8/query_language/functions#sqrt) | [math.sqrt()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/sqrt/) |
| [TAN](/influxdb/v1.8/query_language/functions#tan) | [math.tan()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/math/tan/) |
| [HOLT_WINTERS](/influxdb/v1.8/query_language/functions#holt-winters) | [holtWinters()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/holtwinters/) |
| [CHANDE_MOMENTUM_OSCILLATOR](/influxdb/v1.8/query_language/functions#chande-momentum-oscillator) | [chandeMomentumOscillator()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/chandemomentumoscillator/) |
| [EXPONENTIAL_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#exponential-moving-average) | [exponentialMovingAverage()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/exponentialmovingaverage/) |
| [DOUBLE_EXPONENTIAL_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#double-exponential-moving-average) | [doubleEMA()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/doubleema/) |
| [KAUFMANS_EFFICIENCY_RATIO](/influxdb/v1.8/query_language/functions#kaufmans-efficiency-ratio) | [kaufmansER()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/kaufmanser/) |
| [KAUFMANS_ADAPTIVE_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#kaufmans-adaptive-moving-average) | [kaufmansAMA()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/kaufmansama/) |
| [TRIPLE_EXPONENTIAL_MOVING_AVERAGE](/influxdb/v1.8/query_language/functions#triple-exponential-moving-average) | [tripleEMA()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/tripleema/) |
| [TRIPLE_EXPONENTIAL_DERIVATIVE](/influxdb/v1.8/query_language/functions#triple-exponential-derivative) | [tripleExponentialDerivative()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/tripleexponentialderivative/) |
| [RELATIVE_STRENGTH_INDEX](/influxdb/v1.8/query_language/functions#relative-strength-index) | [relativeStrengthIndex()](/{{< latest "influxdb" "v2" >}}/reference/flux/stdlib/built-in/transformations/relativestrengthindex/) |
_<span style="font-size:.9rem" id="footnote"><span style="color:orange">*</span> The <code>to()</code> function only writes to InfluxDB 2.0.</span>_

View File

@ -148,7 +148,7 @@ Sample sensor information is stored in PostgreSQL.
`air-sensor-data.rb` is a script that generates air sensor data and stores the data in InfluxDB.
To use `air-sensor-data.rb`:
1. [Create a database](/influxdb/v1.8/introduction/getting-started/#creating-a-database) to store the data.
1. [Create a database](/influxdb/v1.8/introduction/get-started/#creating-a-database) to store the data.
2. Download the sample data generator. _This tool requires [Ruby](https://www.ruby-lang.org/en/)._
<a class="btn download" style="color:#fff" href="/downloads/air-sensor-data.rb" download>Download Air Sensor Generator</a>

View File

@ -32,7 +32,7 @@ Learn how to calculate a percentage using the following examples:
- [Calculate a percentage from two fields](#calculate-a-percentage-from-two-fields)
- [Calculate a percentage using aggregate functions](#calculate-a-percentage-using-aggregate-functions)
- [Calculate the percentage of total weight per apple variety](#calculate-the-percentage-of-total-weight-per-apple-variety)
- [Calculate the aggregate percentage per variety](#calculate-the-aggregate-percentage-per-variety)
- [Calculate the aggregate percentage per variety](#calculate-the-percentage-of-total-weight-per-apple-variety)
## Basic calculations within a query
@ -41,7 +41,7 @@ When performing any math operation in a Flux query, you must complete the follow
1. Specify the [bucket](/flux/latest/introduction/getting-started/#buckets) to query from and the time range to query.
2. Filter your data by measurements, fields, and other applicable criteria.
3. Align values in one row (required to perform math in Flux) by using one of the following functions:
- To query **from multiple** data sources, use the [`join()` function](flux/latest/stdlib/built-in/transformations/join).
- To query **from multiple** data sources, use the [`join()` function](/flux/latest/stdlib/built-in/transformations/join/).
- To query **from the same** data source, use the [`pivot()` function](/flux/latest/stdlib/built-in/transformations/pivot/).
For examples using the `join()` function to calculate percentages and more examples of calculating percentages, see [Calculate percentages with Flux](/flux/latest/guides/calculate-percentages/).

View File

@ -27,7 +27,7 @@ This guide doesn't go into detail about the syntax for creating and managing CQs
If you're new to these concepts, we recommend reviewing the following:
- [CQ documentation](/influxdb/v1.8/query_language/continuous_queries/) and
- [RP documentation](/influxdb/v1.8/query_language/database_management/#retention-policy-management).
- [RP documentation](/influxdb/v1.8/query_language/manage-database/#retention-policy-management).
### Sample data
@ -81,7 +81,7 @@ We make the `DEFAULT` RP keep data for two hours, because we want InfluxDB to
automatically write the incoming ten-second resolution data to that RP.
Use the
[`CREATE RETENTION POLICY`](/influxdb/v1.8/query_language/database_management/#create-retention-policies-with-create-retention-policy)
[`CREATE RETENTION POLICY`](/influxdb/v1.8/query_language/manage-database/#create-retention-policies-with-create-retention-policy)
statement to create a `DEFAULT` RP:
```sql
@ -112,7 +112,7 @@ Next we want to create another retention policy that keeps data for 52 weeks and
Ultimately, the 30-minute rollup data will be stored in this RP.
Use the
[`CREATE RETENTION POLICY`](/influxdb/v1.8/query_language/database_management/#create-retention-policies-with-create-retention-policy)
[`CREATE RETENTION POLICY`](/influxdb/v1.8/query_language/manage-database/#create-retention-policies-with-create-retention-policy)
statement to create a non-`DEFAULT` retention policy:
```sql
@ -219,5 +219,5 @@ Using a combination of RPs and CQs, we've successfully set up our database to
automatically keep the high precision raw data for a limited time, create lower
precision data, and store that lower precision data for a longer period of time.
Now that you have a general understanding of how these features can work
together, check out the detailed documentation on [CQs](/influxdb/v1.8/query_language/continuous_queries/) and [RPs](/influxdb/v1.8/query_language/database_management/#retention-policy-management)
together, check out the detailed documentation on [CQs](/influxdb/v1.8/query_language/continuous_queries/) and [RPs](/influxdb/v1.8/query_language/manage-database/#retention-policy-management)
to see all that they can do for you.

View File

@ -106,5 +106,5 @@ While this is useful for debugging or when querying directly with tools like `cu
### InfluxQL
Check out the [Data Exploration page](/influxdb/v1.8/query_language/data_exploration/) to get acquainted with InfluxQL.
Check out the [Data Exploration page](/influxdb/v1.8/query_language/explore-data/) to get acquainted with InfluxQL.
For more information about querying data with the InfluxDB API using InfluxQL, see the [API reference documentation](/influxdb/v1.8/tools/api/#influxdb-1-x-http-endpoints).

View File

@ -35,7 +35,7 @@ curl -i -XPOST 'http://localhost:8086/write?db=mydb'
--data-binary 'cpu_load_short,host=server01,region=us-west value=0.64 1434055562000000000'
```
- To **write to a database using the InfluxDB 2.0 API (compatible with InfluxDB 1.8+)**, send `POST` requests to the [`/api/v2/write` endpoint](/influxdb/v1.8/tools/api/#client-libraries):
- To **write to a database using the InfluxDB 2.0 API (compatible with InfluxDB 1.8+)**, send `POST` requests to the [`/api/v2/write` endpoint](/influxdb/v1.8/tools/api/#api-v2-write-http-endpoint):
```bash
curl -i -XPOST 'http://localhost:8086/api/v2/write?bucket=db/rp&precision=ns' \

View File

@ -39,7 +39,7 @@ InfluxDB shell 1.8.x
* The InfluxDB API runs on port `8086` by default.
Therefore, `influx` will connect to port `8086` and `localhost` by default.
If you need to alter these defaults, run `influx --help`.
* The [`-precision` argument](/influxdb/v1.8/tools/shell/#influx-options) specifies the format/precision of any returned timestamps.
* The [`-precision` argument](/influxdb/v1.8/tools/shell/#influx-arguments) specifies the format/precision of any returned timestamps.
In the example above, `rfc3339` tells InfluxDB to return timestamps in [RFC3339 format](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ`).
The command line is now ready to take input in the form of the Influx Query Language (a.k.a InfluxQL) statements.

View File

@ -19,25 +19,25 @@ Feel free to download the dataset provided in
[Sample Data](/influxdb/v1.8/query_language/data_download/) and follow along
with the documentation.
#### [Data exploration](/influxdb/v1.8/query_language/data_exploration/)
#### [Data exploration](/influxdb/v1.8/query_language/explore-data/)
Covers the query language basics for InfluxQL, including the
[`SELECT` statement](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement),
[`GROUP BY` clauses](/influxdb/v1.8/query_language/data_exploration/#the-group-by-clause),
[`INTO` clauses](/influxdb/v1.8/query_language/data_exploration/#the-into-clause), and more.
[`SELECT` statement](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement),
[`GROUP BY` clauses](/influxdb/v1.8/query_language/explore-data/#the-group-by-clause),
[`INTO` clauses](/influxdb/v1.8/query_language/explore-data/#the-into-clause), and more.
See Data Exploration to learn about
[time syntax](/influxdb/v1.8/query_language/data_exploration/#time-syntax) and
[regular expressions](/influxdb/v1.8/query_language/data_exploration/#regular-expressions) in
[time syntax](/influxdb/v1.8/query_language/explore-data/#time-syntax) and
[regular expressions](/influxdb/v1.8/query_language/explore-data/#regular-expressions) in
queries.
#### [Schema exploration](/influxdb/v1.8/query_language/schema_exploration/)
#### [Schema exploration](/influxdb/v1.8/query_language/explore-schema/)
Covers queries that are useful for viewing and exploring your
[schema](/influxdb/v1.8/concepts/glossary/#schema).
See Schema Exploration for syntax explanations and examples of InfluxQL's `SHOW`
queries.
#### [Database management](/influxdb/v1.8/query_language/database_management/)
#### [Database management](/influxdb/v1.8/query_language/manage-database/)
Covers InfluxQL for managing
[databases](/influxdb/v1.8/concepts/glossary/#database) and

View File

@ -158,7 +158,7 @@ time mean
##### Automatically downsampling data into another retention policy
[Fully qualify](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement)
[Fully qualify](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement)
the destination measurement to store the downsampled data in a non-`DEFAULT`
[retention policy](/influxdb/v1.8/concepts/glossary/#retention-policy-rp) (RP).
@ -220,7 +220,7 @@ guide for an in-depth discussion about this CQ use case.
##### Automatically downsampling a database with backreferencing
Use a function with a wildcard (`*`) and `INTO` query's
[backreferencing syntax](/influxdb/v1.8/query_language/data_exploration/#the-into-clause)
[backreferencing syntax](/influxdb/v1.8/query_language/explore-data/#the-into-clause)
to automatically downsample data from all measurements and numerical fields in
a database.
@ -289,7 +289,7 @@ time mean_complaints mean_passengers
##### Automatically downsampling data and configuring CQ time boundaries
Use an
[offset interval](/influxdb/v1.8/query_language/data_exploration/#advanced-group-by-time-syntax)
[offset interval](/influxdb/v1.8/query_language/explore-data/#advanced-group-by-time-syntax)
in the `GROUP BY time()` clause to alter both the CQ's default execution time and
preset time boundaries.
@ -357,11 +357,11 @@ CQs do not write any results for a time interval if no data fall within that
time range.
Note that the basic syntax does not support using
[`fill()`](/influxdb/v1.8/query_language/data_exploration/#group-by-time-intervals-and-fill)
[`fill()`](/influxdb/v1.8/query_language/explore-data/#group-by-time-intervals-and-fill)
to change the value reported for intervals with no data.
Basic syntax CQs ignore `fill()` if it's included in the CQ query.
A possible workaround is to use the
[advanced CQ syntax](#example-4-configuring-cq-time-ranges-and-filling-empty-results).
[advanced CQ syntax](#advanced-syntax).
##### Resampling previous time intervals
@ -375,13 +375,13 @@ time range.
CQs operate on realtime data, that is, data with timestamps that occur
relative to [`now()`](/influxdb/v1.8/concepts/glossary/#now).
Use a basic
[`INTO` query](/influxdb/v1.8/query_language/data_exploration/#the-into-clause)
[`INTO` query](/influxdb/v1.8/query_language/explore-data/#the-into-clause)
to backfill results for data with older timestamps.
##### Missing tags in the CQ results
By default, all
[`INTO` queries](/influxdb/v1.8/query_language/data_exploration/#the-into-clause)
[`INTO` queries](/influxdb/v1.8/query_language/explore-data/#the-into-clause)
convert any tags in the source measurement to fields in the destination
measurement.
@ -887,8 +887,8 @@ InfluxQL does not support [`HAVING` clauses](https://en.wikipedia.org/wiki/Havin
Get the same functionality by creating a CQ to aggregate the data and querying
the CQ results to apply the `HAVING` clause.
> **Note:** InfluxQL supports [subqueries](/influxdb/v1.8/query_language/data_exploration/#subqueries) which also offer similar functionality to `HAVING` clauses.
See [Data Exploration](/influxdb/v1.8/query_language/data_exploration/#subqueries) for more information.
> **Note:** InfluxQL supports [subqueries](/influxdb/v1.8/query_language/explore-data/#subqueries) which also offer similar functionality to `HAVING` clauses.
See [Data Exploration](/influxdb/v1.8/query_language/explore-data/#subqueries) for more information.
##### Example
@ -935,8 +935,8 @@ If your function does not support nesting, you can get the same functionality us
the inner-most function.
Then simply query the CQ results to calculate the outer-most function.
> **Note:** InfluxQL supports [subqueries](/influxdb/v1.8/query_language/data_exploration/#subqueries) which also offer the same functionality as nested functions.
See [Data Exploration](/influxdb/v1.8/query_language/data_exploration/#subqueries) for more information.
> **Note:** InfluxQL supports [subqueries](/influxdb/v1.8/query_language/explore-data/#subqueries) which also offer the same functionality as nested functions.
See [Data Exploration](/influxdb/v1.8/query_language/explore-data/#subqueries) for more information.
##### Example

View File

@ -8,7 +8,7 @@ menu:
weight: 20
parent: InfluxQL
aliases:
- /influxdb/v1.8/query_language/data_exploration/
- /influxdb/v1.8/query_language/explore-data/
---
InfluxQL is an SQL-like query language for interacting with data in InfluxDB.
@ -1735,7 +1735,7 @@ The query above writes all data in the `NOAA_water_database` and `autogen` reten
The [backreference](#examples-5) syntax (`:MEASUREMENT`) maintains the source measurement names in the destination database.
Note that both the `copy_NOAA_water_database` database and its `autogen` retention policy must exist prior to running the `INTO` query.
See [Database Management](/influxdb/v1.8/query_language/database_management/)
See [Database Management](/influxdb/v1.8/query_language/manage-database/)
for how to manage databases and retention policies.
The `GROUP BY *` clause [preserves tags](#missing-data) in the source database as tags in the destination database.
@ -1824,7 +1824,7 @@ InfluxDB writes the data to the `where_else` database and to the `autogen`
retention policy.
Note that both `where_else` and `autogen` must exist prior to running the `INTO`
query.
See [Database Management](/influxdb/v1.8/query_language/database_management/)
See [Database Management](/influxdb/v1.8/query_language/manage-database/)
for how to manage databases and retention policies.
The response shows the number of points (`7605`) that InfluxDB writes to `h2o_feet_copy_2`.
@ -1911,7 +1911,7 @@ in the `FROM` clause and writes the results to measurements with the same name i
`where_else` database and the `autogen` retention policy.
Note that both `where_else` and `autogen` must exist prior to running the `INTO`
query.
See [Database management](/influxdb/v1.8/query_language/database_management/)
See [Database management](/influxdb/v1.8/query_language/manage-database/)
for how to manage databases and retention policies.
The response shows the number of points (`5`) that InfluxDB writes to the `where_else`
@ -2385,7 +2385,7 @@ SELECT_clause [INTO_clause] FROM_clause [WHERE_clause] [GROUP_BY_clause] [ORDER_
By default, InfluxDB stores and returns timestamps in UTC.
The `tz()` clause includes the UTC offset or, if applicable, the UTC Daylight Savings Time (DST) offset to the query's returned timestamps.
The returned timestamps must be in [RFC3339 format](/influxdb/v1.8/query_language/data_exploration/#configuring-the-returned-timestamps) for the UTC offset or UTC DST to appear.
The returned timestamps must be in [RFC3339 format](/influxdb/v1.8/query_language/explore-data/#configuring-the-returned-timestamps) for the UTC offset or UTC DST to appear.
The `time_zone` parameter follows the TZ syntax in the [Internet Assigned Numbers Authority time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List) and it requires single quotes.
### Examples

View File

@ -7,7 +7,7 @@ menu:
weight: 30
parent: InfluxQL
aliases:
- /influxdb/v1.8/query_language/schema_exploration/
- /influxdb/v1.8/query_language/explore-schema/
---
InfluxQL is an SQL-like query language for interacting with data in InfluxDB.
@ -200,10 +200,10 @@ Supported operators in the `WHERE` clause:
`!~`&emsp;doesn't match against
See the Data Exploration page for documentation on the
[`FROM` clause](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement),
[`LIMIT` clause](/influxdb/v1.8/query_language/data_exploration/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/data_exploration/#the-offset-clause),
and on [Regular Expressions in Queries](/influxdb/v1.8/query_language/data_exploration/#regular-expressions).
[`FROM` clause](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement),
[`LIMIT` clause](/influxdb/v1.8/query_language/explore-data/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/explore-data/#the-offset-clause),
and on [Regular Expressions in Queries](/influxdb/v1.8/query_language/explore-data/#regular-expressions).
### Examples
@ -432,9 +432,9 @@ Supported operators in the `WHERE` clause:
`!~`&emsp;doesn't match against
See the Data Exploration page for documentation on the
[`LIMIT` clause](/influxdb/v1.8/query_language/data_exploration/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/data_exploration/#the-offset-clause),
and on [Regular expressions in queries](/influxdb/v1.8/query_language/data_exploration/#regular-expressions).
[`LIMIT` clause](/influxdb/v1.8/query_language/explore-data/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/explore-data/#the-offset-clause),
and on [Regular expressions in queries](/influxdb/v1.8/query_language/explore-data/#regular-expressions).
### Examples
@ -592,10 +592,10 @@ Supported operators in the `WHERE` clause:
`!~`&emsp;doesn't match against
See the Data Exploration page for documentation on the
[`FROM` clause](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement),
[`LIMIT` clause](/influxdb/v1.8/query_language/data_exploration/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/data_exploration/#the-offset-clause),
and on [Regular Expressions in Queries](/influxdb/v1.8/query_language/data_exploration/#regular-expressions).
[`FROM` clause](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement),
[`LIMIT` clause](/influxdb/v1.8/query_language/explore-data/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/explore-data/#the-offset-clause),
and on [Regular Expressions in Queries](/influxdb/v1.8/query_language/explore-data/#regular-expressions).
### Examples
@ -809,10 +809,10 @@ Supported operators in the `WITH` and `WHERE` clauses:
`!~`&emsp;doesn't match against
See the Data Exploration page for documentation on the
[`FROM` clause](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement),
[`LIMIT` clause](/influxdb/v1.8/query_language/data_exploration/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/data_exploration/#the-offset-clause),
and on [Regular Expressions in Queries](/influxdb/v1.8/query_language/data_exploration/#regular-expressions).
[`FROM` clause](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement),
[`LIMIT` clause](/influxdb/v1.8/query_language/explore-data/#the-limit-clause),
[`OFFSET` clause](/influxdb/v1.8/query_language/explore-data/#the-offset-clause),
and on [Regular Expressions in Queries](/influxdb/v1.8/query_language/explore-data/#regular-expressions).
### Examples
@ -940,7 +940,7 @@ string parameter in the [InfluxDB API](/influxdb/v1.8/tools/api/#query-string-pa
The `FROM` clause is also optional.
See the Data Exploration page for documentation on the
[`FROM` clause](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement).
[`FROM` clause](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement).
> **Note:** A field's data type [can differ](/influxdb/v1.8/troubleshooting/frequently-asked-questions/#how-does-influxdb-handle-field-type-discrepancies-across-shards) across
[shards](/influxdb/v1.8/concepts/glossary/#shard).
@ -1178,7 +1178,7 @@ The example below shows how to filter `SHOW TAG KEYS` by approximately one hour
#### Example filtering `SHOW TAG KEYS` by time
1. Specify a shard duration on a new database or [alter an existing shard duration](/influxdb/v1.8/query_language/database_management/#modify-retention-policies-with-alter-retention-policy). To specify a 1h shard duration when creating a new database, run the following command:
1. Specify a shard duration on a new database or [alter an existing shard duration](/influxdb/v1.8/query_language/manage-database/#modify-retention-policies-with-alter-retention-policy). To specify a 1h shard duration when creating a new database, run the following command:
```sh
> CREATE database mydb with duration 7d REPLICATION 1 SHARD DURATION 1h name myRP;

File diff suppressed because it is too large Load Diff

View File

@ -8,7 +8,7 @@ menu:
weight: 40
parent: InfluxQL
aliases:
- /influxdb/v1.8/query_language/database_management/
- /influxdb/v1.8/query_language/manage-database/
---
InfluxQL offers a full suite of administrative commands.
@ -44,7 +44,7 @@ InfluxQL offers a full suite of administrative commands.
</tr>
</table>
If you're looking for `SHOW` queries (for example, `SHOW DATABASES` or `SHOW RETENTION POLICIES`), see [Schema Exploration](/influxdb/v1.8/query_language/schema_exploration).
If you're looking for `SHOW` queries (for example, `SHOW DATABASES` or `SHOW RETENTION POLICIES`), see [Schema Exploration](/influxdb/v1.8/query_language/explore-schema).
The examples in the sections below use the InfluxDB [Command Line Interface (CLI)](/influxdb/v1.8/introduction/getting-started/).
You can also execute the commands using the InfluxDB API; simply send a `GET` request to the `/query` endpoint and include the command in the URL parameter `q`.
@ -72,7 +72,7 @@ CREATE DATABASE <database_name> [WITH [DURATION <duration>] [REPLICATION <n>] [S
The `WITH`, `DURATION`, `REPLICATION`, `SHARD DURATION`, and `NAME` clauses are optional and create a single [retention policy](/influxdb/v1.8/concepts/glossary/#retention-policy-rp) associated with the created database.
If you do not specify one of the clauses after `WITH`, the relevant behavior defaults to the `autogen` retention policy settings.
The created retention policy automatically serves as the database's default retention policy.
For more information about those clauses, see [Retention Policy Management](/influxdb/v1.8/query_language/database_management/#retention-policy-management).
For more information about those clauses, see [Retention Policy Management](/influxdb/v1.8/query_language/manage-database/#retention-policy-management).
A successful `CREATE DATABASE` query returns an empty result.
If you attempt to create a database that already exists, InfluxDB does nothing and does not return an error.
@ -123,7 +123,7 @@ and it drops the series from the index.
> **Note:** `DROP SERIES` does not support time intervals in the `WHERE` clause.
See
[`DELETE`](/influxdb/v1.8/query_language/database_management/#delete-series-with-delete)
[`DELETE`](/influxdb/v1.8/query_language/manage-database/#delete-series-with-delete)
for that functionality.
The query takes the following form, where you must specify either the `FROM` clause or the `WHERE` clause:
@ -153,7 +153,7 @@ A successful `DROP SERIES` query returns an empty result.
The `DELETE` query deletes all points from a
[series](/influxdb/v1.8/concepts/glossary/#series) in a database.
Unlike
[`DROP SERIES`](/influxdb/v1.8/query_language/database_management/#drop-series-from-the-index-with-drop-series), it does not drop the series from the index and it supports time intervals
[`DROP SERIES`](/influxdb/v1.8/query_language/manage-database/#drop-series-from-the-index-with-drop-series), it does not drop the series from the index and it supports time intervals
in the `WHERE` clause.
The query takes the following form where you must include either the `FROM`
@ -183,7 +183,7 @@ A successful `DELETE` query returns an empty result.
Things to note about `DELETE`:
* `DELETE` supports
[regular expressions](/influxdb/v1.8/query_language/data_exploration/#regular-expressions)
[regular expressions](/influxdb/v1.8/query_language/explore-data/#regular-expressions)
in the `FROM` clause when specifying measurement names and in the `WHERE` clause
when specifying tag values.
* `DELETE` does not support [fields](/influxdb/v1.8/concepts/glossary/#field) in the `WHERE` clause.
@ -321,7 +321,7 @@ If you attempt to create a retention policy identical to one that already exists
If you attempt to create a retention policy with the same name as an existing retention policy but with differing attributes, InfluxDB returns an error.
> **Note:** You can also specify a new retention policy in the `CREATE DATABASE` query.
See [Create a database with CREATE DATABASE](/influxdb/v1.8/query_language/database_management/#create-database).
See [Create a database with CREATE DATABASE](/influxdb/v1.8/query_language/manage-database/#create-database).
### Modify retention policies with ALTER RETENTION POLICY

View File

@ -211,7 +211,7 @@ SELECT * FROM "data" WHERE "bitfield" ^ 6 > 0
### Common Issues with Mathematical Operators
#### Issue 1: Mathematical operators with wildcards and regular expressions
InfluxDB does not support combining mathematical operations with a wildcard (`*`) or [regular expression](/influxdb/v1.8/query_language/data_exploration/#regular-expressions) in the `SELECT` clause.
InfluxDB does not support combining mathematical operations with a wildcard (`*`) or [regular expression](/influxdb/v1.8/query_language/explore-data/#regular-expressions) in the `SELECT` clause.
The following queries are invalid and the system returns an error:
Perform a mathematical operation on a wildcard.
@ -254,8 +254,8 @@ SELECT mean(10 * "value") FROM "cpu"
```
will yield a parse error.
> InfluxQL supports [subqueries](/influxdb/v1.8/query_language/data_exploration/#subqueries) which offer similar functionality to using mathematical operators inside a function call.
See [Data Exploration](/influxdb/v1.8/query_language/data_exploration/#subqueries) for more information.
> InfluxQL supports [subqueries](/influxdb/v1.8/query_language/explore-data/#subqueries) which offer similar functionality to using mathematical operators inside a function call.
See [Data Exploration](/influxdb/v1.8/query_language/explore-data/#subqueries) for more information.
## Unsupported Operators

View File

@ -34,7 +34,7 @@ InfluxDB shell 1.4.x
* The InfluxDB API runs on port `8086` by default.
Therefore, `influx` will connect to port `8086` and `localhost` by default.
If you need to alter these defaults, run `influx --help`.
* The [`-precision` argument](/influxdb/v1.8/tools/shell/#influx-options) specifies the format/precision of any returned timestamps.
* The [`-precision` argument](/influxdb/v1.8/tools/shell/#influx-arguments) specifies the format/precision of any returned timestamps.
In the example above, `rfc3339` tells InfluxDB to return timestamps in [RFC3339 format](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ`).
The command line is now ready to take input in the form of the Influx Query Language (a.k.a InfluxQL) statements.

View File

@ -26,9 +26,9 @@ Find Influx Query Language (InfluxQL) definitions and details, including:
To learn more about InfluxQL, browse the following topics:
* [Explore your data with InfluxQL](/influxdb/v1.8/query_language/data_exploration/)
* [Explore your schema with InfluxQL](/influxdb/v1.8/query_language/schema_exploration/)
* [Database management](/influxdb/v1.8/query_language/database_management/)
* [Explore your data with InfluxQL](/influxdb/v1.8/query_language/explore-data/)
* [Explore your schema with InfluxQL](/influxdb/v1.8/query_language/explore-schema/)
* [Database management](/influxdb/v1.8/query_language/manage-database/)
* [Authentication and authorization](/influxdb/v1.8/administration/authentication_and_authorization/).
InfluxQL is a SQL-like query language for interacting with InfluxDB and providing features specific to storing and analyzing time series data.
@ -229,10 +229,10 @@ regex_lit = "/" { unicode_char } "/" .
> **Note:** InfluxQL supports using regular expressions when specifying:
>
* [field keys](/influxdb/v1.8/concepts/glossary/#field-key) and [tag keys](/influxdb/v1.8/concepts/glossary/#tag-key) in the [`SELECT` clause](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement)
* [measurements](/influxdb/v1.8/concepts/glossary/#measurement) in the [`FROM` clause](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement)
* [tag values](/influxdb/v1.8/concepts/glossary/#tag-value) and string [field values](/influxdb/v1.8/concepts/glossary/#field-value) in the [`WHERE` clause](/influxdb/v1.8/query_language/data_exploration/#the-where-clause).
* [tag keys](/influxdb/v1.8/concepts/glossary/#tag-key) in the [`GROUP BY` clause](/influxdb/v1.8/query_language/data_exploration/#group-by-tags)
* [field keys](/influxdb/v1.8/concepts/glossary/#field-key) and [tag keys](/influxdb/v1.8/concepts/glossary/#tag-key) in the [`SELECT` clause](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement)
* [measurements](/influxdb/v1.8/concepts/glossary/#measurement) in the [`FROM` clause](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement)
* [tag values](/influxdb/v1.8/concepts/glossary/#tag-value) and string [field values](/influxdb/v1.8/concepts/glossary/#field-value) in the [`WHERE` clause](/influxdb/v1.8/query_language/explore-data/#the-where-clause).
* [tag keys](/influxdb/v1.8/concepts/glossary/#tag-key) in the [`GROUP BY` clause](/influxdb/v1.8/query_language/explore-data/#group-by-tags)
>
>Currently, InfluxQL does not support using regular expressions to match
>non-string field values in the
@ -613,7 +613,7 @@ SIZE OF BLOCKS: 931
### EXPLAIN ANALYZE
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution_time) and [planning time](#planning_time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
Executes the specified SELECT statement and returns data on the query performance and storage during runtime, visualized as a tree. Use this statement to analyze query performance and storage, including [execution time](#execution-time) and [planning time](#planning-time), and the [iterator type](#iterator-type) and [cursor type](#cursor-type).
For example, executing the following statement:
@ -984,7 +984,7 @@ Estimates or counts exactly the cardinality of the series for the current databa
[Series cardinality](/influxdb/v1.8/concepts/glossary/#series-cardinality) is the major factor that affects RAM requirements. For more information, see:
- [When do I need more RAM?](/influxdb/v1.8/guides/hardware_sizing/#when-do-i-need-more-ram) in [Hardware Sizing Guidelines](/influxdb/v1.8/guides/hardware_sizing/)
- [Don't have too many series](/influxdb/v1.8/concepts/schema_and_data_layout/#don-t-have-too-many-series)
- [Don't have too many series](/influxdb/v1.8/concepts/schema_and_data_layout/#avoid-too-many-series)
> **Note:** `ON <database>`, `FROM <sources>`, `WITH KEY = <key>`, `WHERE <condition>`, `GROUP BY <dimensions>`, and `LIMIT/OFFSET` clauses are optional.
> When using these query clauses, the query falls back to an exact count.

View File

@ -1,7 +1,7 @@
---
title: CollectD protocol support in InfluxDB
description: >
The collectd input allows InfluxDB to accept data transmitted in collectd native format.
The collectd input allows InfluxDB to accept data transmitted in collectd native format.
aliases:
- /influxdb/v1.8/tools/collectd/
menu:
@ -11,13 +11,11 @@ menu:
parent: Supported protocols
---
# The collectd input
The [collectd](https://collectd.org) input allows InfluxDB to accept data transmitted in collectd native format. This data is transmitted over UDP.
## A note on UDP/IP buffer sizes
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.8/supported_protocols/udp/#a-note-on-udpip-os-buffer-sizes)
If you're running Linux or FreeBSD, please adjust your operating system UDP buffer size limit, [see here for more details.](/influxdb/v1.8/supported_protocols/udp/#a-note-on-udp-ip-os-buffer-sizes)
## Configuration

View File

@ -355,7 +355,7 @@ POST http://localhost:8086/query
| GET | Use for all queries that start with: <br><br> [`SELECT`](/influxdb/v1.8/query_language/spec/#select)* <br><br> [`SHOW`](/influxdb/v1.8/query_language/spec/#show-continuous-queries) |
| POST | Use for all queries that start with: <br><br> [`ALTER`](/influxdb/v1.8/query_language/spec/#alter-retention-policy) <br><br> [`CREATE`](/influxdb/v1.8/query_language/spec/#create-continuous-query) <br><br> [`DELETE`](/influxdb/v1.8/query_language/spec/#delete) <br><br> [`DROP`](/influxdb/v1.8/query_language/spec/#drop-continuous-query) <br><br> [`GRANT`](/influxdb/v1.8/query_language/spec/#grant) <br><br> [`KILL`](/influxdb/v1.8/query_language/spec/#kill-query) <br><br> [`REVOKE`](/influxdb/v1.8/query_language/spec/#revoke) |
\* The only exceptions are `SELECT` queries that include an [`INTO` clause](/influxdb/v1.8/query_language/data_exploration/#the-into-clause).
\* The only exceptions are `SELECT` queries that include an [`INTO` clause](/influxdb/v1.8/query_language/explore-data/#the-into-clause).
Those `SELECT` queries require a `POST` request.
#### Examples
@ -390,7 +390,7 @@ $ curl -XPOST 'http://localhost:8086/query?db=mydb' --data-urlencode 'q=SELECT *
{"results":[{"statement_id":0,"series":[{"name":"result","columns":["time","written"],"values":[["1970-01-01T00:00:00Z",2]]}]}]}
```
`SELECT` queries that include and [`INTO` clause](/influxdb/v1.8/query_language/data_exploration/#the-into-clause) require a `POST` request.
`SELECT` queries that include and [`INTO` clause](/influxdb/v1.8/query_language/explore-data/#the-into-clause) require a `POST` request.
The response shows that InfluxDB writes two points to the `newmeas` [measurement](/influxdb/v1.8/concepts/glossary/#measurement).
Note that the system uses epoch 0 (`1970-01-01T00:00:00Z`) as a [null timestamp equivalent](/influxdb/v1.8/troubleshooting/frequently-asked-questions/#why-does-my-query-return-epoch-0-as-the-timestamp).
@ -403,7 +403,7 @@ $ curl -XPOST 'http://localhost:8086/query' --data-urlencode 'q=CREATE DATABASE
{"results":[{"statement_id":0}]}
```
A successful [`CREATE DATABASE` query](/influxdb/v1.8/query_language/database_management/#create-database) returns no additional information.
A successful [`CREATE DATABASE` query](/influxdb/v1.8/query_language/manage-database/#create-database) returns no additional information.
#### Query string parameters
@ -484,7 +484,7 @@ $ curl -XPOST 'http://localhost:8086/query?u=myusername&p=mypassword' --data-url
{"results":[{"statement_id":0}]}
```
A successful [`CREATE DATABASE` query](/influxdb/v1.8/query_language/database_management/#create-database) returns no additional information.
A successful [`CREATE DATABASE` query](/influxdb/v1.8/query_language/manage-database/#create-database) returns no additional information.
Invalid credentials:
@ -504,7 +504,7 @@ $ curl -XPOST -u myusername:mypassword 'http://localhost:8086/query' --data-urle
{"results":[{"statement_id":0}]}
```
A successful [`CREATE DATABASE` query](/influxdb/v1.8/query_language/database_management/#create-database) returns no additional information.
A successful [`CREATE DATABASE` query](/influxdb/v1.8/query_language/manage-database/#create-database) returns no additional information.
The following example uses invalid credentials.

View File

@ -14,7 +14,7 @@ menu:
InfluxDB client libraries are language-specific packages that integrate with the InfluxDB 2.0 API and support both **InfluxDB 1.8+** and **InfluxDB 2.0**.
>**Note:** We recommend using the new client libraries on this page to leverage the new read (via Flux) and write APIs and prepare for conversion to InfluxDB 2.0 and InfluxDB Cloud 2.0. For more information, see [InfluxDB 2.0 API compatibility endpoints](/influxdb/v1.8/tools/api/#influxdb-2.0-compatibility-endpoints). Client libraries for [InfluxDB 1.7 and earlier](/influxdb/v1.7/tools/api_client_libraries/) may continue to work, but are not maintained by InfluxData.
>**Note:** We recommend using the new client libraries on this page to leverage the new read (via Flux) and write APIs and prepare for conversion to InfluxDB 2.0 and InfluxDB Cloud 2.0. For more information, see [InfluxDB 2.0 API compatibility endpoints](/influxdb/v1.8/tools/api/#influxdb-2-0-api-compatibility-endpoints). Client libraries for [InfluxDB 1.7 and earlier](/influxdb/v1.7/tools/api_client_libraries/) may continue to work, but are not maintained by InfluxData.
## Client libraries

View File

@ -82,7 +82,7 @@ Set the write consistency level.
The database to which `influx` connects.
`-execute 'command'`
Execute an [InfluxQL](/influxdb/v1.8/query_language/data_exploration/) command and quit.
Execute an [InfluxQL](/influxdb/v1.8/query_language/explore-data/) command and quit.
See [-execute](/influxdb/v1.8/tools/shell/#execute-an-influxql-command-and-quit-with-execute).
`-format 'json|csv|column'`
@ -245,9 +245,9 @@ $ influx -format=json -pretty
The import file has two sections:
* **DDL (Data Definition Language)**: Contains the [InfluxQL commands](/influxdb/v1.8/query_language/database_management/) for creating the relevant [database](/influxdb/v1.8/concepts/glossary/) and managing the [retention policy](/influxdb/v1.8/concepts/glossary/#retention-policy-rp).
* **DDL (Data Definition Language)**: Contains the [InfluxQL commands](/influxdb/v1.8/query_language/manage-database/) for creating the relevant [database](/influxdb/v1.8/concepts/glossary/) and managing the [retention policy](/influxdb/v1.8/concepts/glossary/#retention-policy-rp).
If your database and retention policy already exist, your file can skip this section.
* **DML (Data Manipulation Language)**: Lists the relevant database and (if desired) retention policy and contains the data in [line protocol](/influxdb/v1.8/concepts/glossary/#line-protocol).
* **DML (Data Manipulation Language)**: Lists the relevant database and (if desired) retention policy and contains the data in [line protocol](/influxdb/v1.8/concepts/glossary/#influxdb-line-protocol).
Example:
@ -373,7 +373,7 @@ If you do not specify the retention policy, `influx` automatically queries the `
#### Write data to InfluxDB with `insert`
Enter `insert` followed by the data in [line protocol](/influxdb/v1.8/concepts/glossary/#line-protocol) to write data to InfluxDB.
Enter `insert` followed by the data in [line protocol](/influxdb/v1.8/concepts/glossary/#influxdb-line-protocol) to write data to InfluxDB.
Use `insert into <retention policy> <line protocol>` to write data to a specific [retention policy](/influxdb/v1.8/concepts/glossary/#retention-policy-rp).
Write data to a single field in the measurement `treasures` with the tag `captain_id = pirate_king`.
@ -394,4 +394,4 @@ Using retention policy oneday
Execute all InfluxQL queries in `influx`.
See [Data exploration](/influxdb/v1.8/query_language/data_exploration/), [Schema exploration](/influxdb/v1.8/query_language/schema_exploration/), [Database management](/influxdb/v1.8/query_language/database_management/), [Authentication and authorization](/influxdb/v1.8/administration/authentication_and_authorization/) for InfluxQL documentation.
See [Data exploration](/influxdb/v1.8/query_language/explore-data/), [Schema exploration](/influxdb/v1.8/query_language/explore-schema/), [Database management](/influxdb/v1.8/query_language/manage-database/), [Authentication and authorization](/influxdb/v1.8/administration/authentication_and_authorization/) for InfluxQL documentation.

View File

@ -28,7 +28,7 @@ The relevant `SHOW` queries include `SHOW RETENTION POLICIES`, `SHOW SERIES`,
`SHOW MEASUREMENTS`, `SHOW TAG KEYS`, `SHOW TAG VALUES`, and `SHOW FIELD KEYS`.
**Resources:**
[Schema exploration](/influxdb/v1.8/query_language/schema_exploration/),
[Schema exploration](/influxdb/v1.8/query_language/explore-schema/),
[InfluxQL reference](/influxdb/v1.8/query_language/spec/)
## `error: max series per database exceeded: < >`
@ -236,7 +236,7 @@ time water_level
```
**Resources:**
[Data Exploration](/influxdb/v1.8/query_language/data_exploration/#time-syntax)
[Data Exploration](/influxdb/v1.8/query_language/explore-data/#time-syntax)
## `unable to parse < >: bad timestamp`

View File

@ -146,12 +146,12 @@ The table below outlines the default relationship between the `DURATION` of an R
Users can also configure the shard group duration with the
[`CREATE RETENTION POLICY`](/influxdb/v1.8/query_language/database_management/#create-retention-policies-with-create-retention-policy)
[`CREATE RETENTION POLICY`](/influxdb/v1.8/query_language/manage-database/#create-retention-policies-with-create-retention-policy)
and
[`ALTER RETENTION POLICY`](/influxdb/v1.8/query_language/database_management/#modify-retention-policies-with-alter-retention-policy)
[`ALTER RETENTION POLICY`](/influxdb/v1.8/query_language/manage-database/#modify-retention-policies-with-alter-retention-policy)
statements.
Check your retention policy's shard group duration with the
[`SHOW RETENTION POLICIES`](/influxdb/v1.8/query_language/schema_exploration/#show-retention-policies)
[`SHOW RETENTION POLICIES`](/influxdb/v1.8/query_language/explore-schema/#show-retention-policies)
statement.
## Why aren't data dropped after I've altered a retention policy?
@ -244,7 +244,7 @@ If a non-admin user attempts to `USE` a database on which the user doesn't have
ERR: Database <database_name> doesn't exist. Run SHOW DATABASES for a list of existing databases.
```
> **Note** that the [`SHOW DATABASES` query](/influxdb/v1.8/query_language/schema_exploration/#show-databases) returns only those databases on which the non-admin user has `READ` and/or `WRITE` permissions.
> **Note** that the [`SHOW DATABASES` query](/influxdb/v1.8/query_language/explore-schema/#show-databases) returns only those databases on which the non-admin user has `READ` and/or `WRITE` permissions.
## How do I write to a non-DEFAULT retention policy with the InfluxDB CLI?
@ -300,10 +300,10 @@ Field value types cannot differ within a
### The SELECT statement
The
[`SELECT` statement](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement)
[`SELECT` statement](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement)
returns all field values **if** all values have the same type.
If field value types differ across shards, InfluxDB first performs any
applicable [cast](/influxdb/v1.8/query_language/data_exploration/#cast-operations)
applicable [cast](/influxdb/v1.8/query_language/explore-data/#cast-operations)
operations and then returns all values with the type that occurs first in the
following list: float, integer, string, Boolean.
@ -385,7 +385,7 @@ Timestamps outside that range return a [parsing error](/influxdb/v1.8/troublesho
## How can I tell what type of data is stored in a field?
The [`SHOW FIELD KEYS`](/influxdb/v1.8/query_language/schema_exploration/#show-field-keys) query also returns the field's type.
The [`SHOW FIELD KEYS`](/influxdb/v1.8/query_language/explore-schema/#show-field-keys) query also returns the field's type.
#### Example
@ -406,7 +406,7 @@ Currently, InfluxDB offers very limited support for changing a field's data type
The `<field_key>::<type>` syntax supports casting field values from integers to
floats or from floats to integers.
See [Cast Operations](/influxdb/v1.8/query_language/data_exploration/#data-types-and-cast-operations)
See [Cast Operations](/influxdb/v1.8/query_language/explore-data/#data-types-and-cast-operations)
for an example.
There is no way to cast a float or integer to a string or Boolean (or vice versa).
@ -437,7 +437,7 @@ For how this will affect your queries, please see
## How do I perform mathematical operations within a function?
Currently, InfluxDB does not support mathematical operations within functions.
We recommend using InfluxQL's [subqueries](/influxdb/v1.8/query_language/data_exploration/#subqueries)
We recommend using InfluxQL's [subqueries](/influxdb/v1.8/query_language/explore-data/#subqueries)
as a workaround.
### Example
@ -455,7 +455,7 @@ Instead, use a subquery to get the same result:
```
See the
[Data Exploration](/influxdb/v1.8/query_language/data_exploration/#subqueries)
[Data Exploration](/influxdb/v1.8/query_language/explore-data/#subqueries)
page for more information.
## Why does my query return epoch 0 as the timestamp?
@ -477,12 +477,12 @@ The following InfluxQL functions support nesting:
* [`HOLT_WINTERS()`](/influxdb/v1.8/query_language/functions/#holt-winters) and [`HOLT_WINTERS_WITH_FIT()`](/influxdb/v1.8/query_language/functions/#holt-winters)
For information on how to use a subquery as a substitute for nested functions, see
[Data exploration](/influxdb/v1.8/query_language/data_exploration/#subqueries).
[Data exploration](/influxdb/v1.8/query_language/explore-data/#subqueries).
## What determines the time intervals returned by `GROUP BY time()` queries?
The time intervals returned by `GROUP BY time()` queries conform to the InfluxDB database's preset time
buckets or to the user-specified [offset interval](/influxdb/v1.8/query_language/data_exploration/#advanced-group-by-time-syntax).
buckets or to the user-specified [offset interval](/influxdb/v1.8/query_language/explore-data/#advanced-group-by-time-syntax).
#### Example
@ -556,7 +556,7 @@ WHERE time >= '2016-08-29T18:15:00Z' AND time <= '2016-08-29T19:45:00Z' GROUP BY
```
In this example, the user-specified
[offset interval](/influxdb/v1.8/query_language/data_exploration/#advanced-group-by-time-syntax)
[offset interval](/influxdb/v1.8/query_language/explore-data/#advanced-group-by-time-syntax)
shifts the InfluxDB database's preset time buckets forward by `15` minutes.
The average for the 6pm time bucket now includes data between 6:15pm and 7pm, and
the average for the 7pm time bucket includes data between 7:15pm and 8pm.
@ -598,7 +598,7 @@ time sunflowers time mean
The most common reasons why your query returns no data or partial data:
- [Querying the wrong retention policy](#querying-wrong-retention-policy) (no data returned)
- [Querying the wrong retention policy](#querying-the-wrong-retention-policy) (no data returned)
- [No field key in the SELECT clause](#no-field-key-in-the-select-clause) (no data returned)
- [SELECT query includes `GROUP BY time()`](#select-query-includes-group-by-time) (partial data before `now()` returned)
- [Tag and field key with the same name](#tag-and-field-key-with-the-same-name)
@ -609,13 +609,13 @@ InfluxDB automatically queries data in a databases `DEFAULT` retention policy
### No field key in the SELECT clause
A query requires at least one [field key](/influxdb/v1.8/concepts/glossary/#field-key) in the `SELECT` clause. If the `SELECT` clause includes only [tag keys](/influxdb/v1.8/concepts/glossary/#tag-key), the query returns an empty response. For more information, see [Data exploration](/influxdb/v1.8/query_language/data_exploration/#common-issues-with-the-select-statement).
A query requires at least one [field key](/influxdb/v1.8/concepts/glossary/#field-key) in the `SELECT` clause. If the `SELECT` clause includes only [tag keys](/influxdb/v1.8/concepts/glossary/#tag-key), the query returns an empty response. For more information, see [Data exploration](/influxdb/v1.8/query_language/explore-data/#common-issues-with-the-select-statement).
### SELECT query includes `GROUP BY time()`
If your `SELECT` query includes a [`GROUP BY time()` clause](/influxdb/v1.8/query_language/data_exploration/#group-by-time-intervals), only data points between `1677-09-21 00:12:43.145224194` and [`now()`](/influxdb/v1.8/concepts/glossary/#now) are returned. Therefore, if any of your data points occur after `now()`, specify [an alternative upper bound](/influxdb/v1.8/query_language/data_exploration/#time-syntax) in your time interval.
If your `SELECT` query includes a [`GROUP BY time()` clause](/influxdb/v1.8/query_language/explore-data/#group-by-time-intervals), only data points between `1677-09-21 00:12:43.145224194` and [`now()`](/influxdb/v1.8/concepts/glossary/#now) are returned. Therefore, if any of your data points occur after `now()`, specify [an alternative upper bound](/influxdb/v1.8/query_language/explore-data/#time-syntax) in your time interval.
(By default, most [`SELECT` queries](/influxdb/v1.8/query_language/data_exploration/#the-basic-select-statement) query data with timestamps between `1677-09-21 00:12:43.145224194` and `2262-04-11T23:47:16.854775806Z` UTC.)
(By default, most [`SELECT` queries](/influxdb/v1.8/query_language/explore-data/#the-basic-select-statement) query data with timestamps between `1677-09-21 00:12:43.145224194` and `2262-04-11T23:47:16.854775806Z` UTC.)
### Tag and field key with the same name
@ -723,12 +723,12 @@ Avoid using the same name for a tag and field key. If you inadvertently add the
## Why don't my GROUP BY time() queries return timestamps that occur after now()?
Most `SELECT` statements have a default time range between [`1677-09-21 00:12:43.145224194` and `2262-04-11T23:47:16.854775806Z` UTC](#what-are-the-minimum-and-maximum-timestamps-that-influxdb-can-store).
For `SELECT` statements with a [`GROUP BY time()` clause](/influxdb/v1.8/query_language/data_exploration/#group-by-time-intervals), the default time
For `SELECT` statements with a [`GROUP BY time()` clause](/influxdb/v1.8/query_language/explore-data/#group-by-time-intervals), the default time
range is between `1677-09-21 00:12:43.145224194` UTC and [`now()`](/influxdb/v1.8/concepts/glossary/#now).
To query data with timestamps that occur after `now()`, `SELECT` statements with
a `GROUP BY time()` clause must provide an alternative upper bound in the
[`WHERE` clause](/influxdb/v1.8/query_language/data_exploration/#the-where-clause).
[`WHERE` clause](/influxdb/v1.8/query_language/explore-data/#the-where-clause).
In the following example, the first query covers data with timestamps between
`2015-09-18T21:30:00Z` and `now()`.
@ -750,7 +750,7 @@ the lower bound to `now()` such that the query's time range is between
>
```
For for more on time syntax in queries, see [Data Exploration](/influxdb/v1.8/query_language/data_exploration/#time-syntax).
For for more on time syntax in queries, see [Data Exploration](/influxdb/v1.8/query_language/explore-data/#time-syntax).
## Can I perform mathematical operations against timestamps?
@ -813,7 +813,7 @@ Yes: `SELECT "water_level" FROM "h2o_feet" WHERE time > '2015-08-18T23:00:01.232
No: `SELECT "water_level" FROM "h2o_feet" WHERE time > "2015-08-18T23:00:01.232000000Z" AND time < "2015-09-19"`
See [Data Exploration](/influxdb/v1.8/query_language/data_exploration/#time-syntax) for more on time syntax in queries.
See [Data Exploration](/influxdb/v1.8/query_language/explore-data/#time-syntax) for more on time syntax in queries.
## Why am I missing data after creating a new DEFAULT retention policy?
@ -833,7 +833,7 @@ time count
1970-01-01T00:00:00Z 8
```
We [create](/influxdb/v1.8/query_language/database_management/#create-retention-policies-with-create-retention-policy) a new `DEFAULT` RP (`two_hour`) and perform the same query:
We [create](/influxdb/v1.8/query_language/manage-database/#create-retention-policies-with-create-retention-policy) a new `DEFAULT` RP (`two_hour`) and perform the same query:
```sql
> SELECT count(flounders) FROM fleeting
@ -1048,9 +1048,9 @@ InfluxDB maintains an in-memory index of every [series](/influxdb/v1.8/concepts/
## How can I remove series from the index?
To reduce series cardinality, series must be dropped from the index.
[`DROP DATABASE`](/influxdb/v1.8/query_language/database_management/#delete-a-database-with-drop-database),
[`DROP MEASUREMENT`](/influxdb/v1.8/query_language/database_management/#delete-measurements-with-drop-measurement), and
[`DROP SERIES`](/influxdb/v1.8/query_language/database_management/#drop-series-from-the-index-with-drop-series) will all remove series from the index and reduce the overall series cardinality.
[`DROP DATABASE`](/influxdb/v1.8/query_language/manage-database/#delete-a-database-with-drop-database),
[`DROP MEASUREMENT`](/influxdb/v1.8/query_language/manage-database/#delete-measurements-with-drop-measurement), and
[`DROP SERIES`](/influxdb/v1.8/query_language/manage-database/#drop-series-from-the-index-with-drop-series) will all remove series from the index and reduce the overall series cardinality.
> **Note:** `DROP` commands are usually CPU-intensive, as they frequently trigger a TSM compaction. Issuing `DROP` queries at a high frequency may significantly impact write and other query throughput.
@ -1246,7 +1246,7 @@ For users who want to write sparse, historical data to InfluxDB, InfluxData reco
First, lengthening your [retention policy](/influxdb/v1.8/concepts/glossary/#retention-policy-rp)s [shard group](/influxdb/v1.8/concepts/glossary/#shard-group) duration to cover several years.
The default shard group duration is one week and if your data cover several hundred years well, thats a lot of shards!
Having an extremely high number of shards is inefficient for InfluxDB.
Increase the shard group duration for your datas retention policy with the [`ALTER RETENTION POLICY` query](/influxdb/v1.8/query_language/database_management/#modify-retention-policies-with-alter-retention-policy).
Increase the shard group duration for your datas retention policy with the [`ALTER RETENTION POLICY` query](/influxdb/v1.8/query_language/manage-database/#modify-retention-policies-with-alter-retention-policy).
Second, temporarily lowering the [`cache-snapshot-write-cold-duration` configuration setting](/influxdb/v1.8/administration/config/#cache-snapshot-write-cold-duration-10m).
If youre writing a lot of historical data, the default setting (`10m`) can cause the system to hold all of your data in cache for every shard.

View File

@ -143,7 +143,7 @@ If you're running `influx` on macOS Catalina, you must [manually authorize the I
#### Step 5: Set up a configuration profile
To avoid having to pass your InfluxDB [authentication token](/influxdb/v2.0/users/tokens/) with each `influx` command, set up a configuration profile that stores your credentials.
To avoid having to pass your InfluxDB [authentication token](/influxdb/v2.0/security/tokens/) with each `influx` command, set up a configuration profile that stores your credentials.
In a terminal, run the following command:
@ -203,7 +203,7 @@ If you rename the binary, all references to `influx` in this documentation refer
#### Step 4: Set up a configuration profile
To avoid having to pass your InfluxDB [authentication token](/influxdb/v2.0/users/tokens/) with each `influx` command, set up a configuration profile that stores your credentials.
To avoid having to pass your InfluxDB [authentication token](/influxdb/v2.0/security/tokens/) with each `influx` command, set up a configuration profile that stores your credentials.
In a terminal, run the following command:
@ -540,7 +540,7 @@ You are ready to [write or collect data](/influxdb/v2.0/write-data).
### (Optional) Set up and use the influx CLI
If you set up InfluxDB through the UI and want to use the [`influx` CLI](/influxdb/v2.0/reference/cli/influx), we recommend setting up a configuration profile. This lets you avoid having to pass your InfluxDB [authentication token](/influxdb/v2.0/users/tokens/) with each `influx` command. Complete the following steps to set up a configuration profile that stores your credentials.
If you set up InfluxDB through the UI and want to use the [`influx` CLI](/influxdb/v2.0/reference/cli/influx), we recommend setting up a configuration profile. This lets you avoid having to pass your InfluxDB [authentication token](/influxdb/v2.0/security/tokens/) with each `influx` command. Complete the following steps to set up a configuration profile that stores your credentials.
1. In a terminal, run the following command:

View File

@ -21,7 +21,7 @@ to apply and manage templates in your InfluxDB Cloud account.
If you havent already, do the following:
1. [Download and install `influx` CLI](/influxdb/v2.0/get-started/#optional-download-and-install-the-influx-cli).
1. [Download and install `influx` CLI](/influxdb/v2.0/get-started/#optional-download-install-and-use-the-influx-cli).
2. [Configure the `influx` CLI](/influxdb/v2.0/get-started/#set-up-influxdb) to use your
InfluxDB Cloud instance URL, organization, and tokens.
3. [Use the `influx` CLI](/influxdb/v2.0/reference/cli/influx/) to use, manage, and create

View File

@ -48,7 +48,7 @@ In **InfluxDB Cloud**, your user account is an organization.
- [notification endpoints](/influxdb/v2.0/monitor-alert/notification-endpoints/create/)
- [notification rules](/influxdb/v2.0/monitor-alert/notification-rules/create/)
- [tasks](/influxdb/v2.0/process-data/manage-tasks/create-task/)
- [Telegraf configurations](/influxdb/v2.0/write-data/use-telegraf/)
- [Telegraf configurations](/influxdb/v2.0/write-data/no-code/use-telegraf/)
4. Export the template _(see [below](#export-a-template))_.

View File

@ -19,7 +19,7 @@ The AWS CloudWatch Monitoring template includes the following:
- two [buckets](/influxdb/v2.0/reference/glossary/#bucket): `kubernetes` and `cloudwatch`
- two labels: `inputs.cloudwatch`, `AWS`
- one variable: `v.bucket`
- one [Telegraf configuration](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/): [AWS CloudWatch input plugin](/influxdb/v2.0/reference/telegraf-plugins/#cloudwatch)
- one [Telegraf configuration](/influxdb/v2.0/telegraf-configs/): [AWS CloudWatch input plugin](/influxdb/v2.0/reference/telegraf-plugins/#cloudwatch)
## Apply the template

View File

@ -17,7 +17,7 @@ The Docker Monitoring template includes the following:
- one [dashboard](/influxdb/v2.0/reference/glossary/#dashboard): **Docker**
- one [bucket](/influxdb/v2.0/reference/glossary/#bucket): `docker, 7d retention`
- labels: Docker input plugin labels
- one [Telegraf configuration](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/): Docker input plugin
- one [Telegraf configuration](/influxdb/v2.0/telegraf-configs/): Docker input plugin
- one variable: `bucket`
- four [checks](/influxdb/v2.0/reference/glossary/#check): `Container cpu`, `mem`, `disk`, `non-zero exit`
- one [notification endpoint](/influxdb/v2.0/reference/glossary/#notification-endpoint): `Http Post`
@ -37,7 +37,7 @@ For more information about how checks, notification endpoints, and notifications
> **Note:** Ensure your `influx` CLI is configured with your account credentials and that configuration is active. For more information, see [influx config](/influxdb/v2.0/reference/cli/influx/config/).
2. [Install Telegraf](/{{< latest "telegraf" >}}/introduction/installation/) on a server with network access to both the Docker containers and [InfluxDB v2 API](/influxdb/v2.0/reference/api/).
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/), do the following:
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/telegraf-configs/), do the following:
- Depending on how you run Docker, you may need to customize the [Docker input plugin](/influxdb/v2.0/reference/telegraf-plugins/#docker) configuration, for example, you may need to specify the `endpoint` value.
- Set the following environment variables:
- INFLUX_TOKEN: Token must have permissions to read Telegraf configurations and write data to the `telegraf` bucket. See how to [view tokens](/influxdb/v2.0/security/tokens/view-tokens/).

View File

@ -17,7 +17,7 @@ The Docker Monitoring template includes the following:
- one [dashboard](/influxdb/v2.0/reference/glossary/#dashboard): **vsphere**
- one [bucket](/influxdb/v2.0/reference/glossary/#bucket): `vsphere`
- label: vsphere
- one [Telegraf configuration](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/): InfluxDB v2 output plugin, vSphere input plugin
- one [Telegraf configuration](/influxdb/v2.0/telegraf-configs/): InfluxDB v2 output plugin, vSphere input plugin
- one variable: `bucket`
## Apply the template
@ -32,7 +32,7 @@ The Docker Monitoring template includes the following:
> **Note:** Ensure your `influx` CLI is configured with your account credentials and that configuration is active. For more information, see [influx config](/influxdb/v2.0/reference/cli/influx/config/).
2. [Install Telegraf](/{{< latest "telegraf" >}}/introduction/installation/) on a server with network access to both the vSphere host and [InfluxDB v2 API](/influxdb/v2.0/reference/api/).
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/), do the following:
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/telegraf-configs/), do the following:
- Set the following environment variables:
- INFLUX_TOKEN: Token must have permissions to read Telegraf configurations and write data to the `telegraf` bucket. See how to [view tokens](/influxdb/v2.0/security/tokens/view-tokens/).
- INFLUX_ORG: Name of your organization. See how to [view your organization](/influxdb/v2.0/organizations/view-orgs/).

View File

@ -16,7 +16,7 @@ The Windows System Monitoring template includes the following:
- one [dashboard](/influxdb/v2.0/reference/glossary/#dashboard): **Windows System**
- one [bucket](/influxdb/v2.0/reference/glossary/#bucket): `telegraf`, 7d retention
- label: `Windows System Template`, Telegraf plugin labels: `outputs.influxdb_v2`
- one [Telegraf configuration](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/): InfluxDB v2 output plugin, Windows Performance Counters input plugin
- one [Telegraf configuration](/influxdb/v2.0/telegraf-configs/): InfluxDB v2 output plugin, Windows Performance Counters input plugin
- two variables: `bucket`, `windows_host`
## Apply the template
@ -31,7 +31,7 @@ The Windows System Monitoring template includes the following:
> **Note:** Ensure your `influx` CLI is configured with your account credentials and that configuration is active. For more information, see [influx config](/influxdb/v2.0/reference/cli/influx/config/).
2. [Install Telegraf](/{{< latest "telegraf" >}}/introduction/installation/) on a server with network access to both the Windows system and [InfluxDB v2 API](/influxdb/v2.0/reference/api/).
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/), do the following:
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/telegraf-configs/), do the following:
- Set the following environment variables:
- INFLUX_TOKEN: Token must have permissions to read Telegraf configurations and write data to the `telegraf` bucket. See how to [view tokens](/influxdb/v2.0/security/tokens/view-tokens/).
- INFLUX_ORG: Name of your organization. See how to [view your organization](/influxdb/v2.0/organizations/view-orgs/).

View File

@ -17,7 +17,7 @@ The HAProxy for InfluxDB v2 template includes the following:
- one [dashboard](/influxdb/v2.0/reference/glossary/#dashboard): **HAProxy**
- one [bucket](/influxdb/v2.0/reference/glossary/#bucket): `haproxy`
- label: `haproxy`
- one [Telegraf configuration](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/): HAProxy input plugin, InfluxDB v2 output plugin
- one [Telegraf configuration](/influxdb/v2.0/telegraf-configs/): HAProxy input plugin, InfluxDB v2 output plugin
- one variable: `bucket`
## Apply the template
@ -32,7 +32,7 @@ The HAProxy for InfluxDB v2 template includes the following:
> **Note:** Ensure your `influx` CLI is configured with your account credentials and that configuration is active. For more information, see [influx config](/influxdb/v2.0/reference/cli/influx/config/).
2. [Install Telegraf](/{{< latest "telegraf" >}}/introduction/installation/) on a server with network access to both the HAProxy instances and [InfluxDB v2 API](/influxdb/v2.0/reference/api/).
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/), do the following:
3. In your [Telegraf configuration file (`telegraf.conf`)](/influxdb/v2.0/telegraf-configs/), do the following:
- Set the following environment variables:
- INFLUX_TOKEN: Token must have permissions to read Telegraf configurations and write data to the `haproxy` bucket. See how to [view tokens](/influxdb/v2.0/security/tokens/view-tokens/).
- INFLUX_ORG: Name of your organization. See how to [view your organization](/influxdb/v2.0/organizations/view-orgs/).

View File

@ -142,7 +142,7 @@ it isn't included in the output table.
## Custom aggregate function examples
To create custom aggregate functions, use principles outlined in
[Creating custom functions](/influxdb/v2.0/query-data/guides/custom-functions)
[Creating custom functions](/influxdb/v2.0/query-data/flux/custom-functions)
and the `reduce()` function to aggregate rows in each input table.
### Create a custom average function

View File

@ -77,7 +77,7 @@ For example:
{{% /note %}}
## Custom mathematic functions
Flux lets you [create custom functions](/influxdb/v2.0/query-data/guides/custom-functions) that use mathematic operations.
Flux lets you [create custom functions](/influxdb/v2.0/query-data/flux/custom-functions) that use mathematic operations.
View the examples below.
###### Custom multiplication function

View File

@ -4,7 +4,7 @@ seotitle: Calculate the moving average in Flux
list_title: Moving Average
description: >
Use the [`movingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/movingaverage/)
or [`timedMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/timedmovingaverage/)
or [`timedMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/timedmovingaverage/)
functions to return the moving average of data.
weight: 210
aliases:
@ -21,7 +21,7 @@ list_query_example: moving_average
---
Use the [`movingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/movingaverage/)
or [`timedMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/timedmovingaverage/)
or [`timedMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/timedmovingaverage/)
functions to return the moving average of data.
```js

View File

@ -3,7 +3,7 @@ title: Calculate the rate of change
seotitle: Calculate the rate of change in Flux
list_title: Rate
description: >
Use the [`derivative()` function](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/derivative/)
Use the [`derivative()` function](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/derivative/)
to calculate the rate of change between subsequent values or the
[`aggregate.rate()` function](/influxdb/v2.0/reference/flux/stdlib/experimental/aggregate/rate/)
to calculate the average rate of change per window of time.
@ -24,7 +24,7 @@ list_query_example: rate_of_change
---
Use the [`derivative()` function](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/derivative/)
Use the [`derivative()` function](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/derivative/)
to calculate the rate of change between subsequent values or the
[`aggregate.rate()` function](/influxdb/v2.0/reference/flux/stdlib/experimental/aggregate/rate/)
to calculate the average rate of change per window of time.
@ -35,7 +35,7 @@ making values easily comparable.
- [Average rate of change per window of time](#average-rate-of-change-per-window-of-time)
## Rate of change between subsequent values
Use the [`derivative()` function](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/derivative/)
Use the [`derivative()` function](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/derivative/)
to calculate the rate of change per unit of time between subsequent _non-null_ values.
```js

View File

@ -231,7 +231,7 @@ cpuUsageUser |> topN(n:5) |> yield()
This query will return the five data points with the highest user CPU usage over the last hour.
_More information about creating custom functions is available in the [Custom functions](/influxdb/v2.0/query-data/guides/custom-functions) documentation._
_More information about creating custom functions is available in the [Custom functions](/influxdb/v2.0/query-data/flux/custom-functions) documentation._
<div class="page-nav-btns">
<a class="btn prev" href="/v2.0/query-data/get-started/transform-data/">Transform your data</a>

View File

@ -41,7 +41,7 @@ from(bucket:"example-bucket")
## Flux functions
Flux provides a number of functions that perform specific operations, transformations, and tasks.
You can also [create custom functions](/influxdb/v2.0/query-data/guides/custom-functions) in your Flux queries.
You can also [create custom functions](/influxdb/v2.0/query-data/flux/custom-functions) in your Flux queries.
_Functions are covered in detail in the [Flux functions](/influxdb/v2.0/reference/flux/stdlib) documentation._
A common type of function used when transforming data queried from InfluxDB is an aggregate function.
@ -179,7 +179,7 @@ and your own custom functions, but this is a good introduction into the basic sy
---
_For a deeper dive into windowing and aggregating data with example data output for each transformation,
view the [Window and aggregate data](/influxdb/v2.0/query-data/guides/window-aggregate) guide._
view the [Window and aggregate data](/influxdb/v2.0/query-data/flux/window-aggregate) guide._
---

View File

@ -24,7 +24,7 @@ influx bucket [command]
|:---------- |:----------- |
| [create](/influxdb/v2.0/reference/cli/influx/bucket/create) | Create bucket |
| [delete](/influxdb/v2.0/reference/cli/influx/bucket/delete) | Delete bucket |
| [list](/influxdb/v2.0/reference/cli/influx/bucket/find) | List buckets |
| [list](/influxdb/v2.0/reference/cli/influx/bucket/list) | List buckets |
| [update](/influxdb/v2.0/reference/cli/influx/bucket/update) | Update bucket |
## Flags

View File

@ -53,7 +53,7 @@ influx config local-config
|:---- |:----------- |
| [create](/influxdb/v2.0/reference/cli/influx/config/create) | Create a new connection configuration |
| [list](/influxdb/v2.0/reference/cli/influx/config/create) | List connection configurations |
| [delete](/influxdb/v2.0/reference/cli/influx/config/delete) | Delete a connection configuration |
| [delete](/influxdb/v2.0/reference/cli/influx/config/rm) | Delete a connection configuration |
| [set](/influxdb/v2.0/reference/cli/influx/config/set) | Set or update a connection configuration |
## Flags

View File

@ -23,7 +23,7 @@ related:
The `doubleEMA()` function calculates the exponential moving average of values in
the `_value` column grouped into `n` number of points, giving more weight to recent
data at double the rate of [`exponentialMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/exponentialmovingaverage/).
data at double the rate of [`exponentialMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/exponentialmovingaverage/).
_**Function type:** Transformation_

View File

@ -27,7 +27,7 @@ getColumn(column: "_value")
{{% note %}}
#### Use tableFind() to extract a single table
`getColumn()` requires a single table as input.
Use [`tableFind()`](/influxdb/v2.0/reference/flux/functions/built-in/transformations/stream-table/tablefind/)
Use [`tableFind()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/stream-table/tablefind/)
to extract a single table from a stream of tables.
{{% /note %}}

View File

@ -27,7 +27,7 @@ getRecord(idx: 0)
{{% note %}}
#### Use tableFind() to extract a single table
`getRecord()` requires a single table as input.
Use [`tableFind()`](/influxdb/v2.0/reference/flux/functions/built-in/transformations/stream-table/tablefind/)
Use [`tableFind()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/stream-table/tablefind/)
to extract a single table from a stream of tables.
{{% /note %}}

View File

@ -4,7 +4,7 @@ description: >
The `tableFind()` function extracts the first table in a stream of tables whose
group key values match a predicate. If no table is found, the function errors.
aliases:
- /v2.0/reference/flux/functions/built-in/transformations/stream-table/tablefind/
- /v2.0/reference/flux/stdlib/built-in/transformations/stream-table/tablefind/
- /v2.0/reference/flux/stdlib/built-in/transformations/stream-table/tablefind
menu:
influxdb_2_0_ref:

View File

@ -24,8 +24,8 @@ related:
The `tripleEMA()` function calculates the exponential moving average of values in
the `_value` column grouped into `n` number of points, giving more weight to recent
data with less lag than
[`exponentialMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/exponentialmovingaverage/)
and [`doubleEMA()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/doubleema/).
[`exponentialMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/exponentialmovingaverage/)
and [`doubleEMA()`](http://localhost:1313/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/doubleema/).
_**Function type:** Transformation_

View File

@ -50,7 +50,7 @@ a negative value indicates decreasing momentum.
- `EMA_3 = EMA(EMA(EMA(data)))`
- If there are not enough values to calculate a triple exponential derivative,
the output `_value` is `NaN`; all other columns are the same as the _last_ record of the input table.
- The function behaves the same way as the [`exponentialMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/exponentialmovingaverage/) function:
- The function behaves the same way as the [`exponentialMovingAverage()`](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/exponentialmovingaverage/) function:
- The function does not include `null` values in the calculation.
- The function acts only on the `_value` column.

View File

@ -74,7 +74,7 @@ rate = (tables=<-, every, groupColumns=[], unit=1s) =>
_**Used functions:**_
[aggregateWindow()](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/aggregatewindow/)
[derivative()](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/derivative/)
[derivative()](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/derivative/)
[experimental.group()](/influxdb/v2.0/reference/flux/stdlib/experimental/group/)
[group()](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/group/)
[mean()](/influxdb/v2.0/reference/flux/stdlib/built-in/transformations/aggregates/mean/)

View File

@ -11,7 +11,7 @@ menu:
parent: Prometheus
weight: 401
related:
- /influxdb/v2.0/write-data/scrape-data/scrapable-endpoints/
- /v2.0/write-data/no-code/scrape-data//scrapable-endpoints/
---
The `prometheus.scrape()` function retrieves [Prometheus-formatted metrics](https://prometheus.io/docs/instrumenting/exposition_formats/)

Some files were not shown because too many files have changed in this diff Show More