postgresql/contrib/auto_explain
Andres Freund 5a79e78501 instrumentation: Separate per-node logic from other uses
Previously, different places (e.g. query "total time") were repurposing the
Instrumentation struct initially introduced for capturing per-node statistics
during execution. This overuse of the same struct is confusing, e.g. by
cluttering calls of InstrStartNode/InstrStopNode in unrelated code paths, and
prevents future refactorings.

Instead, simplify the Instrumentation struct to only track time and WAL/buffer
usage. Similarly, drop the use of InstrEndLoop outside of per-node
instrumentation - these calls were added without any apparent benefit since
the relevant fields were never read.

Introduce the NodeInstrumentation struct to carry forward the per-node
instrumentation information. WorkerInstrumentation is renamed to
WorkerNodeInstrumentation for clarity.

In passing, clarify that InstrAggNode is expected to only run after
InstrEndLoop (as it does in practice), and drop unused code.

This also fixes a consequence-less bug: Previously ->async_mode was only set
when a non-zero instrument_option was passed. That turns out to be harmless
right now, as ->async_mode only affects a timing related field.

Author: Lukas Fittl <lukas@fittl.com>
Reviewed-by: Andres Freund <andres@anarazel.de>
Discussion: https://postgr.es/m/CAP53PkzdBK8VJ1fS4AZ481LgMN8f9mJiC39ZRHqkFUSYq6KWmg@mail.gmail.com
2026-04-05 19:04:24 -04:00
..
expected Allow resetting unknown custom GUCs with reserved prefixes. 2025-08-01 16:52:11 -05:00
sql Allow resetting unknown custom GUCs with reserved prefixes. 2025-08-01 16:52:11 -05:00
t Update copyright for 2026 2026-01-01 13:24:10 -05:00
.gitignore Add a simple test for contrib/auto_explain. 2021-01-24 14:59:33 -05:00
auto_explain.c instrumentation: Separate per-node logic from other uses 2026-04-05 19:04:24 -04:00
Makefile Allow resetting unknown custom GUCs with reserved prefixes. 2025-08-01 16:52:11 -05:00
meson.build Update copyright for 2026 2026-01-01 13:24:10 -05:00