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
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: InfluxQL query management
description: Show, kill, and manage queries in InfluxQL.

Check warning on line 3 in content/enterprise_influxdb/v1/troubleshooting/query_management/influxql_query_management.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.WordList

Use 'stop', 'exit', 'cancel', or 'end' instead of 'kill'.
menu:
enterprise_influxdb_v1:
name: InfluxQL query management
Expand All @@ -21,8 +21,8 @@

## List currently-running queries with `SHOW QUERIES`

`SHOW QUERIES` lists the query id, query text, relevant database, and duration
of all currently-running queries on your InfluxDB instance.
`SHOW QUERIES` lists the query id, node id, TCP host, query text, relevant database, duration,
status, and user of all currently-running queries on your InfluxDB Enterprise cluster.

#### Syntax

Expand All @@ -34,17 +34,19 @@

```
> SHOW QUERIES
qid query database duration status
--- ----- -------- -------- ------
37 SHOW QUERIES 100368u running
36 SELECT mean(myfield) FROM mymeas mydb 3s running
qid node_id tcp_host query database duration status user
--- ------- -------- ----- -------- -------- ------ ----
37 26 data1:8088 SHOW QUERIES 100368u running admin
36 33 data3:8088 SELECT mean(myfield) FROM mymeas mydb 3s running jdoe
```

##### Explanation of the output

