From 86fcb494c4c8677b531697d5ab1a3ed476bd4f0c Mon Sep 17 00:00:00 2001 From: Florence Morris Date: Thu, 18 Dec 2025 13:31:11 -0500 Subject: [PATCH 1/3] In explain-analyze.md, in Global properties, added kv cpu time. --- src/current/v26.1/explain-analyze.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/current/v26.1/explain-analyze.md b/src/current/v26.1/explain-analyze.md index b98b1545a76..5e0f0be4bc8 100644 --- a/src/current/v26.1/explain-analyze.md +++ b/src/current/v26.1/explain-analyze.md @@ -76,7 +76,8 @@ Property | Description `maximum memory usage` | The maximum amount of memory used by this statement anytime during its execution. `network usage` | The amount of data transferred over the network while the statement was executed. If the value is 0 B, the statement was executed on a single node and didn't use the network. `regions` | The [regions]({% link {{ page.version.version }}/show-regions.md %}) where the affected nodes were located. -`sql cpu time` | The total amount of time spent in the [SQL layer]({% link {{ page.version.version }}/architecture/sql-layer.md %}). It does not include time spent in the [storage layer]({% link {{ page.version.version }}/architecture/storage-layer.md %}). +`kv cpu time` | The total amount of time spent in the [KV layer]({% link {{ page.version.version }}/architecture/overview.md %}#layers) (which includes everything below the SQL layer). +`sql cpu time` | The total amount of time spent in the [SQL layer]({% link {{ page.version.version }}/architecture/sql-layer.md %}). `max sql temp disk usage` | ([`DISTSQL`](#distsql-option) option only) How much disk spilling occurs when executing a query. This property is displayed only when the disk usage is greater than zero. `estimated RUs consumed` | The estimated number of [Request Units (RUs)]({% link cockroachcloud/plan-your-cluster-basic.md %}#request-units) consumed by the statement. This property is visible only on CockroachDB {{ site.data.products.basic }} clusters. `isolation level` | The [isolation level]({% link {{ page.version.version }}/transactions.md %}#isolation-levels) at which this statement executed. @@ -226,6 +227,7 @@ EXPLAIN ANALYZE SELECT city, AVG(revenue) FROM rides GROUP BY city; maximum memory usage: 240 KiB network usage: 0 B (0 messages) regions: us-east1 + kv cpu time: 1ms sql cpu time: 443µs estimated RUs consumed: 0 isolation level: serializable @@ -354,6 +356,7 @@ EXPLAIN ANALYZE (VERBOSE) SELECT city, AVG(revenue) FROM rides GROUP BY city; maximum memory usage: 240 KiB network usage: 0 B (0 messages) regions: us-east1 + kv cpu time: 944µs sql cpu time: 275µs estimated RUs consumed: 0 isolation level: serializable @@ -418,6 +421,7 @@ EXPLAIN ANALYZE (DISTSQL) SELECT city, AVG(revenue) FROM rides GROUP BY city; maximum memory usage: 240 KiB network usage: 0 B (0 messages) regions: us-east1 + kv cpu time: 1ms sql cpu time: 300µs estimated RUs consumed: 0 isolation level: serializable @@ -498,6 +502,7 @@ EXPLAIN ANALYZE (REDACT) SELECT * FROM rides WHERE revenue > 90 ORDER BY revenue maximum memory usage: 290 KiB network usage: 0 B (0 messages) regions: us-east1 + kv cpu time: 2ms sql cpu time: 2ms estimated RUs consumed: 0 isolation level: serializable From 583901e235963e8feae25aa5ea971086c503a75d Mon Sep 17 00:00:00 2001 From: Florence Morris Date: Thu, 18 Dec 2025 16:29:22 -0500 Subject: [PATCH 2/3] =?UTF-8?q?Incorporated=20Alyshan=E2=80=99s=20feedback?= =?UTF-8?q?.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/current/v26.1/explain-analyze.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/current/v26.1/explain-analyze.md b/src/current/v26.1/explain-analyze.md index 5e0f0be4bc8..49a2819bf88 100644 --- a/src/current/v26.1/explain-analyze.md +++ b/src/current/v26.1/explain-analyze.md @@ -76,7 +76,7 @@ Property | Description `maximum memory usage` | The maximum amount of memory used by this statement anytime during its execution. `network usage` | The amount of data transferred over the network while the statement was executed. If the value is 0 B, the statement was executed on a single node and didn't use the network. `regions` | The [regions]({% link {{ page.version.version }}/show-regions.md %}) where the affected nodes were located. -`kv cpu time` | The total amount of time spent in the [KV layer]({% link {{ page.version.version }}/architecture/overview.md %}#layers) (which includes everything below the SQL layer). +`kv cpu time` | The total time spent in the [KV layer]({% link {{ page.version.version }}/architecture/overview.md %}#layers) on the critical path of serving the query. Excludes time spent in asynchronous replication work in the [storage layer]({% link {{ page.version.version }}/architecture/storage-layer.md %}). `sql cpu time` | The total amount of time spent in the [SQL layer]({% link {{ page.version.version }}/architecture/sql-layer.md %}). `max sql temp disk usage` | ([`DISTSQL`](#distsql-option) option only) How much disk spilling occurs when executing a query. This property is displayed only when the disk usage is greater than zero. `estimated RUs consumed` | The estimated number of [Request Units (RUs)]({% link cockroachcloud/plan-your-cluster-basic.md %}#request-units) consumed by the statement. This property is visible only on CockroachDB {{ site.data.products.basic }} clusters. From 4b864f00ea485978c09c814397261bc4e3b2919b Mon Sep 17 00:00:00 2001 From: Florence Morris Date: Fri, 19 Dec 2025 14:45:02 -0500 Subject: [PATCH 3/3] =?UTF-8?q?Incorporated=20Alyshan=E2=80=99s=20feedback?= =?UTF-8?q?.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/current/v26.1/explain-analyze.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/current/v26.1/explain-analyze.md b/src/current/v26.1/explain-analyze.md index af18a85aa2a..b88499a6daa 100644 --- a/src/current/v26.1/explain-analyze.md +++ b/src/current/v26.1/explain-analyze.md @@ -76,7 +76,7 @@ Property | Description `maximum memory usage` | The maximum amount of memory used by this statement anytime during its execution. `network usage` | The amount of data transferred over the network while the statement was executed. If the value is 0 B, the statement was executed on a single node and didn't use the network. `regions` | The [regions]({% link {{ page.version.version }}/show-regions.md %}) where the affected nodes were located. -`kv cpu time` | The total time spent in the [KV layer]({% link {{ page.version.version }}/architecture/overview.md %}#layers) on the critical path of serving the query. Excludes time spent in asynchronous replication work in the [storage layer]({% link {{ page.version.version }}/architecture/storage-layer.md %}). +`kv cpu time` | The total amount of time spent in the [KV layer]({% link {{ page.version.version }}/architecture/overview.md %}#layers) on the critical path of serving the query. Excludes time spent on asynchronous replication and in the [storage layer]({% link {{ page.version.version }}/architecture/storage-layer.md %}). `sql cpu time` | The total amount of time spent in the [SQL layer]({% link {{ page.version.version }}/architecture/sql-layer.md %}). `max sql temp disk usage` | ([`DISTSQL`](#distsql-option) option only) How much disk spilling occurs when executing a query. This property is displayed only when the disk usage is greater than zero. `estimated RUs consumed` | The estimated number of [Request Units (RUs)]({% link cockroachcloud/plan-your-cluster-basic.md %}#request-units) consumed by the statement. This property is visible only on CockroachDB {{ site.data.products.basic }} clusters.