From 0a944fb519d8eeb74037dccbf3cf5f40ce613180 Mon Sep 17 00:00:00 2001 From: "Chao Li (Evan)" Date: Thu, 18 Jun 2026 14:21:13 +0800 Subject: [PATCH v2] doc: Clarify pgbench reporting with --continue-on-error Clarify that transactions failed under --continue-on-error are reported separately and are not counted as transactions actually processed or in TPS. Also adjust the latency description to avoid implying that failed transactions are generally included in latency measurements. Author: Chao Li Reviewed-by: Yugo Nagata Reviewed-by: Fujii Masao Discussion: https://postgr.es/m/597C9755-4386-488D-A289-16D50AD81FBF@gmail.com --- doc/src/sgml/ref/pgbench.sgml | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml index 2e401d1ceb8..7619b8ad743 100644 --- a/doc/src/sgml/ref/pgbench.sgml +++ b/doc/src/sgml/ref/pgbench.sgml @@ -770,10 +770,13 @@ pgbench options d the connection to fail. See for more information. + This option is useful when your custom script may raise errors such as unique constraint violations, but you want the benchmark - to continue and measure performance including those failures. + to continue despite individual statement failures. Failed + transactions are reported separately, but are not counted as + transactions actually processed, nor are they included in TPS. @@ -2933,9 +2936,14 @@ statement latencies in milliseconds, failures and retries: The latency of a successful transaction includes the entire time of - transaction execution with rollbacks and retries. The latency is measured - only for successful transactions and commands but not for failed transactions - or commands. + transaction execution with rollbacks and retries. In the main report, + when none of , , and + is specified, latency average + is computed from both successful and failed transactions. In such cases, + this is explicitly indicated by (including failures). + Other latency statistics, including the per-script and per-command reports, + are measured only for successful transactions and commands, not for failed + transactions or commands. -- 2.50.1 (Apple Git-155)