Chapter 3. OpenShift Pipelines component observability metrics reference


In Red Hat OpenShift Pipelines, observability metrics are collected in OpenTelemetry (OTel) format. You can use these metrics to monitor component health, operational performance, and resource usage in Prometheus or Grafana.

The Tekton Pipelines controller exposes core operational metrics and Knative infrastructure metrics.

Table 3.1. Core Tekton Pipelines metrics
Metric nameTypeLabelsDescription

tekton_pipelines_controller_pipelinerun_duration_seconds

Histogram

status, pipeline, namespace, reason (optional)

Duration of PipelineRun executions in seconds.

tekton_pipelines_controller_pipelinerun_total

Counter

status, namespace

Total number of PipelineRuns created.

tekton_pipelines_controller_running_pipelineruns

Gauge

namespace

Number of currently running PipelineRuns.

tekton_pipelines_controller_running_pipelineruns_waiting_on_pipeline_resolution

Gauge

namespace

Number of PipelineRuns waiting for remote pipeline resolution.

tekton_pipelines_controller_running_pipelineruns_waiting_on_task_resolution

Gauge

namespace

Number of PipelineRuns waiting for task resolution.

tekton_pipelines_controller_pipelinerun_taskrun_duration_seconds

Histogram

status, task, pipeline, pipelinerun, namespace, reason

Duration of TaskRuns within a PipelineRun context.

tekton_pipelines_controller_taskrun_duration_seconds

Histogram

status, task, namespace, reason

Duration of standalone TaskRun executions in seconds.

tekton_pipelines_controller_taskrun_total

Counter

status, namespace

Total number of TaskRuns created.

tekton_pipelines_controller_running_taskruns

Gauge

namespace

Number of currently running TaskRuns.

tekton_pipelines_controller_running_taskruns_waiting_on_task_resolution_count

Gauge

namespace

Number of TaskRuns waiting for task resolution.

tekton_pipelines_controller_running_taskruns_throttled_by_quota

Gauge

namespace

Number of TaskRuns throttled due to resource quota limits.

tekton_pipelines_controller_running_taskruns_throttled_by_node

Gauge

namespace

Number of TaskRuns throttled due to node constraints.

tekton_pipelines_controller_taskruns_pod_latency_milliseconds

Histogram

namespace, pod

Pod creation and scheduling latency in milliseconds.

Table 3.2. Pipeline controller infrastructure metrics
Metric nameTypeDescription

kn_workqueue_adds_total

Counter

Total number of reconciliations added to the workqueue.

kn_workqueue_depth

Gauge

Current depth of the workqueue.

kn_workqueue_queue_duration_seconds

Histogram

Time items spend in the workqueue before processing.

kn_workqueue_process_duration_seconds

Histogram

Time taken to process items from the workqueue.

kn_workqueue_retries_total

Counter

Total retries during workqueue reconciliation.

kn_workqueue_unfinished_work_seconds

Gauge

Total duration of currently unfinished work in seconds.

http_client_request_duration_seconds

Histogram

Duration of HTTP client requests made by the controller.

kn_k8s_client_http_response_status_code_total

Counter

Total Kubernetes API client HTTP responses by status code.

process_* / go_*

Various

Go runtime memory, garbage collection, and thread metrics.

Table 3.3. Tekton Triggers metrics
Metric nameTypeDescription

controller_eventlistener_count

Gauge

Number of active EventListener resources.

controller_triggerbinding_count

Gauge

Number of active TriggerBinding resources.

controller_clustertriggerbinding_count

Gauge

Number of active ClusterTriggerBinding resources.

controller_triggertemplate_count

Gauge

Number of active TriggerTemplate resources.

controller_clusterinterceptor_count

Gauge

Number of active ClusterInterceptor resources.

http_duration_seconds

Histogram

Duration of HTTP requests processed by EventListeners.

eventlistener_events_total

Counter

Total incoming events received by EventListeners.

eventlistener_triggered_resources_total

Counter

Total resources created or triggered by EventListeners.

Table 3.4. Tekton Results watcher metrics
Metric nameTypeDescription

watcher_pipelinerun_delete_count_total

Counter

Total PipelineRun delete operations processed by the watcher.

watcher_taskrun_delete_count_total

Counter

Total TaskRun delete operations processed by the watcher.

watcher_pipelinerun_delete_duration_seconds

Histogram

Time taken to process PipelineRun deletions in seconds.

watcher_taskrun_delete_duration_seconds

Histogram

Time taken to process TaskRun deletions in seconds.

watcher_runs_not_stored_count_total

Counter

Total runs that failed to store in the database.

watcher_run_storage_latency_seconds

Histogram

Latency for storing runs in the database.

Table 3.5. Tekton Chains metrics
Metric nameTypeDescription

watcher_pipelinerun_sign_created_total

Counter

Total PipelineRun signatures created.

watcher_pipelinerun_payload_uploaded_total

Counter

Total PipelineRun payloads uploaded to storage.

watcher_pipelinerun_payload_stored_total

Counter

Total PipelineRun payloads stored.

watcher_pipelinerun_marked_signed_total

Counter

Total PipelineRuns marked as signed.

watcher_pipelinerun_signing_failures_total

Counter

Total PipelineRun signing failures by error type.

watcher_taskrun_sign_created_total

Counter

Total TaskRun signatures created.

watcher_taskrun_payload_uploaded_total

Counter

Total TaskRun payloads uploaded to storage.

watcher_taskrun_payload_stored_total

Counter

Total TaskRun payloads stored.

watcher_taskrun_marked_signed_total

Counter

Total TaskRuns marked as signed.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top