OpenMetrics Metrics Reference
This document describes all metrics available from the Temporal Cloud OpenMetrics endpoint.
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
All metrics are stored as 1 minute aggregates.
Common Labels
All metrics include these base labels:
| Label | Description |
|---|---|
temporal_namespace | The Temporal namespace |
temporal_account | The Temporal account identifier |
region | Cloud region where the metric originated |
Metrics Catalog
Frontend Service Metrics
temporal_cloud_v1_frontend_service_request_count
Frontend service gRPC requests received per second.
| Label | Description |
|---|---|
operation | The name of the RPC operation |
Type: Rate
temporal_cloud_v1_frontend_service_error_count
Frontend service gRPC errors per second.
| Label | Description |
|---|---|
operation | The name of the RPC operation |
Type: Rate
temporal_cloud_v1_frontend_service_pending_requests
The number of pollers that are waiting for a task. Use this to track against temporal_cloud_v1_poller_limit
| Label | Description |
|---|---|
operation | The name of the operation |
Type: Value
temporal_cloud_v1_resource_exhausted_error_count
Resource exhaustion errors per second.
| Label | Description |
|---|---|
resource_exhausted_cause | The specific cause of resource exhaustion |
Type: Rate
temporal_cloud_v1_service_latency_p50
Avoid aggregating this metric across dimensions because the percentile won't be accurate.
The 50th percentile latency of service requests in seconds
| Label | Description |
|---|---|
operation | The name of the operation |
Type: Latency
temporal_cloud_v1_service_latency_p95
Avoid aggregating this metric across dimensions because the percentile won't be accurate.
The 95th percentile latency of service requests in seconds
| Label | Description |
|---|---|
operation | The name of the operation |
Type: Latency
temporal_cloud_v1_service_latency_p99
Avoid aggregating this metric across dimensions as the percentile won't be accurate.
The 99th percentile latency of service requests in seconds
| Label | Description |
|---|---|
operation | The name of the operation |
Type: Latency
Workflow Completion Metrics
These metrics could have high cardinality depending on number of workflow types and task queues.
temporal_cloud_v1_workflow_success_count
Successful workflow completions per second.
| Label | Description |
|---|---|
operation | The operation name |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_failed_count
Workflow failures per second.
| Label | Description |
|---|---|
operation | The operation name |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_timeout_count
Workflow timeouts per second.
| Label | Description |
|---|---|
operation | The operation name |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_cancel_count
Workflow cancellations per second.
| Label | Description |
|---|---|
operation | The operation name |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_terminate_count
Workflow terminations per second.
| Label | Description |
|---|---|
operation | The operation name |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_continued_as_new_count
Workflows continued as new per second.
| Label | Description |
|---|---|
operation | The operation name |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
Task Queue Metrics
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. Started Activities are not included in the count as they have been dequeued from the task queue.
| Label | Description |
|---|---|
temporal_task_queue | The task queue name |
task_type | Type of task: workflow or activity |
Type: Value
temporal_cloud_v1_poll_success_count
Successfully matched tasks per second.
| Label | Description |
|---|---|
operation | The poll operation name |
task_type | Type of task: workflow or activity |
temporal_task_queue | The task queue name |
Type: Rate
temporal_cloud_v1_poll_success_sync_count
Tasks matched synchronously per second (no polling wait).
| Label | Description |
|---|---|
operation | The poll operation name |
task_type | Type of task: workflow or activity |
temporal_task_queue | The task queue name |
Type: Rate
temporal_cloud_v1_poll_timeout_count
The rate of poll requests that timed out without receiving a task.
| Label | Description |
|---|---|
operation | The poll operation name |
task_type | Type of task: workflow or activity |
temporal_task_queue | The task queue name |
Type: Rate
temporal_cloud_v1_no_poller_tasks_count
The rate of tasks added to queues with no active pollers.
| Label | Description |
|---|---|
temporal_task_queue | The task queue name |
task_type | Type of task: workflow or activity |
Type: Rate
Namespace Metrics
temporal_cloud_v1_namespace_open_workflows
The current number of open workflows in a namespace.
Type: Value
temporal_cloud_v1_state_transition_count
Workflow state transitions per second.
Type: Rate
temporal_cloud_v1_total_action_count
The total number of actions performed per second. Actions with is_background=false are counted toward the temporal_cloud_v1_action_limit.
| Label | Description |
|---|---|
is_background | Whether the action was background: true or false. Background actions (e.g. History export) do not count toward the action rate limit |
namespace_mode | Indicates if actions are produced by an active or a standby Namespace |
Type: Rate
temporal_cloud_v1_operations_count
Operations performed per second.
| Label | Description |
|---|---|
operation | The name of the operation |
is_background | Whether the operation was background: true or false. Background operations do not count toward the operation rate limit |
namespace_mode | Indicates if operations are produced by an active or a standby Namespace |
Type: Rate
temporal_cloud_v1_operations_throttled_count
Operations throttled due to rate limits per second.
| Label | Description |
|---|---|
operation | The name of the operation |
is_background | Whether the operation was background: true or false. Background operations do not count toward the operation rate limit |
namespace_mode | Indicates if actions are throttled in an active or a standby Namespace |
Type: Rate
Schedule Metrics
temporal_cloud_v1_schedule_action_success_count
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. Track utilization against this limit with temporal\_cloud\_v1\_total\_action\_count and is_background=false.
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. Track utilization against this limit with temporal_cloud_v1_frontend_service_pending_requests.
Type: Value