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
The number of frontend service gRPC requests received per second.
Label | Description |
---|---|
operation | The name of the RPC operation |
temporal_service_type | The Temporal service type |
Type: Rate
temporal_cloud_v1_frontend_service_error_count
The number of frontend service gRPC errors per second.
Label | Description |
---|---|
operation | The name of the RPC operation |
temporal_service_type | The temporal service type |
Type: Rate
temporal_cloud_v1_frontend_service_pending_requests
The number of pollers that are waiting for a task.
Label | Description |
---|---|
operation | The name of the operation |
temporal_service_type | The Temporal service type |
Type: Value
temporal_cloud_v1_resource_exhausted_error_count
The number of 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 |
temporal_service_type | The Temporal service type |
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 |
temporal_service_type | The Temporal service type |
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 |
temporal_service_type | The Temporal service type |
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
The number of successful workflow completions per second.
Label | Description |
---|---|
operation | The operation name |
temporal_service_type | The Temporal service type |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_failed_count
The number of workflow failures per second.
Label | Description |
---|---|
operation | The operation name |
temporal_service_type | The Temporal service type |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_timeout_count
The number of workflow timeouts per second.
Label | Description |
---|---|
operation | The operation name |
temporal_service_type | The Temporal service type |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_cancel_count
The number of workflow cancellations per second.
Label | Description |
---|---|
operation | The operation name |
temporal_service_type | The Temporal service type |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_terminate_count
The number of workflow terminations per second.
Label | Description |
---|---|
operation | The operation name |
temporal_service_type | The Temporal service type |
temporal_task_queue | The task queue name |
temporal_workflow_type | The workflow type |
Type: Rate
temporal_cloud_v1_workflow_continued_as_new_count
The number of workflows continued as new per second.
Label | Description |
---|---|
operation | The operation name |
temporal_service_type | The Temporal service type |
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.
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
The number of successfully matched tasks per second.
Label | Description |
---|---|
operation | The poll operation name |
task_type | Type of task: workflow or activity |
temporal_service_type | The Temporal service type |
temporal_task_queue | The task queue name |
Type: Rate
temporal_cloud_v1_poll_success_sync_count
The number of tasks matched synchronously per second (no polling wait).
Label | Description |
---|---|
operation | The poll operation name |
task_type | Type of task: workflow or activity |
temporal_service_type | The Temporal service type |
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_service_type | The Temporal service type |
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.
Label | Description |
---|---|
service_name | The name of the Temporal service |
temporal_service_type | The 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.
Label | Description |
---|---|
is_background | Whether the action was background: true or false |
namespace_mode | The namespace mode |
Type: Rate
temporal_cloud_v1_operations_count
The number of operations performed per second.
Label | Description |
---|---|
operation | The name of the operation |
is_background | State of the background operation: true or false |
namespace_mode | The namespace mode |
Type: Rate
temporal_cloud_v1_operations_throttled_count
The number of operations throttled due to rate limits per second.
Label | Description |
---|---|
operation | The name of the operation |
is_background | State of the background operation: true or false |
namespace_mode | The 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