From c1be1b9543f4bf85080cfefc7f2750b73c09705e Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Wed, 28 Jan 2026 11:00:06 -0600 Subject: [PATCH 1/2] fix(influxdb3): Content improvements and site notification for performance preview - Fix grammar: 'Handle' -> 'Handles' for consistency - Fix spelling: 'hundres' -> 'hundreds' - Improve file format note wording and change to Important callout - Use AUTH_TOKEN placeholder with proper syntax in monitor.md - Fix unit spacing (500MB -> 500 MB) per style guide - Add site notification for 3.9 performance upgrade preview - Exclude Enterprise pages from 3.8 notification to avoid overlap --- .../enterprise/admin/pachatree/_index.md | 22 ++++++------ .../enterprise/admin/pachatree/monitor.md | 6 ++-- data/notifications.yaml | 36 +++++++++++++++++++ 3 files changed, 50 insertions(+), 14 deletions(-) diff --git a/content/influxdb3/enterprise/admin/pachatree/_index.md b/content/influxdb3/enterprise/admin/pachatree/_index.md index d889454be5..67d406cc65 100644 --- a/content/influxdb3/enterprise/admin/pachatree/_index.md +++ b/content/influxdb3/enterprise/admin/pachatree/_index.md @@ -36,8 +36,8 @@ these improvements will be coming to InfluxDB 3 Core in subsequent release cycle trends over long time windows, with single-digit millisecond response times. - **Consistent resource usage**: Reduced CPU and memory spikes during heavy compaction or ingestion bursts through key-range partitioning. -- **Wide-and-sparse table support**: Handle schemas with up to hundres of thousands of - columns and dynamic schema evolution without expensive rewrites. +- **Wide-and-sparse table support**: Handles schemas with up to hundreds of + thousands of columns and dynamic schema evolution without expensive rewrites. - **Automatic distinct value caches**: Dramatically reduced latency for metadata queries like "show tag values." @@ -69,15 +69,15 @@ query-heavy access patterns. Your feedback on stability and speed at scale helps inform the development of features planned for general availability in the 3.10 and 3.11 releases. -> [!Note] -> #### Important: Upgraded file format -> These upgrades use an upgraded file format (`.pt` files). When you enable the preview, -> your existing data is automatically upgraded to the new format in place. -> While downgrading is possible, any data written after the upgrade will not -> be included in the downgrade. +> [!Important] +> #### Upgraded file format +> These upgrades use a new file format (`.pt` files). When you enable the +> preview, your existing data is automatically converted to the new format +> in place. While you can downgrade, any data written after the upgrade is +> not available after downgrading. > -> Systems with large amounts of data may take time to complete the upgrade. -> For the beta, we recommend using a fresh setup for testing and evaluation -> rather than upgrading existing data. +> Systems with large amounts of data may take longer to complete the +> conversion. For the beta, we recommend starting with a fresh setup for +> testing and evaluation rather than converting existing data. {{< children hlevel="h2" readmore=true hr=true >}} diff --git a/content/influxdb3/enterprise/admin/pachatree/monitor.md b/content/influxdb3/enterprise/admin/pachatree/monitor.md index 03548fd6ed..f0b574bf46 100644 --- a/content/influxdb3/enterprise/admin/pachatree/monitor.md +++ b/content/influxdb3/enterprise/admin/pachatree/monitor.md @@ -111,9 +111,9 @@ analyzing query performance. Query the telemetry endpoint after executing a query: -```bash +```bash { placeholders="AUTH_TOKEN" } curl -X GET "http://localhost:8181/api/v3/query_sql_telemetry" \ - -H "Authorization: Bearer YOUR_TOKEN" + -H "Authorization: Bearer AUTH_TOKEN" ``` ### Telemetry response @@ -171,7 +171,7 @@ Monitor these metrics for write performance: | Metric | Healthy | Warning | Action | |:-------|:--------|:--------|:-------| | WAL file count | <50 | >100 | Increase merge concurrency | -| Unmerged size | <500MB | >1GB | Check compaction status | +| Unmerged size | <500 MB | >1 GB | Check compaction status | | Gen0 file count | <100 | >200 | Increase compaction concurrency | ### Monitor with SQL diff --git a/data/notifications.yaml b/data/notifications.yaml index 5c513b0ff5..247682033a 100644 --- a/data/notifications.yaml +++ b/data/notifications.yaml @@ -40,10 +40,46 @@ # - [The plan for InfluxDB 3.0 Open Source](https://influxdata.com/blog/the-plan-for-influxdb-3-0-open-source) # - [InfluxDB 3.0 benchmarks](https://influxdata.com/blog/influxdb-3-0-is-2.5x-45x-faster-compared-to-influxdb-open-source/) +- id: influxdb3.9-performance-preview + level: note + scope: + - /influxdb3/enterprise/ + title: 'InfluxDB 3.9: Performance upgrade preview' + slug: | + InfluxDB 3 Enterprise 3.9 includes a private preview of major performance upgrades + with faster single-series queries, wide-and-sparse table support, and more. + + Learn More + message: | + InfluxDB 3 Enterprise 3.9 includes a private preview of major performance and + feature updates. These updates represent the foundation for the upcoming 3.10 + and 3.11 releases. + + **Key improvements:** + + - **Faster single-series queries**: Optimized data path with single-digit + millisecond response times. + - **Consistent resource usage**: Reduced CPU and memory spikes during heavy + compaction or ingestion bursts. + - **Wide-and-sparse table support**: Handles schemas with up to hundreds of + thousands of columns. + - **Automatic distinct value caches**: Dramatically reduced latency for metadata + queries like "show tag values." + + > **Private preview beta**: These features are subject to breaking changes and + > should not be used for production workloads. + + For more information, see: + + - [Performance upgrade preview](/influxdb3/enterprise/admin/pachatree/) + - [InfluxDB 3 Enterprise release notes](/influxdb3/enterprise/release-notes/) + - id: influxdb3.8-explorer-1.6 level: note scope: - / + exclude: + - /influxdb3/enterprise/ title: New in InfluxDB 3.8 slug: | Key enhancements in InfluxDB 3.8 and the InfluxDB 3 Explorer 1.6. From 78491f69c4b76f4d638744067c854e7ddc40da92 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Wed, 28 Jan 2026 12:38:26 -0600 Subject: [PATCH 2/2] Clarify preview feedback instructions and update notification text --- .../enterprise/admin/pachatree/_index.md | 9 ++++++-- .../enterprise/admin/pachatree/configure.md | 10 ++++++--- .../enterprise/admin/pachatree/monitor.md | 5 ++++- data/notifications.yaml | 22 ++++++++----------- 4 files changed, 27 insertions(+), 19 deletions(-) diff --git a/content/influxdb3/enterprise/admin/pachatree/_index.md b/content/influxdb3/enterprise/admin/pachatree/_index.md index 958c67fb63..25387ae717 100644 --- a/content/influxdb3/enterprise/admin/pachatree/_index.md +++ b/content/influxdb3/enterprise/admin/pachatree/_index.md @@ -22,7 +22,10 @@ related: > #### Private preview beta > The performance upgrade preview is available to {{% product-name %}} Trial > and Commercial users as a private beta. These features are subject to breaking changes -> and **should not be used for production workloads**. Your feedback on stability +> and **should not be used for production workloads**. +> +> To share feedback on this preview, see [Support and feedback options](#bug-reports-and-feedback). +> Your feedback on stability > and performance at scale helps shape the future of InfluxDB 3. {{% product-name %}} includes a private preview of major performance and @@ -71,7 +74,9 @@ features planned for general availability in the 3.10 and 3.11 releases. > [!Important] > #### Important: Upgraded file format -> These upgrades use an upgraded file format (`.pt` files). When you enable the preview, +> +> These upgrades use a new file format (`.pt` files). +> When you enable the preview, > your existing data is automatically upgraded to the new format in place. > While downgrading is possible, any data written after the upgrade will not > be included in the downgrade. diff --git a/content/influxdb3/enterprise/admin/pachatree/configure.md b/content/influxdb3/enterprise/admin/pachatree/configure.md index c5b279c5a0..a6fb1b5e5f 100644 --- a/content/influxdb3/enterprise/admin/pachatree/configure.md +++ b/content/influxdb3/enterprise/admin/pachatree/configure.md @@ -21,9 +21,13 @@ related: > #### Private preview beta > The performance upgrade preview is available to {{% product-name %}} Trial > and Commercial users as a private beta. These features are subject to breaking changes -> and **should not be used for production workloads**. Your feedback on stability +> and **should not be used for production workloads**. +> +> To share feedback on this preview, see [Support and feedback options](#bug-reports-and-feedback). +> Your feedback on stability > and performance at scale helps shape the future of InfluxDB 3. + This page provides a complete reference for all configuration options available with these performance upgrades. All options require the `--use-pacha-tree` flag. @@ -54,7 +58,7 @@ Control how the upgraded storage uses memory for buffers, caches, and processing | `--pt-wal-max-buffer-size` | Maximum WAL buffer size before flush | `15MB` | | `--pt-snapshot-max-unmerged-size` | Unmerged data threshold for snapshot | `500MB` | | `--pt-merge-threshold-size` | Size threshold to trigger merge | `125MB` | -| `--pt-replica-max-buffer-size` | Query node buffer maximum | 50% system memory (max 16GB) | +| `--pt-replica-max-buffer-size` | Query node buffer maximum | 50% system memory (max 16 GB) | ### WAL buffer size @@ -372,7 +376,7 @@ influxdb3 serve \ --pt-compactor-concurrency 2 ``` -### Production all-in-one (8 cores, 32GB RAM) +### Production all-in-one (8 cores, 32 GB RAM) ```bash influxdb3 serve \ diff --git a/content/influxdb3/enterprise/admin/pachatree/monitor.md b/content/influxdb3/enterprise/admin/pachatree/monitor.md index f0b574bf46..c8c875838b 100644 --- a/content/influxdb3/enterprise/admin/pachatree/monitor.md +++ b/content/influxdb3/enterprise/admin/pachatree/monitor.md @@ -20,7 +20,10 @@ related: > #### Private preview beta > The performance upgrade preview is available to {{% product-name %}} Trial > and Commercial users as a private beta. These features are subject to breaking changes -> and **should not be used for production workloads**. Your feedback on stability +> and **should not be used for production workloads**. +> +> To share feedback on this preview, see [Support and feedback options](#bug-reports-and-feedback). +> Your feedback on stability > and performance at scale helps shape the future of InfluxDB 3. {{% product-name %}} provides system tables and a query telemetry endpoint to diff --git a/data/notifications.yaml b/data/notifications.yaml index 247682033a..8668e7fa9c 100644 --- a/data/notifications.yaml +++ b/data/notifications.yaml @@ -44,35 +44,31 @@ level: note scope: - /influxdb3/enterprise/ + exclude: + - /influxdb3/enterprise/admin/pachatree/ title: 'InfluxDB 3.9: Performance upgrade preview' slug: | InfluxDB 3 Enterprise 3.9 includes a private preview of major performance upgrades with faster single-series queries, wide-and-sparse table support, and more. - Learn More message: | InfluxDB 3 Enterprise 3.9 includes a private preview of major performance and - feature updates. These updates represent the foundation for the upcoming 3.10 - and 3.11 releases. + feature updates. **Key improvements:** - - **Faster single-series queries**: Optimized data path with single-digit - millisecond response times. - - **Consistent resource usage**: Reduced CPU and memory spikes during heavy - compaction or ingestion bursts. - - **Wide-and-sparse table support**: Handles schemas with up to hundreds of - thousands of columns. - - **Automatic distinct value caches**: Dramatically reduced latency for metadata - queries like "show tag values." + - Faster single-series queries + - Consistent resource usage + - Wide-and-sparse table support + - Automatic distinct value caches for reduced latency with metadata queries - > **Private preview beta**: These features are subject to breaking changes and - > should not be used for production workloads. + _Preview features are subject to breaking changes._ For more information, see: - [Performance upgrade preview](/influxdb3/enterprise/admin/pachatree/) - [InfluxDB 3 Enterprise release notes](/influxdb3/enterprise/release-notes/) + - [InfluxData Blog post](https://www.influxdata.com/blog/influxdb-3-9/") - id: influxdb3.8-explorer-1.6 level: note