Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge branch 'master' into clustered/install-reorg

pull/5636/head
Scott Anderson 2024-10-21 08:57:35 -06:00 committed by GitHub
parent 89d65c0ecf 15ee141a4f
commit d2c7f8f970
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
17 changed files with 216 additions and 56 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
.ci/vale/styles/Google/Ordinal.yml
View File

@ -5,3 +5,9 @@ level: error
nonword: true nonword: true
tokens: tokens:
- \d+(?:st|nd|rd|th) - \d+(?:st|nd|rd|th)
- tenth
exceptions:
- 0th
- 50th
- 90th

4
content/enterprise_influxdb/v1/administration/monitor/_index.md
View File

@ -12,7 +12,7 @@ Monitoring is the act of observing changes in data over time.
There are multiple ways to monitor your InfluxDB Enterprise cluster. There are multiple ways to monitor your InfluxDB Enterprise cluster.
See the guides below to monitor a cluster using another InfluxDB instance. See the guides below to monitor a cluster using another InfluxDB instance.
Alternatively, to view your output data occasionally (_e.g._, for auditing or diagnostics), Alternatively, to view your output data occasionally (for example, for auditing or diagnostics),
do one of the following: do one of the following:
- [Log and trace InfluxDB Enterprise operations](/enterprise_influxdb/v1/administration/monitor/logs/) - [Log and trace InfluxDB Enterprise operations](/enterprise_influxdb/v1/administration/monitor/logs/)
@ -22,7 +22,7 @@ do one of the following:
### Monitor with InfluxDB Insights ### Monitor with InfluxDB Insights
For InfluxDB Enterprise customers, Insights is a free service that monitors your cluster and sends metrics to a private Cloud account. This allows InfluxDB Support to monitor your cluster health and access usage statistics when assisting with support tickets that you raise. For InfluxDB Enterprise customers, Insights is a free service that monitors your cluster and sends metrics to a private Cloud account. This allows InfluxDB Support to monitor your cluster health and access usage statistics when assisting with support tickets that you raise.
To apply for this service, please contact the [support team](https://support.influxdata.com/s/login/). To apply for this service, please [contact InfluxData support](https://support.influxdata.com).
{{% /note %}} {{% /note %}}
{{< children >}} {{< children >}}

2
content/enterprise_influxdb/v1/administration/monitor/monitor-with-cloud.md
View File

@ -182,4 +182,4 @@ Send a notification to PagerDuty or HTTP endpoints (other webhooks) by [upgradin
For InfluxDB Enterprise customers, Insights is a free service that monitors your cluster and sends metrics to a private Cloud account. This allows InfluxDB Support to monitor your cluster health and access usage statistics when assisting with support tickets that you raise. For InfluxDB Enterprise customers, Insights is a free service that monitors your cluster and sends metrics to a private Cloud account. This allows InfluxDB Support to monitor your cluster health and access usage statistics when assisting with support tickets that you raise.
To apply for this service, please contact the [InfluxData Support team](mailto:support@influxdata.com). To apply for this service, please [contact InfluxData support](https://support.influxdata.com).

20
content/influxdb/cloud-dedicated/admin/monitor-your-cluster.md
View File

@ -10,9 +10,9 @@ menu:
weight: 104 weight: 104
--- ---
InfluxData provides a Grafana operational dashboard that provide observability InfluxData provides a Grafana operational dashboard that provides observability
into the your {{< product-name >}} cluster. Use the operational dashboard to into your {{< product-name >}} cluster.
monitor your cluster. Use the operational dashboard to monitor your cluster.
{{% note %}} {{% note %}}
#### Not available for all clusters #### Not available for all clusters
@ -40,7 +40,7 @@ If you do not have login credentials, [contact InfluxData support](https://suppo
## Dashboard sections and cells ## Dashboard sections and cells
The dashboard is divided into the following sections that visualize metrics The dashboard contains the following sections that visualize metrics
related to the health of components in your {{< product-name >}} cluster: related to the health of components in your {{< product-name >}} cluster:
- [Query Tier Cpu/Mem](#query-tier-cpumem) - [Query Tier Cpu/Mem](#query-tier-cpumem)
@ -156,7 +156,7 @@ to the [Object store](/influxdb/cloud-dedicated/reference/internals/storage-engi
#### CPU Utilization Ingesters (k8s) #### CPU Utilization Ingesters (k8s)
CPU Utilization of Ingester pods as reported by the Kubernetes container usage. CPU utilization of Ingester pods as reported by the Kubernetes container usage.
Usage is reported by the number of CPU cores used by pods, including Usage is reported by the number of CPU cores used by pods, including
fractional cores. fractional cores.
The CPU limit is represented by the top line in the visualization. The CPU limit is represented by the top line in the visualization.
@ -284,7 +284,7 @@ _These do not represent the most recent logs._
The **Compaction Tier Cpu/Mem** section displays the CPU and memory usage of The **Compaction Tier Cpu/Mem** section displays the CPU and memory usage of
Compactor pods as reported by Kubernetes. Compactor pods as reported by Kubernetes.
[Compactors](/influxdb/cloud-dedicated/reference/internals/storage-engine/#compactor) [Compactors](/influxdb/cloud-dedicated/reference/internals/storage-engine/#compactor)
process and compress parquet files in the process and compress Parquet files in the
[Object store](/influxdb/cloud-dedicated/reference/internals/storage-engine/#object-store) [Object store](/influxdb/cloud-dedicated/reference/internals/storage-engine/#object-store)
to continually optimize storage. to continually optimize storage.
@ -330,10 +330,10 @@ following levels:
Parquet files store data partitioned by time and optionally tags Parquet files store data partitioned by time and optionally tags
_(see [Manage data partition](https://docs.influxdata.com/influxdb/cloud-dedicated/admin/custom-partitions/))_. _(see [Manage data partition](https://docs.influxdata.com/influxdb/cloud-dedicated/admin/custom-partitions/))_.
After four L0 files accumulate for a partition, they are are eligible for compaction. After four L0 files accumulate for a partition, they're eligible for compaction.
If the compactor is keeping up with the incoming write load, all compaction If the compactor is keeping up with the incoming write load, all compaction
events will have exactly four files. If the number of L0 files compacted begins to events have exactly four files.
to increase, it indicates the compactor is not keeping up. An increase in the number of L0 files compacted indicates the compactor isn't keeping up.
This histogram helps to determine if the Compactor is starting compactions as This histogram helps to determine if the Compactor is starting compactions as
soon as it can. soon as it can.
@ -367,7 +367,7 @@ that the Catalog may be overloaded or unresponsive.
#### Catalog Op Latency (P90) #### Catalog Op Latency (P90)
The 90th percentile (P90) of query latency against the catalog service per operation. The 90th percentile (P90) query latency for each operation against the catalog service.
A high P90 value indicates that the Catalog may be overloaded. A high P90 value indicates that the Catalog may be overloaded.
--- ---

1
content/influxdb/cloud-dedicated/get-started/setup.md
View File

@ -14,6 +14,7 @@ weight: 101
metadata: [1 / 3] metadata: [1 / 3]
related: related:
- /influxdb/cloud-dedicated/admin/databases/ - /influxdb/cloud-dedicated/admin/databases/
- /influxdb/cloud-dedicated/admin/tokens/
- /influxdb/cloud-dedicated/reference/cli/influxctl/ - /influxdb/cloud-dedicated/reference/cli/influxctl/
- /influxdb/cloud-dedicated/reference/api/ - /influxdb/cloud-dedicated/reference/api/
--- ---

6
content/influxdb/cloud-dedicated/query-data/troubleshoot-and-optimize/analyze-query-plan.md
View File

@ -25,7 +25,7 @@ By learning how to generate and interpret reports for the query plan,
you can better understand how the query is executed and identify bottlenecks that affect the performance of your query. you can better understand how the query is executed and identify bottlenecks that affect the performance of your query.
For example, if the query plan reveals that your query reads a large number of Parquet files, For example, if the query plan reveals that your query reads a large number of Parquet files,
you can then take steps to [optimize your query](/influxdb/cloud-dedicated/query-data/optimize-queries/), such as add filters to read less data or you can then take steps to [optimize your query](/influxdb/cloud-dedicated/query-data/troubleshoot-and-optimize/optimize-queries/), such as add filters to read less data or
configure your cluster to store fewer and larger files. configure your cluster to store fewer and larger files.
- [Use EXPLAIN keywords to view a query plan](#use-explain-keywords-to-view-a-query-plan) - [Use EXPLAIN keywords to view a query plan](#use-explain-keywords-to-view-a-query-plan)
@ -113,7 +113,7 @@ Plans are in _tree format_--each plan is an upside-down tree in which
execution and data flow from _leaf nodes_, the innermost steps in the plan, to outer _branch nodes_. execution and data flow from _leaf nodes_, the innermost steps in the plan, to outer _branch nodes_.
Whether reading a logical or physical plan, keep the following in mind: Whether reading a logical or physical plan, keep the following in mind:
- Start at the the _leaf nodes_ and read upward. - Start at the _leaf nodes_ and read upward.
- At the top of the plan, the _root node_ represents the final, encompassing step. - At the top of the plan, the _root node_ represents the final, encompassing step.
In a [physical plan](/influxdb/cloud-dedicated/reference/internals/query-plan/#physical-plan), each step is an [`ExecutionPlan` node](/influxdb/cloud-dedicated/reference/internals/query-plan/#execution-plan-nodes) that receives expressions for input data and output requirements, and computes a partition of data. In a [physical plan](/influxdb/cloud-dedicated/reference/internals/query-plan/#physical-plan), each step is an [`ExecutionPlan` node](/influxdb/cloud-dedicated/reference/internals/query-plan/#execution-plan-nodes) that receives expressions for input data and output requirements, and computes a partition of data.
@ -770,4 +770,4 @@ Operator structure for aggregating, sorting, and final output.
- `SortPreservingMergeExec: [city@0 ASC NULLS LAST]`: Merges and sorts the four sorted streams for the final output. - `SortPreservingMergeExec: [city@0 ASC NULLS LAST]`: Merges and sorts the four sorted streams for the final output.
In the preceding examples, the `EXPLAIN` report shows the query plan without executing the query. In the preceding examples, the `EXPLAIN` report shows the query plan without executing the query.
To view runtime metrics, such as execution time for a plan and its operators, use [`EXPLAIN ANALYZE`](/influxdb/cloud-dedicated/reference/sql/explain/#explain-analyze) to generate the report and [tracing](/influxdb/cloud-dedicated/query-data/optimize-queries/#enable-trace-logging) for further debugging, if necessary. To view runtime metrics, such as execution time for a plan and its operators, use [`EXPLAIN ANALYZE`](/influxdb/cloud-dedicated/reference/sql/explain/#explain-analyze) to generate the report and [tracing](/influxdb/cloud-dedicated/query-data/troubleshoot-and-optimize/optimize-queries/#enable-trace-logging) for further debugging, if necessary.

1
content/influxdb/cloud-dedicated/query-data/troubleshoot-and-optimize/optimize-queries.md
View File

@ -16,6 +16,7 @@ related:
aliases: aliases:
- /influxdb/cloud-dedicated/query-data/execute-queries/optimize-queries/ - /influxdb/cloud-dedicated/query-data/execute-queries/optimize-queries/
- /influxdb/cloud-dedicated/query-data/execute-queries/analyze-query-plan/ - /influxdb/cloud-dedicated/query-data/execute-queries/analyze-query-plan/
- /influxdb/cloud-dedicated/query-data/optimize-queries/
--- ---
Optimize SQL and InfluxQL queries to improve performance and reduce their memory and compute (CPU) requirements. Optimize SQL and InfluxQL queries to improve performance and reduce their memory and compute (CPU) requirements.

26
content/influxdb/cloud-dedicated/reference/cli/influxctl/_index.md
View File

@ -17,7 +17,7 @@ administrative tasks in an {{< product-name omit=" Clustered" >}} cluster.
- [Usage](#usage) - [Usage](#usage)
- [Commands](#commands) - [Commands](#commands)
- [Flags](#command-flags) - [Global flags](#global-flags)
- [Download and install influxctl](#download-and-install-influxctl) - [Download and install influxctl](#download-and-install-influxctl)
- [Configure connection profiles](#configure-connection-profiles) - [Configure connection profiles](#configure-connection-profiles)
- [Authentication](#authentication) - [Authentication](#authentication)
@ -25,14 +25,14 @@ administrative tasks in an {{< product-name omit=" Clustered" >}} cluster.
## Usage ## Usage
```sh ```sh
influxctl [flags] [command] influxctl [global-flags] [command]
``` ```
## Commands ## Commands
| Command | Description | | Command | Description |
| :-------------------------------------------------------------------------- | :------------------------------------- | | :-------------------------------------------------------------------------- | :------------------------------------- |
| [auth](/influxdb/cloud-dedicated/reference/cli/influxctl/auth/) | Log in to or log out of InfluxDB v3 | | [auth](/influxdb/cloud-dedicated/reference/cli/influxctl/auth/) | Log in to or log out of InfluxDB v3 |
| [cluster](/influxdb/cloud-dedicated/reference/cli/influxctl/cluster/) | List InfluxDB v3 cluster information | | [cluster](/influxdb/cloud-dedicated/reference/cli/influxctl/cluster/) | List InfluxDB v3 cluster information |
| [database](/influxdb/cloud-dedicated/reference/cli/influxctl/database/) | Manage InfluxDB v3 databases | | [database](/influxdb/cloud-dedicated/reference/cli/influxctl/database/) | Manage InfluxDB v3 databases |
| [help](/influxdb/cloud-dedicated/reference/cli/influxctl/help/) | Output `influxctl` help information | | [help](/influxdb/cloud-dedicated/reference/cli/influxctl/help/) | Output `influxctl` help information |
@ -45,15 +45,16 @@ influxctl [flags] [command]
## Global flags ## Global flags
| Flag | | Description | | Flag | | Description |
| :--- | :---------- | :--------------------------------------------------------- | | :--- | :---------- | :----------------------------------------------------------- |
| | `--debug` | Enable debug logging | | | `--debug` | Enable debug logging |
| | `--account` | Override account ID value in configuration file | | | `--account` | Override account ID value in configuration file |
| | `--cluster` | Override cluster ID value in configuration file | | | `--cluster` | Override cluster ID value in configuration file |
| | `--config` | Path to configuration file to use | | | `--config` | Path to configuration file to use |
| | `--profile` | Specify a connection profile to use (default is `default`) | | | `--profile` | Specify a connection profile to use (default is `default`) |
| | `--trace` | Enable more verbose debug logging | | | `--timeout` | Specify a timeout duration for API calls (default is `1m0s`) |
| `-h` | `--help` | Show help | | | `--trace` | Enable more verbose debug logging |
| `-h` | `--help` | Show help |
--- ---
@ -344,7 +345,6 @@ If stored at a non-default location, include the `--config` flag with each
## OAuth2 client authorization settings ## OAuth2 client authorization settings
# [profile.auth.oauth2] # [profile.auth.oauth2]
# client_id = "" # client_id = ""
# client_secret = ""
# scopes = [""] # scopes = [""]
# parameters = { audience = "" } # parameters = { audience = "" }
# token_url = "https://indentityprovider/oauth2/v2/token" # token_url = "https://indentityprovider/oauth2/v2/token"

56
content/influxdb/cloud-dedicated/reference/release-notes/influxctl.md
View File

@ -11,12 +11,54 @@ menu:
weight: 202 weight: 202
--- ---
## v2.9.8 {date="2024-10-15"}
### Bug Fixes
- Continue revoking tokens on error.
- Reject unsupported input to `--template-timeformat`.
- Remove unused `client_secret` option from
[connection configuration profiles](/influxdb/cloud-dedicated/reference/cli/influxctl/#configure-connection-profiles).
### Dependency Updates
- Update Go to v1.23.2.
- Update `github.com/jedib0t/go-pretty/v6` from 6.5.9 to 6.6.0.
- Update `github.com/urfave/cli/v2` from 2.27.4 to 2.27.5.
- Update `google.golang.org/grpc` from 1.66.0 to 1.67.1.
- Update `google.golang.org/protobuf` from 1.34.2 to 1.35.1.
---
## v2.9.7 {date="2024-09-11"}
### Features
- Add [global `--timeout` flag](/influxdb/cloud-dedicated/reference/cli/influxctl/#global-flags).
- Improve timezone support.
### Bug Fixes
- Use passthrough resolver for gRPC.
### Dependency Updates
- Update Go to 1.23.1.
- Update `github.com/pelletier/go-toml/v2` from 2.2.2 to 2.2.3.
- Update `golang.org/x/mod` from 0.20.0 to 0.21.0.
- Update `golang.org/x/oauth2` from 0.22.0 to 0.23.0.
- Update `google.golang.org/grpc` from 1.65.0 to 1.66.0.
---
## v2.9.6 {date="2024-08-15"} ## v2.9.6 {date="2024-08-15"}
### Bug Fixes ### Bug Fixes
- Update query to wait for EOF on stdin instead of the first newline. - Update query to wait for EOF on stdin instead of the first newline.
---
## v2.9.5 {date="2024-08-13"} ## v2.9.5 {date="2024-08-13"}
### Bug Fixes ### Bug Fixes
@ -29,6 +71,8 @@ weight: 202
- Update `golang.org/x/mod` from 0.19.0 to 0.20.0 - Update `golang.org/x/mod` from 0.19.0 to 0.20.0
- Update `golang.org/x/oauth2` from 0.21.0 to 0.22.0 - Update `golang.org/x/oauth2` from 0.21.0 to 0.22.0
---
## v2.9.4 {date="2024-07-25"} ## v2.9.4 {date="2024-07-25"}
### Bug Fixes ### Bug Fixes
@ -40,12 +84,16 @@ weight: 202
- Update `golang.org/x/mod` from 0.18.0 to 0.19.0 - Update `golang.org/x/mod` from 0.18.0 to 0.19.0
- Update `google.golang.org/grpc` from 1.64.0 to 1.65.0 - Update `google.golang.org/grpc` from 1.64.0 to 1.65.0
---
## v2.9.3 {date="2024-06-26"} ## v2.9.3 {date="2024-06-26"}
### Bug Fixes ### Bug Fixes
- Update query subcommand to safely handle null timestamp in response. - Update query subcommand to safely handle null timestamp in response.
---
## v2.9.2 {date="2024-06-17"} ## v2.9.2 {date="2024-06-17"}
### Bug Fixes ### Bug Fixes
@ -56,6 +104,8 @@ weight: 202
- Update `google.golang.org/protobuf` from 1.34.1 to 1.34.2. - Update `google.golang.org/protobuf` from 1.34.1 to 1.34.2.
---
## v2.9.1 {date="2024-06-06"} ## v2.9.1 {date="2024-06-06"}
### Dependency Updates ### Dependency Updates
@ -69,6 +119,8 @@ weight: 202
- Update `google.golang.org/protobuf` from 1.34.0 to 1.34.1 - Update `google.golang.org/protobuf` from 1.34.0 to 1.34.1
- Update build dependencies. - Update build dependencies.
---
## v2.9.0 {date="2024-05-06"} ## v2.9.0 {date="2024-05-06"}
### Features ### Features
@ -80,7 +132,7 @@ weight: 202
- Update unimplemented error message with additional information. - Update unimplemented error message with additional information.
### Dependecy Updates ### Dependency Updates
- Update `github.com/apache/arrow/go/v16` from 16.0.0-20240401180149-68241d8a86e9 to 16.0.0. - Update `github.com/apache/arrow/go/v16` from 16.0.0-20240401180149-68241d8a86e9 to 16.0.0.
- Update `github.com/jedib0t/go-pretty/v6` from 6.5.8 to 6.5.9. - Update `github.com/jedib0t/go-pretty/v6` from 6.5.8 to 6.5.9.
@ -188,7 +240,7 @@ associated with another InfluxDB cluster.
### Bug Fixes ### Bug Fixes
- Update arrow to allow non-TLS connections. - Update Arrow to allow non-TLS connections.
- Do not attempt to load cached tokens when an admin token file is provided. - Do not attempt to load cached tokens when an admin token file is provided.
- Print retention period up to days rather than very large hours. - Print retention period up to days rather than very large hours.
- Fix indentation of help output. - Fix indentation of help output.

8
content/influxdb/cloud-serverless/query-data/troubleshoot-and-optimize/analyze-query-plan.md
View File

@ -24,7 +24,7 @@ By learning how to generate and interpret reports for the query plan,
you can better understand how the query is executed and identify bottlenecks that affect the performance of your query. you can better understand how the query is executed and identify bottlenecks that affect the performance of your query.
For example, if the query plan reveals that your query reads a large number of Parquet files, For example, if the query plan reveals that your query reads a large number of Parquet files,
you can then take steps to [optimize your query](/influxdb/cloud-serverless/query-data/optimize-queries/), such as add filters to read less data. you can then take steps to [optimize your query](/influxdb/cloud-serverless/query-data/troubleshoot-and-optimize/optimize-queries/), such as add filters to read less data.
- [Use EXPLAIN keywords to view a query plan](#use-explain-keywords-to-view-a-query-plan) - [Use EXPLAIN keywords to view a query plan](#use-explain-keywords-to-view-a-query-plan)
- [Read an EXPLAIN report](#read-an-explain-report) - [Read an EXPLAIN report](#read-an-explain-report)
@ -65,7 +65,7 @@ import pandas as pd
import tabulate # Required for pandas.to_markdown() import tabulate # Required for pandas.to_markdown()
# Instantiate an InfluxDB client. # Instantiate an InfluxDB client.
client = InfluxDBClient3(token = f"TOKEN", client = InfluxDBClient3(token = f"API_TOKEN",
host = f"{{< influxdb/host >}}", host = f"{{< influxdb/host >}}",
database = f"BUCKET_NAME") database = f"BUCKET_NAME")
@ -109,7 +109,7 @@ Plans are in _tree format_--each plan is an upside-down tree in which
execution and data flow from _leaf nodes_, the innermost steps in the plan, to outer _branch nodes_. execution and data flow from _leaf nodes_, the innermost steps in the plan, to outer _branch nodes_.
Whether reading a logical or physical plan, keep the following in mind: Whether reading a logical or physical plan, keep the following in mind:
- Start at the the _leaf nodes_ and read upward. - Start at the _leaf nodes_ and read upward.
- At the top of the plan, the _root node_ represents the final, encompassing execution step. - At the top of the plan, the _root node_ represents the final, encompassing execution step.
In a [physical plan](/influxdb/cloud-serverless/reference/internals/query-plan/#physical-plan), each step is an [`ExecutionPlan` node](/influxdb/cloud-serverless/reference/internals/query-plan/#executionplan-nodes) that receives expressions for input data and output requirements, and computes a partition of data. In a [physical plan](/influxdb/cloud-serverless/reference/internals/query-plan/#physical-plan), each step is an [`ExecutionPlan` node](/influxdb/cloud-serverless/reference/internals/query-plan/#executionplan-nodes) that receives expressions for input data and output requirements, and computes a partition of data.
@ -766,4 +766,4 @@ Operator structure for aggregating, sorting, and final output.
- `SortPreservingMergeExec: [city@0 ASC NULLS LAST]`: Merges and sorts the four sorted streams for the final output. - `SortPreservingMergeExec: [city@0 ASC NULLS LAST]`: Merges and sorts the four sorted streams for the final output.
In the preceding examples, the `EXPLAIN` report shows the query plan without executing the query. In the preceding examples, the `EXPLAIN` report shows the query plan without executing the query.
To view runtime metrics, such as execution time for a plan and its operators, use [`EXPLAIN ANALYZE`](/influxdb/cloud-serverless/reference/sql/explain/#explain-analyze) to generate the report and [tracing](/influxdb/cloud-serverless/query-data/optimize-queries/#enable-trace-logging) for further debugging, if necessary. To view runtime metrics, such as execution time for a plan and its operators, use [`EXPLAIN ANALYZE`](/influxdb/cloud-serverless/reference/sql/explain/#explain-analyze) to generate the report and [tracing](/influxdb/cloud-serverless/query-data/troubleshoot-and-optimize/optimize-queries/#enable-trace-logging) for further debugging, if necessary.

1
content/influxdb/cloud-serverless/query-data/troubleshoot-and-optimize/optimize-queries.md
View File

@ -15,6 +15,7 @@ related:
- /influxdb/cloud-serverless/query-data/execute-queries/analyze-query-plan/ - /influxdb/cloud-serverless/query-data/execute-queries/analyze-query-plan/
aliases: aliases:
- /influxdb/cloud-serverless/query-data/execute-queries/optimize-queries/ - /influxdb/cloud-serverless/query-data/execute-queries/optimize-queries/
- /influxdb/cloud-serverless/query-data/optimize-queries/
--- ---
Optimize SQL and InfluxQL queries to improve performance and reduce their memory and compute (CPU) requirements. Optimize SQL and InfluxQL queries to improve performance and reduce their memory and compute (CPU) requirements.

6
content/influxdb/clustered/query-data/troubleshoot-and-optimize/analyze-query-plan.md
View File

@ -25,7 +25,7 @@ By learning how to generate and interpret reports for the query plan,
you can better understand how the query is executed and identify bottlenecks that affect the performance of your query. you can better understand how the query is executed and identify bottlenecks that affect the performance of your query.
For example, if the query plan reveals that your query reads a large number of Parquet files, For example, if the query plan reveals that your query reads a large number of Parquet files,
you can then take steps to [optimize your query](/influxdb/clustered/query-data/optimize-queries/), such as add filters to read less data or you can then take steps to [optimize your query](/influxdb/clustered/query-data/troubleshoot-and-optimize/optimize-queries/), such as add filters to read less data or
configure your cluster to store fewer and larger files. configure your cluster to store fewer and larger files.
- [Use EXPLAIN keywords to view a query plan](#use-explain-keywords-to-view-a-query-plan) - [Use EXPLAIN keywords to view a query plan](#use-explain-keywords-to-view-a-query-plan)
@ -113,7 +113,7 @@ Plans are in _tree format_--each plan is an upside-down tree in which
execution and data flow from _leaf nodes_, the innermost steps in the plan, to outer _branch nodes_. execution and data flow from _leaf nodes_, the innermost steps in the plan, to outer _branch nodes_.
Whether reading a logical or physical plan, keep the following in mind: Whether reading a logical or physical plan, keep the following in mind:
- Start at the the _leaf nodes_ and read upward. - Start at the _leaf nodes_ and read upward.
- At the top of the plan, the _root node_ represents the final, encompassing step. - At the top of the plan, the _root node_ represents the final, encompassing step.
In a [physical plan](/influxdb/clustered/reference/internals/query-plan/#physical-plan), each step is an [`ExecutionPlan` node](/influxdb/clustered/reference/internals/query-plan/#executionplan-nodes) that receives expressions for input data and output requirements, and computes a partition of data. In a [physical plan](/influxdb/clustered/reference/internals/query-plan/#physical-plan), each step is an [`ExecutionPlan` node](/influxdb/clustered/reference/internals/query-plan/#executionplan-nodes) that receives expressions for input data and output requirements, and computes a partition of data.
@ -770,4 +770,4 @@ Operator structure for aggregating, sorting, and final output.
- `SortPreservingMergeExec: [city@0 ASC NULLS LAST]`: Merges and sorts the four sorted streams for the final output. - `SortPreservingMergeExec: [city@0 ASC NULLS LAST]`: Merges and sorts the four sorted streams for the final output.
In the preceding examples, the `EXPLAIN` report shows the query plan without executing the query. In the preceding examples, the `EXPLAIN` report shows the query plan without executing the query.
To view runtime metrics, such as execution time for a plan and its operators, use [`EXPLAIN ANALYZE`](/influxdb/clustered/reference/sql/explain/#explain-analyze) to generate the report and use [tracing](/influxdb/clustered/query-data/optimize-queries/#enable-trace-logging) for further debugging, if necessary. To view runtime metrics, such as execution time for a plan and its operators, use [`EXPLAIN ANALYZE`](/influxdb/clustered/reference/sql/explain/#explain-analyze) to generate the report and use [tracing](/influxdb/clustered/query-data/troubleshoot-and-optimize/optimize-queries/#enable-trace-logging) for further debugging, if necessary.

1
content/influxdb/clustered/query-data/troubleshoot-and-optimize/optimize-queries.md
View File

@ -16,6 +16,7 @@ related:
aliases: aliases:
- /influxdb/clustered/query-data/execute-queries/optimize-queries/ - /influxdb/clustered/query-data/execute-queries/optimize-queries/
- /influxdb/clustered/query-data/execute-queries/analyze-query-plan/ - /influxdb/clustered/query-data/execute-queries/analyze-query-plan/
- /influxdb/clustered/query-data/optimize-queries/
--- ---
Optimize SQL and InfluxQL queries to improve performance and reduce their memory and compute (CPU) requirements. Optimize SQL and InfluxQL queries to improve performance and reduce their memory and compute (CPU) requirements.

26
content/influxdb/clustered/reference/cli/influxctl/_index.md
View File

@ -17,7 +17,7 @@ administrative tasks in an {{< product-name omit=" Clustered" >}} cluster.
- [Usage](#usage) - [Usage](#usage)
- [Commands](#commands) - [Commands](#commands)
- [Flags](#command-flags) - [Global flags](#global-flags)
- [Download and install influxctl](#download-and-install-influxctl) - [Download and install influxctl](#download-and-install-influxctl)
- [Configure connection profiles](#configure-connection-profiles) - [Configure connection profiles](#configure-connection-profiles)
- [Authentication](#authentication) - [Authentication](#authentication)
@ -25,14 +25,14 @@ administrative tasks in an {{< product-name omit=" Clustered" >}} cluster.
## Usage ## Usage
```sh ```sh
influxctl [flags] [command] influxctl [global-flags] [command]
``` ```
## Commands ## Commands
| Command | Description | | Command | Description |
| :-------------------------------------------------------------------- | :------------------------------------- | | :-------------------------------------------------------------------- | :------------------------------------- |
| [auth](/influxdb/clustered/reference/cli/influxctl/auth/) | Log in to or log out of InfluxDB v3 | | [auth](/influxdb/clustered/reference/cli/influxctl/auth/) | Log in to or log out of InfluxDB v3 |
| [cluster](/influxdb/clustered/reference/cli/influxctl/cluster/) | List InfluxDB v3 cluster information | | [cluster](/influxdb/clustered/reference/cli/influxctl/cluster/) | List InfluxDB v3 cluster information |
| [database](/influxdb/clustered/reference/cli/influxctl/database/) | Manage InfluxDB v3 databases | | [database](/influxdb/clustered/reference/cli/influxctl/database/) | Manage InfluxDB v3 databases |
| [help](/influxdb/clustered/reference/cli/influxctl/help/) | Output `influxctl` help information | | [help](/influxdb/clustered/reference/cli/influxctl/help/) | Output `influxctl` help information |
@ -45,15 +45,16 @@ influxctl [flags] [command]
## Global flags ## Global flags
| Flag | | Description | | Flag | | Description |
| :--- | :---------- | :--------------------------------------------------------- | | :--- | :---------- | :----------------------------------------------------------- |
| | `--debug` | Enable debug logging | | | `--debug` | Enable debug logging |
| | `--account` | Override account ID value in configuration file | | | `--account` | Override account ID value in configuration file |
| | `--cluster` | Override cluster ID value in configuration file | | | `--cluster` | Override cluster ID value in configuration file |
| | `--config` | Path to configuration file to use | | | `--config` | Path to configuration file to use |
| | `--profile` | Specify a connection profile to use (default is `default`) | | | `--profile` | Specify a connection profile to use (default is `default`) |
| | `--trace` | Enable more verbose debug logging | | | `--timeout` | Specify a timeout duration for API calls (default is `1m0s`) |
| `-h` | `--help` | Show help | | | `--trace` | Enable more verbose debug logging |
| `-h` | `--help` | Show help |
--- ---
@ -354,7 +355,6 @@ If stored at a non-default location, include the `--config` flag with each
## OAuth2 client authorization settings ## OAuth2 client authorization settings
[profile.auth.oauth2] [profile.auth.oauth2]
client_id = "OAUTH_CLIENT_ID" client_id = "OAUTH_CLIENT_ID"
client_secret = ""
scopes = [""] scopes = [""]
parameters = { audience = "" } parameters = { audience = "" }
token_url = "OAUTH_TOKEN_URL" token_url = "OAUTH_TOKEN_URL"

58
content/influxdb/clustered/reference/release-notes/influxctl.md
View File

@ -12,11 +12,53 @@ weight: 202
canonical: /influxdb/cloud-dedicated/reference/release-notes/influxctl/ canonical: /influxdb/cloud-dedicated/reference/release-notes/influxctl/
--- ---
## v2.9.8 {date="2024-10-15"}
### Bug Fixes
- Continue revoking tokens on error.
- Reject unsupported input to `--template-timeformat`.
- Remove unused `client_secret` option from
[connection configuration profiles](/influxdb/clustered/reference/cli/influxctl/#configure-connection-profiles).
### Dependency Updates
- Update Go to v1.23.2.
- Update `github.com/jedib0t/go-pretty/v6` from 6.5.9 to 6.6.0.
- Update `github.com/urfave/cli/v2` from 2.27.4 to 2.27.5.
- Update `google.golang.org/grpc` from 1.66.0 to 1.67.1.
- Update `google.golang.org/protobuf` from 1.34.2 to 1.35.1.
---
## v2.9.7 {date="2024-09-11"}
### Features
- Add [global `--timeout` flag](/influxdb/clustered/reference/cli/influxctl/#global-flags).
- Improve timezone support.
### Bug Fixes
- Use passthrough resolver for gRPC.
### Dependency Updates
- Update Go to 1.23.1.
- Update `github.com/pelletier/go-toml/v2` from 2.2.2 to 2.2.3.
- Update `golang.org/x/mod` from 0.20.0 to 0.21.0.
- Update `golang.org/x/oauth2` from 0.22.0 to 0.23.0.
- Update `google.golang.org/grpc` from 1.65.0 to 1.66.0.
---
## v2.9.6 {date="2024-08-15"} ## v2.9.6 {date="2024-08-15"}
### Bug Fixes ### Bug Fixes
- Update query subcommand to wait for EOF on stdin instead of the first newline. - Update query to wait for EOF on stdin instead of the first newline.
---
## v2.9.5 {date="2024-08-13"} ## v2.9.5 {date="2024-08-13"}
@ -31,6 +73,8 @@ canonical: /influxdb/cloud-dedicated/reference/release-notes/influxctl/
- Update `golang.org/x/mod` from 0.19.0 to 0.20.0 - Update `golang.org/x/mod` from 0.19.0 to 0.20.0
- Update `golang.org/x/oauth2` from 0.21.0 to 0.22.0 - Update `golang.org/x/oauth2` from 0.21.0 to 0.22.0
---
## v2.9.4 {date="2024-07-25"} ## v2.9.4 {date="2024-07-25"}
### Bug Fixes ### Bug Fixes
@ -42,12 +86,16 @@ canonical: /influxdb/cloud-dedicated/reference/release-notes/influxctl/
- Update `golang.org/x/mod` from 0.18.0 to 0.19.0 - Update `golang.org/x/mod` from 0.18.0 to 0.19.0
- Update `google.golang.org/grpc` from 1.64.0 to 1.65.0 - Update `google.golang.org/grpc` from 1.64.0 to 1.65.0
---
## v2.9.3 {date="2024-06-26"} ## v2.9.3 {date="2024-06-26"}
### Bug Fixes ### Bug Fixes
- Update query subcommand to safely handle null timestamp in response. - Update query subcommand to safely handle null timestamp in response.
---
## v2.9.2 {date="2024-06-17"} ## v2.9.2 {date="2024-06-17"}
### Bug Fixes ### Bug Fixes
@ -58,6 +106,8 @@ canonical: /influxdb/cloud-dedicated/reference/release-notes/influxctl/
- Update `google.golang.org/protobuf` from 1.34.1 to 1.34.2. - Update `google.golang.org/protobuf` from 1.34.1 to 1.34.2.
---
## v2.9.1 {date="2024-06-06"} ## v2.9.1 {date="2024-06-06"}
### Dependency Updates ### Dependency Updates
@ -71,6 +121,8 @@ canonical: /influxdb/cloud-dedicated/reference/release-notes/influxctl/
- Update `google.golang.org/protobuf` from 1.34.0 to 1.34.1 - Update `google.golang.org/protobuf` from 1.34.0 to 1.34.1
- Update build dependencies. - Update build dependencies.
---
## v2.9.0 {date="2024-05-06"} ## v2.9.0 {date="2024-05-06"}
### Features ### Features
@ -82,7 +134,7 @@ canonical: /influxdb/cloud-dedicated/reference/release-notes/influxctl/
- Update unimplemented error message with additional information. - Update unimplemented error message with additional information.
### Dependecy Updates ### Dependency Updates
- Update `github.com/apache/arrow/go/v16` from 16.0.0-20240401180149-68241d8a86e9 to 16.0.0. - Update `github.com/apache/arrow/go/v16` from 16.0.0-20240401180149-68241d8a86e9 to 16.0.0.
- Update `github.com/jedib0t/go-pretty/v6` from 6.5.8 to 6.5.9. - Update `github.com/jedib0t/go-pretty/v6` from 6.5.8 to 6.5.9.
@ -197,7 +249,7 @@ associated with another InfluxDB cluster.
### Bug Fixes ### Bug Fixes
- Update arrow to allow non-TLS connections. - Update Arrow to allow non-TLS connections.
- Do not attempt to load cached tokens when an admin token file is provided. - Do not attempt to load cached tokens when an admin token file is provided.
- Print retention period up to days rather than very large hours. - Print retention period up to days rather than very large hours.
- Fix indentation of help output. - Fix indentation of help output.

46
content/telegraf/v1/release-notes.md
View File

@ -11,6 +11,52 @@ menu:
weight: 60 weight: 60
--- ---
## v1.32.1 {date="2024-10-07"}
### Important Changes
- PR [#15796](https://github.com/influxdata/telegraf/pull/15796) changes the
delivery state update of un-parseable messages from `ACK` to `NACK` without
requeueing. This way, those messages are not lost and can optionally be
handled using a dead-letter exchange by other means.
### Bugfixes
- [#15969](https://github.com/influxdata/telegraf/pull/15969) `agent` Fix buffer not flushing if all metrics are written
- [#15937](https://github.com/influxdata/telegraf/pull/15937) `config` Correctly print removal version info
- [#15900](https://github.com/influxdata/telegraf/pull/15900) `common.http` Keep timeout after creating oauth client
- [#15796](https://github.com/influxdata/telegraf/pull/15796) `inputs.amqp_consumer` NACKing messages on non-delivery related errors
- [#15923](https://github.com/influxdata/telegraf/pull/15923) `inputs.cisco_telemetry_mdt` Handle NXOS DME subtree telemetry format
- [#15907](https://github.com/influxdata/telegraf/pull/15907) `inputs.consul` Move config checking to Init method
- [#15982](https://github.com/influxdata/telegraf/pull/15982) `inputs.influxdb_v2_listener` Fix concurrent read/write dict
- [#15960](https://github.com/influxdata/telegraf/pull/15960) `inputs.vsphere` Add tags to VSAN ESA disks
- [#15921](https://github.com/influxdata/telegraf/pull/15921) `parsers.avro` Add mutex to cache access
- [#15965](https://github.com/influxdata/telegraf/pull/15965) `processors.aws_ec2` Remove leading slash and cancel worker only if it exists
### Dependency Updates
- [#15932](https://github.com/influxdata/telegraf/pull/15932) `deps` Bump cloud.google.com/go/monitoring from 1.20.2 to 1.21.1
- [#15863](https://github.com/influxdata/telegraf/pull/15863) `deps` Bump github.com/Azure/azure-kusto-go from 0.15.3 to 0.16.1
- [#15862](https://github.com/influxdata/telegraf/pull/15862) `deps` Bump github.com/Azure/azure-sdk-for-go/sdk/azcore from 1.13.0 to 1.14.0
- [#15957](https://github.com/influxdata/telegraf/pull/15957) `deps` Bump github.com/aws/aws-sdk-go-v2/feature/ec2/imds from 1.16.12 to 1.16.14
- [#15859](https://github.com/influxdata/telegraf/pull/15859) `deps` Bump github.com/aws/aws-sdk-go-v2/service/dynamodb from 1.34.4 to 1.34.9
- [#15931](https://github.com/influxdata/telegraf/pull/15931) `deps` Bump github.com/boschrexroth/ctrlx-datalayer-golang from 1.3.0 to 1.3.1
- [#15890](https://github.com/influxdata/telegraf/pull/15890) `deps` Bump github.com/harlow/kinesis-consumer from v0.3.6-0.20240606153816-553e2392fdf3 to v0.3.6-0.20240916192723-43900507c911
- [#15904](https://github.com/influxdata/telegraf/pull/15904) `deps` Bump github.com/netsampler/goflow2/v2 from 2.1.5 to 2.2.1
- [#15903](https://github.com/influxdata/telegraf/pull/15903) `deps` Bump github.com/p4lang/p4runtime from 1.3.0 to 1.4.0
- [#15905](https://github.com/influxdata/telegraf/pull/15905) `deps` Bump github.com/prometheus/client_golang from 1.20.2 to 1.20.3
- [#15930](https://github.com/influxdata/telegraf/pull/15930) `deps` Bump github.com/prometheus/client_golang from 1.20.3 to 1.20.4
- [#15962](https://github.com/influxdata/telegraf/pull/15962) `deps` Bump github.com/prometheus/common from 0.55.0 to 0.60.0
- [#15860](https://github.com/influxdata/telegraf/pull/15860) `deps` Bump github.com/snowflakedb/gosnowflake from 1.10.0 to 1.11.1
- [#15954](https://github.com/influxdata/telegraf/pull/15954) `deps` Bump github.com/srebhan/protobufquery from 0.0.0-20230803132024-ae4c0d878e55 to 1.0.1
- [#15929](https://github.com/influxdata/telegraf/pull/15929) `deps` Bump go.mongodb.org/mongo-driver from 1.16.0 to 1.17.0
- [#15902](https://github.com/influxdata/telegraf/pull/15902) `deps` Bump golang.org/x/mod from 0.19.0 to 0.21.0
- [#15955](https://github.com/influxdata/telegraf/pull/15955) `deps` Bump golang.org/x/oauth2 from 0.21.0 to 0.23.0
- [#15861](https://github.com/influxdata/telegraf/pull/15861) `deps` Bump golang.org/x/term from 0.23.0 to 0.24.0
- [#15856](https://github.com/influxdata/telegraf/pull/15856) `deps` Bump golangci-lint from v1.60.3 to v1.61.0
- [#15933](https://github.com/influxdata/telegraf/pull/15933) `deps` Bump k8s.io/apimachinery from 0.30.1 to 0.31.1
- [#15901](https://github.com/influxdata/telegraf/pull/15901) `deps` Bump modernc.org/sqlite from 1.32.0 to 1.33.1
## v1.32.0 {date="2024-09-09"} ## v1.32.0 {date="2024-09-09"}
### Important Changes ### Important Changes

4
data/products.yml
View File

@ -55,7 +55,7 @@ influxdb_cloud_dedicated:
list_order: 3 list_order: 3
latest: cloud-dedicated latest: cloud-dedicated
link: "https://www.influxdata.com/contact-sales-form/" link: "https://www.influxdata.com/contact-sales-form/"
latest_cli: 2.9.7 latest_cli: 2.9.8
placeholder_host: cluster-id.a.influxdb.io placeholder_host: cluster-id.a.influxdb.io
influxdb_clustered: influxdb_clustered:
@ -77,7 +77,7 @@ telegraf:
versions: [v1] versions: [v1]
latest: v1.32 latest: v1.32
latest_patches: latest_patches:
v1: 1.32.0 v1: 1.32.1
chronograf: chronograf:
name: Chronograf name: Chronograf