---
title: Capture workload data
description: Capture a time-limited, anonymized profile of write and query requests in InfluxDB 3 Enterprise.
url: https://docs.influxdata.com/influxdb3/enterprise/admin/load-capture/
estimated_tokens: 537
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/admin/load-capture/
date: '2026-07-13T16:44:51-05:00'
lastmod: '2026-07-13T16:44:51-05:00'
---

* InfluxDB 3 Enterprise v3.10.0+

Use load capture to record a short, anonymized profile of requests handled by a query-capable InfluxDB 3 Enterprise node.
The profile preserves workload characteristics that can help you analyze or reproduce a workload.

> [!Important]
> Inspect a capture before sharing it.
> Anonymization does not remove all operational characteristics from a profile.

> [!Note]
> Load capture requires the [performance upgrade preview](/influxdb3/enterprise/performance-preview/), which uses the storage engine upgrade.
> Enable the preview with `--use-pacha-tree` and send requests to a node with an explicit `--mode` setting that includes `query`, for example, `--mode query` or `--mode ingest --mode query --mode compact`.
> Load capture isn’t available on a node that uses the default `--mode all` configuration.

Load capture requires an [admin token](/influxdb3/enterprise/admin/tokens/admin/).
Only one capture can run on a node at a time.

## Start a capture

Send a `POST` request to `/api/v3/loadcap/start`.
Set `type` to `write`, `query`, or `both` and specify a duration with seconds, minutes, or hours.
The maximum duration is one hour.

```sh
curl --request POST "$INFLUXDB3_HOST_URL/api/v3/loadcap/start" \
  --header "Authorization: Bearer ADMIN_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"type":"both","duration":"5m"}'
```

The response contains the capture profile identifier:

```json
{
  "profile_id": "550e8400-e29b-41d4-a716-446655440000"
}
```

If another capture is running on the node, the endpoint returns `409 Conflict`.

## List capture profiles

Send a `GET` request to `/api/v3/loadcap/profiles` to list profiles stored by the query-capable node.

```sh
curl --request GET "$INFLUXDB3_HOST_URL/api/v3/loadcap/profiles" \
  --header "Authorization: Bearer ADMIN_TOKEN"
```

Each profile includes its identifier, creation time, capture type, requested duration, owning node, and status.
The status is `running`, `complete`, or `aborted`.

#### Related

* [Manage admin tokens](/influxdb3/enterprise/admin/tokens/admin/)
* [InfluxDB HTTP API](/influxdb3/enterprise/api/)