summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorZuul <zuul@review.opendev.org>2022-07-29 19:06:56 +0000
committerGerrit Code Review <review@openstack.org>2022-07-29 19:06:56 +0000
commitde1e2a325e76b573544f5c1f4bf92e73c675e645 (patch)
tree6e629d9f960ca2b412d28649f275b30d7ee1e397 /doc
parent22d0603b7a7e53de70f695ee954a0795d62da2fb (diff)
parent458ba317fdc2ea9a66ef058b248646473819b32e (diff)
downloadzuul-de1e2a325e76b573544f5c1f4bf92e73c675e645.tar.gz
Merge "Add pipeline-based merge op metrics"
Diffstat (limited to 'doc')
-rw-r--r--doc/source/monitoring.rst34
1 files changed, 32 insertions, 2 deletions
diff --git a/doc/source/monitoring.rst b/doc/source/monitoring.rst
index 0c2cb4351..1cb61ee01 100644
--- a/doc/source/monitoring.rst
+++ b/doc/source/monitoring.rst
@@ -110,7 +110,27 @@ These metrics are emitted by the Zuul :ref:`scheduler`:
operation(s). This will always include a request to a Zuul
merger to speculatively merge the change, but it may also
include a second request submitted in parallel to identify
- the files altered by the change.
+ the files altered by the change. Includes
+ :stat:`zuul.tenant.<tenant>.pipeline.<pipeline>.merger_merge_op_time`
+ and
+ :stat:`zuul.tenant.<tenant>.pipeline.<pipeline>.merger_files_changes_op_time`.
+
+ .. stat:: merger_merge_op_time
+ :type: timer
+
+ The amount of time the merger spent performing a merge
+ operation. This does not include any of the round-trip time
+ from the scheduler to the merger, or any other merge
+ operations.
+
+ .. stat:: merger_files_changes_op_time
+ :type: timer
+
+ The amount of time the merger spent performing a files-changes
+ operation to detect changed files (this is sometimes
+ performed if the source does not provide this information).
+ This does not include any of the round-trip time from the
+ scheduler to the merger, or any other merge operations.
.. stat:: layout_generation_time
:type: timer
@@ -128,7 +148,17 @@ These metrics are emitted by the Zuul :ref:`scheduler`:
The amount of time waiting for a secondary Zuul merger
operation to collect additional information about the repo
- state of required projects.
+ state of required projects. Includes
+ :stat:`zuul.tenant.<tenant>.pipeline.<pipeline>.merger_repo_state_op_time`.
+
+ .. stat:: merger_repo_state_op_time
+ :type: timer
+
+ The amount of time the merger spent performing a repo state
+ operation to collect additional information about the repo
+ state of required projects. This does not include any of the
+ round-trip time from the scheduler to the merger, or any
+ other merge operations.
.. stat:: node_request_time
:type: timer