Metrics integrations

Metrics can be exported from Temporal Cloud using the OpenMetrics endpoint. This document describes configuring integrations that have third party support or are based on open standards. This document is for basic configuration only. For advanced concepts such as label management and high cardinality scenarios see the general API reference.

Integrations

Before configuring any integration, complete the Quickstart to create a Service Account with the Metrics Read-Only role and generate an API key. This requires the Account Owner or Global Admin role - a Namespace Admin cannot grant the Metrics Read-Only role.

Datadog

Datadog provides a serverless integration with the OpenMetrics endpoint. It scrapes metrics, stores them in Datadog, and ships a default dashboard with built-in monitors.

1. In Datadog, open the Integrations catalog and search for Temporal Cloud OpenMetrics. Install the integration.
2. Click Add Account in the integration tile and paste your Temporal Cloud API key into the API Key field.
3. Save the configuration. The default Temporal Cloud dashboard appears in Dashboards → Dashboards List once data starts flowing (typically within a few minutes).

For Datadog-side details, see the Datadog integration page.

Grafana Cloud

Grafana Cloud provides a serverless integration with the OpenMetrics endpoint. It scrapes metrics, stores them in Grafana Cloud, and ships a default dashboard for visualizing them.

1. In Grafana Cloud, go to Connections → Add new connection and search for Temporal Cloud.
2. On the integration page, paste your Temporal Cloud API key into the API Key field.
3. Add metrics.temporal.io to Allowed hosts so Grafana Cloud can reach the endpoint.
4. Click Install to enable the integration and import the pre-built dashboard.

If the dashboard shows no data after a few minutes, confirm the API key's Service Account has the Metrics Read-Only role and that the endpoint is reachable using the curl check from the Quickstart.

For Grafana-side details, see the Grafana Cloud integration page.

ClickStack

ClickHouse provides an integration with the OpenMetrics endpoint for ClickStack. This integration uses an OpenTelemetry collector to read from the OpenMetrics endpoint, ingest data into ClickHouse, and includes a default dashboard to visualize the data with HyperDX. See the integration page for more details.

New Relic

New Relic integrates with Temporal Cloud via the infrastructure agent using a flex integration that pulls data from the OpenMetrics endpoint. See the integration page for more details.

Prometheus + Grafana

Self hosted Prometheus can be used to scrape the OpenMetrics endpoint.

1. Add a new scrape job for the OpenMetrics endpoint with your API key.

scrape_configs:
  - job_name: 'temporal-cloud'
    scrape_interval: 30s
    scrape_timeout: 30s
    honor_timestamps: true
    scheme: https
    authorization:
      type: Bearer
      credentials: '<API_KEY>'
    static_configs:
      - targets: ['metrics.temporal.io']
    metrics_path: '/v1/metrics'

2. Import the Grafana dashboard and configure your Prometheus datasource.

OpenTelemetry Collector Configuration

Collect metrics with a self-hosted OpenTelemetry Collector to ingest into the system of your choosing.

1. Add a new prometheus receiver for the OpenMetrics endpoint with your API key.

receivers:
  prometheus:
    config:
      scrape_configs:
      - job_name: 'temporal-cloud'
        scrape_interval: 30s
        scrape_timeout: 30s
        honor_timestamps: true
        scheme: https
        authorization:
          type: Bearer
          credentials_file: <API_KEY_FILE>
        static_configs:
          - targets: ['metrics.temporal.io']
        metrics_path: '/v1/metrics'

processors:
  batch:

exporters:
  otlphttp:
    endpoint: <ENDPOINT>

service:
  pipelines:
    metrics:
      receivers: [prometheus]
      processors: [batch]
      exporters: [otlphttp]

info

Examples for these integrations and more are here.