Temporal Cloud integration

Our Temporal Cloud integration monitors the performance of your Temporal Cloud data, helping you diagnose issues in your workflows, namespaces and scalable applications. Our Temporal Cloud integration gives you a pre-built dashboard with your most important Temporal Cloud metrics.

A screenshot depicting the Temporal Cloud dashboard

After setting up the integration with New Relic, see your data in dashboards like these, right out of the box.

Install the infrastructure agent

To use the Temporal Cloud integration, you need to first install the infrastructure agent on the same host. The infrastructure agent monitors the host itself, while the integration you'll install in the next step extends your monitoring with Temporal-specific data such as database and instance metrics.

Configure `nri-flex` for Temporal Cloud

Once the Temporal Cloud metrics are exposed on the Prometheus endpoint, accessible via https://<account-id>.tmprl.cloud/prometheus, you will need to configure your setup accordingly.

Note

Flex requires a New Relic account and is compatible with the following operating systems/platforms:

Linux
Windows
Kubernetes
For more information on compatible distros and versions, see the Infrastructure agent compatibility page.

Create file with named nri-flex-temporal-cloud-config.yml in this path:
bash
```
$touch /etc/newrelic-infra/integrations.d/
```

Below is a nri-flex configuration file. Be sure to copy and paste its contents into your previously created nri-flex-temporal-cloud-config.yml file, and remember to update your account ID in the Prometheus endpoint URL, as well as the paths for the certificate files:

integrations:
  - name: nri-flex
    config:
      name: temporalCloudIntegration
      apis:
        - event_type: temporalCloudFrontendServiceError
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_frontend_service_error_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudFrontendServiceRequest
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_frontend_service_request_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudPollSuccess
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_poll_success_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudPollSuccessSync
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_poll_success_sync_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudPollTimeout
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_poll_timeout_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudResourceExhaustedErrors
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_resource_exhausted_error_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudScheduleActionSuccess
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_schedule_action_success_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudScheduleBufferOverruns
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_schedule_buffer_overruns_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudScheduleMissedCatchupWindow
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_schedule_missed_catchup_window_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudScheduleRateLimited
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_schedule_rate_limited_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudServiceLatencyBucket
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_service_latency_bucket
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudServiceLatencyCount
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_service_latency_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudServiceLatencySum
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_service_latency_sum
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudStateTransition
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_state_transition_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudTotalAction
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_total_action_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudWorkflowCancel
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_workflow_cancel_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudWorkflowContinued
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_workflow_continued_as_new_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudWorkflowFailed
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_workflow_failed_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudWorkflowSuccess
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_workflow_success_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudWorkflowTerminate
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_workflow_terminate_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem
        - event_type: temporalCloudWorkflowTimeout
          url: https://<your_account>.tmprl.cloud/prometheus/api/v1/query?query=temporal_cloud_v0_workflow_timeout_count
          headers:
            accept: application/json
          split_array: true
          leaf_array: true
          tls_config:
            enable: true
            ca: <your_file_path>/ca-certificates.crt
            key: <your_file_path>/ca.key
            cert: <your_file_path>/ca.pem

Use our instructions to restart your infrastructure agent:
bash
```
$sudo systemctl restart newrelic-infra.service
```
Wait a few minutes until data starts folowing into your New Relic account.

Find your data

You can choose our pre-built dashboard template named Temporal Cloud to monitor your Temporal Cloud metrics. Follow these steps to use our pre-built dashboard template:

From one.newrelic.com, go to the + Integrations & Agents page.
Click on Dashboards.
In the search bar, type Temporal Cloud.
The Temporal Cloud dashboard should appear. Click on it to install it.
Your Temporal Cloud dashboard is considered a custom dashboard and can be found in the Dashboards UI. For docs on using and editing dashboards, see our dashboard docs.
Here is a NRQL query to check the Temporal Cloud frontend service requests count:
```
FROM temporalCloudFrontendServiceRequest SELECT latest(`data.result-value1`) FACET `data.result-metric-__name__`
```

What's next?

To learn more about building NRQL queries and generating dashboards, check out these docs:

Introduction to the query builder to create basic and advanced queries.
Introduction to dashboards to customize your dashboard and carry out different actions.
Manage your dashboard to adjust your dashboards display mode, or to add more content to your dashboard.

Install the infrastructure agent .css-21sua1{background:none;border:none;width:0;padding:0;}

Configure nri-flex for Temporal Cloud

Note

Find your data

What's next?

Install the infrastructure agent

Configure `nri-flex` for Temporal Cloud