---
title: kapacitor record query
description: The kapacitor record query command records the result of an InfluxQL query.
url: https://docs.influxdata.com/kapacitor/v1/reference/cli/kapacitor/record/query/
estimated_tokens: 1097
product: Kapacitor
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/kapacitor/v1/reference/cli/kapacitor/record/query/
---

# kapacitor record query

The `kapacitor record query` command records the result of an InfluxQL query. Once the recording is stopped, the command outputs the recording ID. If no recording ID is specified, Kapacitor assigns a random ID.

The command requires the following:

-   **InfluxQL query**: Use the `-query` flag
-   **Recording type**: Use the `-type` flag and pass either `batch` or `query`

*To replay the recording, see [`kapacitor replay`](/kapacitor/v1/reference/cli/kapacitor/replay/).*

## Usage

```sh
kapacitor record query [flags]
```

## Flags

| Flag | Description |
| --- | --- |
| -query | Required: Query to record. |
| -type | Required: Recording type (stream or batch) |
| -cluster | Named InfluxDB cluster or instance to query |
| -no-wait | Run recording in the background |
| -recording-id | ID to assign to the recording |

## Examples

-   [Record an InfluxQL query](#record-an-influxql-query)
-   [Record an InfluxQL query and assign a custom recording ID](#record-an-influxql-query-and-assign-a-custom-recording-id)
-   [Record an InfluxQL query for a specific InfluxDB cluster](#record-an-influxql-query-for-a-specific-influxdb-cluster)

### Record an InfluxQL query

```sh
influx record query \
  -query "SELECT temp, hum FROM db.rp.home" \
  -type batch
```

### Record an InfluxQL query and assign a custom recording ID

```sh
influx record query \
  -query "SELECT temp, hum FROM db.rp.home" \
  -type batch \
  -recording-id example-query-rec
```

### Record an InfluxQL query for a specific InfluxDB cluster

```sh
influx record query \
  -query "SELECT temp, hum FROM db.rp.home" \
  -type batch \
  -cluster influxdb-enterprise
```

#### Related

-   [Kapacitor data sampling](/kapacitor/v1/working/cli_client/#data-sampling)
-   [kapacitor replay](/kapacitor/v1/reference/cli/kapacitor/replay/)