- `qid`: Query ID. Use this ID with [`KILL - QUERY`](/enterprise_influxdb/v1/troubleshooting/query_management/influxql_query_management/#stop-currently-running-queries-with-kill-query).
- `query`: The query text.
- `database`: The database targeted by the query.
- `qid`: Query ID. Use this ID with [`KILL QUERY`](/enterprise_influxdb/v1/troubleshooting/query_management/influxql_query_management/#stop-currently-running-queries-with-kill-query).
- `node_id`: The data node ID where the query is running.
- `tcp_host`: The TCP host address of the data node. Use this value with [`KILL QUERY ... ON`](/enterprise_influxdb/v1/troubleshooting/query_management/influxql_query_management/#stop-currently-running-queries-with-kill-query) to kill queries on a specific node.
- `query`: The query text.
- `database`: The database targeted by the query.
- `duration`: The length of time that the query has been running.
See [Query Language Reference](/enterprise_influxdb/v1/query_language/spec/#durations)
for an explanation of time units in InfluxDB databases.
Expand All @@ -55,6 +57,7 @@
{{% /note %}}

- `status`: The current status of the query.
- `user`: The user who initiated the query. Empty if authentication is not enabled. _v1.12.3+_

## Stop currently-running queries with `KILL QUERY`

Expand Down
2 changes: 1 addition & 1 deletion content/influxdb/v1/about_the_project/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
- Add TLS certificate reloading on `SIGHUP`.
- Add [`config`](/influxdb/v1/tools/api/#running-configuration) and [`cq` (continuous query) statistics](/influxdb/v1/tools/api/#continuous-query-statistics) to the `/debug/vars` endpoint.
- Improve dropped point logging.
- Show user when displaying or logging queries.
- [Show user when displaying or logging queries](/influxdb/v1/troubleshooting/query_management/#list-currently-running-queries-with-show-queries).
- Add [`time_format` parameter](/influxdb/v1/tools/api/#query-data-with-a-select-statement-and-the-time_format-parameter) for the HTTP API.
- Use dynamic logging levels (`zap.AtomicLevel`).
- Report user query bytes.
Expand Down Expand Up @@ -318,7 +318,7 @@

This release is for InfluxDB Enterprise 1.8.6 customers only. No OSS-specific
changes were made for InfluxDB 1.8.6--updates were made to the code base to
support [InfluxDB Enterprise 1.8.6](/enterprise_influxdb/v1/about-the-project/release-notes/#v186).

Check notice on line 321 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

write-good.E-Prime

Try to avoid using 'is'.

## v1.8.5 {date="2021-04-20"}

Expand Down Expand Up @@ -1747,25 +1747,25 @@
- Fix compaction planning re-compacting large TSM files.
- Ensure client sends correct precision when inserting points.
- Accept points with trailing whitespace.
- Fix panic in SHOW FIELD KEYS.

Check notice on line 1750 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.Acronyms

Spell out 'KEYS', if it's unfamiliar to the audience.

Check notice on line 1750 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.Acronyms

Spell out 'FIELD', if it's unfamiliar to the audience.
- Disable limit optimization when using an aggregate.
- Fix panic: interface conversion: tsm1.Value is \*tsm1.StringValue, not \*tsm1.FloatValue.
- Data race when dropping a database immediately after writing to it.
- Make sure admin exists before authenticating query.

Check warning on line 1754 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.WordList

Use 'administrator' instead of 'admin'.
- Print the query executor's stack trace on a panic to the log.
- Fix read tombstones: EOF.

Check notice on line 1756 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.Acronyms

Spell out 'EOF', if it's unfamiliar to the audience.
- Query-log-enabled in config not ignored anymore.
- Ensure clients requesting gzip encoded bodies don't receive empty body.
- Optimize shard loading.
- Queries slow down hundreds times after overwriting points.
- SHOW TAG VALUES accepts != and !~ in WHERE clause.

Check notice on line 1761 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.Acronyms

Spell out 'TAG', if it's unfamiliar to the audience.
- Remove old cluster code.
- Ensure that future points considered in SHOW queries.
- Fix full compactions conflicting with level compactions.
- Overwriting points on large series can cause memory spikes during compactions.
- Fix parseFill to check for fill ident before attempting to parse an expression.

Check warning on line 1766 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.Spelling

Did you really mean 'ident'?
- Max index entries exceeded.
- Address slow startup time.
- Fix measurement field panic in tsm1 engine.
- Queries against files that have just been compacted need to point to new files.

Check warning on line 1770 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

write-good.Passive

'been compacted' may be passive voice. Use active voice if you can.

Check notice on line 1770 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

Google.Passive

In general, use active voice instead of passive voice ('been compacted').

Check notice on line 1770 in content/influxdb/v1/about_the_project/release-notes.md

View workflow job for this annotation

GitHub Actions / Vale style check

write-good.E-Prime

Try to avoid using 'been'.
- Check that retention policies exist before creating CQ.
19 changes: 10 additions & 9 deletions content/influxdb/v1/troubleshooting/query_management.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: InfluxQL query management
description: Show, kill, and manage queries in InfluxQL.

Check warning on line 3 in content/influxdb/v1/troubleshooting/query_management.md

View workflow job for this annotation

GitHub Actions / Vale style check

InfluxDataDocs.WordList

Use 'stop', 'exit', 'cancel', or 'end' instead of 'kill'.
menu:
influxdb_v1:
name: Query management
Expand All @@ -18,8 +18,8 @@

## List currently-running queries with `SHOW QUERIES`

`SHOW QUERIES` lists the query id, query text, relevant database, and duration
of all currently-running queries on your InfluxDB instance.
`SHOW QUERIES` lists the query id, query text, relevant database, duration,
status, and user of all currently-running queries on your InfluxDB instance.

#### Syntax

Expand All @@ -31,17 +31,17 @@

```
> SHOW QUERIES
qid query database duration status
--- ----- -------- -------- ------
37 SHOW QUERIES 100368u running
36 SELECT mean(myfield) FROM mymeas mydb 3s running
qid query database duration status user
--- ----- -------- -------- ------ ----
37 SHOW QUERIES 100368u running admin
36 SELECT mean(myfield) FROM mymeas mydb 3s running jdoe
```

##### Explanation of the output

- `qid`: The id number of the query. Use this value with [`KILL - QUERY`](/influxdb/v1/troubleshooting/query_management/#stop-currently-running-queries-with-kill-query).
- `query`: The query text.
- `database`: The database targeted by the query.
- `qid`: The id number of the query. Use this value with [`KILL - QUERY`](/influxdb/v1/troubleshooting/query_management/#stop-currently-running-queries-with-kill-query).
- `query`: The query text.
- `database`: The database targeted by the query.
- `duration`: The length of time that the query has been running.
See [Query Language Reference](/influxdb/v1/query_language/spec/#durations)
for an explanation of time units in InfluxDB databases.
Expand All @@ -52,6 +52,7 @@
{{% /note %}}

- `status`: The current status of the query.
- `user`: The user who initiated the query. Empty if authentication is not enabled. _v1.12.3+_

## Stop currently-running queries with `KILL QUERY`

Expand Down
Loading