Skip to main content

OpenMetrics Metrics Reference

This document describes all metrics available from the Temporal Cloud OpenMetrics endpoint.

SUPPORT, STABILITY, and DEPENDENCY INFO

Temporal Cloud OpenMetrics support is available in Public Preview.

Metric Conventions

Metric Types

All metrics are exposed as OpenMetrics gauges, but represent different measurement types:

  • Rate Metrics: per-second rate of the aggregated values
  • Value Metrics: The most recent aggregate value within a look-back window (e.g. backlogs, limits)
  • Percentile Metrics: Pre-calculated aggregated latency percentiles in seconds
note

All metrics are stored as 1 minute aggregates.

Common Labels

All metrics include these base labels:

LabelDescription
temporal_namespaceThe Temporal namespace
temporal_accountThe Temporal account identifier
regionCloud region where the metric originated

Metrics Catalog

Frontend Service Metrics

temporal_cloud_v1_frontend_service_request_count

The number of frontend service gRPC requests received per second.

LabelDescription
operationThe name of the RPC operation
temporal_service_typeThe Temporal service type

Type: Rate

temporal_cloud_v1_frontend_service_error_count

The number of frontend service gRPC errors per second.

LabelDescription
operationThe name of the RPC operation
temporal_service_typeThe temporal service type

Type: Rate

temporal_cloud_v1_frontend_service_pending_requests

The number of pollers that are waiting for a task.

LabelDescription
operationThe name of the operation
temporal_service_typeThe Temporal service type

Type: Value

temporal_cloud_v1_resource_exhausted_error_count

The number of resource exhaustion errors per second.

LabelDescription
resource_exhausted_causeThe specific cause of resource exhaustion

Type: Rate

temporal_cloud_v1_service_latency_p50

caution

Avoid aggregating this metric across dimensions because the percentile won't be accurate.

The 50th percentile latency of service requests in seconds

LabelDescription
operationThe name of the operation
temporal_service_typeThe Temporal service type

Type: Latency

temporal_cloud_v1_service_latency_p95

caution

Avoid aggregating this metric across dimensions because the percentile won't be accurate.

The 95th percentile latency of service requests in seconds

LabelDescription
operationThe name of the operation
temporal_service_typeThe Temporal service type

Type: Latency

temporal_cloud_v1_service_latency_p99

caution

Avoid aggregating this metric across dimensions as the percentile won't be accurate.

The 99th percentile latency of service requests in seconds

LabelDescription
operationThe name of the operation
temporal_service_typeThe Temporal service type

Type: Latency

Workflow Completion Metrics

High Cardinality

These metrics could have high cardinality depending on number of workflow types and task queues.

temporal_cloud_v1_workflow_success_count

The number of successful workflow completions per second.

LabelDescription
operationThe operation name
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name
temporal_workflow_typeThe workflow type

Type: Rate

temporal_cloud_v1_workflow_failed_count

The number of workflow failures per second.

LabelDescription
operationThe operation name
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name
temporal_workflow_typeThe workflow type

Type: Rate

temporal_cloud_v1_workflow_timeout_count

The number of workflow timeouts per second.

LabelDescription
operationThe operation name
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name
temporal_workflow_typeThe workflow type

Type: Rate

temporal_cloud_v1_workflow_cancel_count

The number of workflow cancellations per second.

LabelDescription
operationThe operation name
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name
temporal_workflow_typeThe workflow type

Type: Rate

temporal_cloud_v1_workflow_terminate_count

The number of workflow terminations per second.

LabelDescription
operationThe operation name
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name
temporal_workflow_typeThe workflow type

Type: Rate

temporal_cloud_v1_workflow_continued_as_new_count

The number of workflows continued as new per second.

LabelDescription
operationThe operation name
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name
temporal_workflow_typeThe workflow type

Type: Rate

Task Queue Metrics

High Cardinality

These metrics could have high cardinality depending on number of task queues present.

temporal_cloud_v1_approximate_backlog_count

The approximate number of tasks pending in a task queue.

LabelDescription
temporal_task_queueThe task queue name
task_typeType of task: workflow or activity

Type: Value

temporal_cloud_v1_poll_success_count

The number of successfully matched tasks per second.

LabelDescription
operationThe poll operation name
task_typeType of task: workflow or activity
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name

Type: Rate

temporal_cloud_v1_poll_success_sync_count

The number of tasks matched synchronously per second (no polling wait).

LabelDescription
operationThe poll operation name
task_typeType of task: workflow or activity
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name

Type: Rate

temporal_cloud_v1_poll_timeout_count

The rate of poll requests that timed out without receiving a task.

LabelDescription
operationThe poll operation name
task_typeType of task: workflow or activity
temporal_service_typeThe Temporal service type
temporal_task_queueThe task queue name

Type: Rate

temporal_cloud_v1_no_poller_tasks_count

The rate of tasks added to queues with no active pollers.

LabelDescription
temporal_task_queueThe task queue name
task_typeType of task: workflow or activity

Type: Rate

Namespace Metrics

temporal_cloud_v1_namespace_open_workflows

The current number of open workflows in a namespace.

LabelDescription
service_nameThe name of the Temporal service
temporal_service_typeThe Temporal service type

Type: Value

temporal_cloud_v1_state_transition_count

The number of workflow state transitions per second.

Type: Rate

temporal_cloud_v1_total_action_count

The total number of actions performed per second.

LabelDescription
is_backgroundWhether the action was background: true or false
namespace_modeThe namespace mode

Type: Rate

temporal_cloud_v1_operations_count

The number of operations performed per second.

LabelDescription
operationThe name of the operation
is_backgroundState of the background operation: true or false
namespace_modeThe namespace mode

Type: Rate

temporal_cloud_v1_operations_throttled_count

The number of operations throttled due to rate limits per second.

LabelDescription
operationThe name of the operation
is_backgroundState of the background operation: true or false
namespace_modeThe namespace mode

Type: Rate

Schedule Metrics

temporal_cloud_v1_schedule_action_success_count

The number of successfully executed scheduled workflows per second.

Type: Rate

temporal_cloud_v1_schedule_buffer_overruns_count

The rate of schedule buffer overruns when using BUFFER_ALL overlap policy.

Type: Rate

temporal_cloud_v1_schedule_missed_catchup_window_count

The rate of missed schedule executions outside the catchup window.

Type: Rate

temporal_cloud_v1_schedule_rate_limited_count

The rate of scheduled workflows delayed due to rate limiting.

Type: Rate

Replication Metrics

temporal_cloud_v1_replication_lag_p50

The 50th percentile cross-region replication lag in seconds.

Type: Latency

temporal_cloud_v1_replication_lag_p95

The 95th percentile cross-region replication lag in seconds.

Type: Latency

temporal_cloud_v1_replication_lag_p99

The 99th percentile cross-region replication lag in seconds.

Type: Latency

Limit Metrics

temporal_cloud_v1_operations_limit

The current configured operations per second limit for a namespace.

Type: Value

temporal_cloud_v1_action_limit

The current configured actions per second limit for a namespace.

Type: Value

temporal_cloud_v1_frontend_rps_limit

The current configured frontend service RPS limit for a namespace.

Type: Value

temporal_cloud_v1_poller_limit

The current configured poller limit for a namespace.

Type: Value