Skip to content

Add 6 missing OpenMetrics, move v0 metrics to v1 in prep for GA#4280

Open
dustin-temporal wants to merge 8 commits intomainfrom
add-missing-openmetrics
Open

Add 6 missing OpenMetrics, move v0 metrics to v1 in prep for GA#4280
dustin-temporal wants to merge 8 commits intomainfrom
add-missing-openmetrics

Conversation

@dustin-temporal
Copy link
Contributor

@dustin-temporal dustin-temporal commented Mar 12, 2026 •
edited
Loading

Summary

  • Add 3 workflow schedule-to-close latency metrics (p50/p95/p99) to metrics-reference and service-health pages
  • Add 3 on-demand envelope limit metrics (action/operations/service_request) to metrics-reference, service-health, and capacity-modes pages
  • Update OpenMetrics index page metric count from "30+" to "50+"
  • worker-health: Replace temporal_cloud_v0_poll_success_count, _sync_count, _timeout_count with v1 equivalents. Remove rate() wrapping from all Cloud metric queries (v1 metrics are pre-computed rates). Add temporal_cloud_v1_approximate_backlog_count guidance (was a TODO in the source). Update reference links to OpenMetrics metrics reference.
  • service-health: Fix metric display names (frontend_service_error_count -> service_error_count to match actual v1 names). Replace SDK temporal_activity_execution_failed with Cloud temporal_cloud_v1_activity_fail_count. Remove increase() from query on pre-computed rate metrics. Replace vague total_activities formula with concrete v1 metrics.
  • ha-monitoring: Replace v0 histogram queries (histogram_quantile(0.99, sum(rate(temporal_cloud_v0_replication_lag_bucket...)))) with simple v1 percentile references (temporal_cloud_v1_replication_lag_p99). Add p95 query. Replace temporal_cloud_v0_total_action_count with v1. Update reference links.

These metrics are available from the OpenMetrics endpoint but were missing from the public documentation. Source of truth: internal External Observability docs.

Pages changed

Page What was added
cloud/metrics/openmetrics/metrics-reference 6 new metric entries with descriptions, labels, and types
cloud/service-health Workflow execution latency subsection + on-demand envelope limits subsection
cloud/capacity-modes On-demand envelope metrics table for provisioned capacity users
cloud/metrics/openmetrics/index Updated metric count

Test plan

  • Verify metrics-reference page renders all 6 new metric entries correctly
  • Verify service-health anchor links to new metrics-reference entries work
  • Verify capacity-modes page renders the new metrics table
  • Confirm metric names match the OpenMetrics endpoint output

🤖 Generated with Claude Code

┆Attachments: EDU-6036 Add 6 missing OpenMetrics to docs

dustin-temporal and others added 4 commits February 26, 2026 12:32
@dustin-temporal @claude
Migrate Cloud metrics from PromQL v0 to OpenMetrics v1
f93c073 
Replace temporal_cloud_v0_* metrics with temporal_cloud_v1_* equivalents
across worker-health, service-health, and HA monitoring pages.

Key changes:
- worker-health: Replace v0 poll metrics with v1, remove rate() wrapping
  from queries (v1 metrics are pre-computed rates), add approximate_backlog_count
- service-health: Fix metric display names (drop frontend_ prefix), replace
  SDK activity_execution_failed with Cloud v1 activity_fail_count, fix query
  to not use increase() on pre-computed rates
- ha-monitoring: Replace v0 histogram queries with v1 pre-computed percentiles,
  add p95 query, update reference links

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dustin-temporal
improve clarity and brevity
c1dd300
@dustin-temporal
Fix some incorrect calculations for metrics
5c24add
@dustin-temporal @claude
Add 6 missing OpenMetrics to docs
f7c78a3 
Add workflow schedule-to-close latency (p50/p95/p99) and on-demand
envelope limit metrics (action/operations/service_request) across
metrics-reference, service-health, capacity-modes, and openmetrics
index pages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dustin-temporal dustin-temporal requested a review from a team as a code owner March 12, 2026 13:29
@vercel
Copy link

vercel bot commented Mar 12, 2026 •
edited
Loading

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Mar 13, 2026 2:37pm

Request Review

@github-actions
Copy link
Contributor

github-actions bot commented Mar 12, 2026 •
edited
Loading

📖 Docs PR preview links

@dustin-temporal @claude
Note that total_action_count excludes region label
8744d23 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dustin-temporal @claude
Replace envelope metrics table with link to service-health
3b7d061 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dustin-temporal
Copy link
Contributor Author

dustin-temporal commented Mar 12, 2026

I have merged the content of #4246 into this PR so we don't have merge conflicts later.

@dustin-temporal dustin-temporal changed the title Add 6 missing OpenMetrics to docs Add 6 missing OpenMetrics, move v0 metrics to v1 in prep for GA Mar 12, 2026
@dustin-temporal dustin-temporal mentioned this pull request Mar 12, 2026
Closed
4 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@dustin-temporal @brianmacdonald-temporal