Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 12 additions & 7 deletions content/influxdb3/enterprise/admin/pachatree/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -36,8 +39,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` in InfluxQL.

Expand Down Expand Up @@ -71,13 +74,15 @@ 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.
>
> 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 >}}
10 changes: 7 additions & 3 deletions content/influxdb3/enterprise/admin/pachatree/configure.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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 \
Expand Down
11 changes: 7 additions & 4 deletions content/influxdb3/enterprise/admin/pachatree/monitor.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -111,9 +114,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
Expand Down Expand Up @@ -171,7 +174,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
Expand Down
32 changes: 32 additions & 0 deletions data/notifications.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -40,10 +40,42 @@
# - [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/
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.

message: |
InfluxDB 3 Enterprise 3.9 includes a private preview of major performance and
feature updates.

**Key improvements:**

- Faster single-series queries
- Consistent resource usage
- Wide-and-sparse table support
- Automatic distinct value caches for reduced latency with metadata queries

_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
scope:
- /
exclude:
- /influxdb3/enterprise/
title: New in InfluxDB 3.8
slug: |
Key enhancements in InfluxDB 3.8 and the InfluxDB 3 Explorer 1.6.
Expand Down
Loading