Temporal integration for Grafana Cloud
Temporal offers an abstraction for building simple, sophisticated, resilient applications.
Before you begin
- Authentication - You need a service account API key with the “Metrics Read-Only” Account Level Role.
Install Temporal integration for Grafana Cloud
- In your Grafana Cloud stack, click Connections in the left-hand menu.
- Find and select the Temporal tile to open the integration.
- Follow the steps outlined on the Configuration page to configure scrape jobs, which pull the data from Temporal.
- Once scrape jobs are configured, click Install to add the prebuilt dashboards to your Grafana Cloud instance.
Configuration
The Temporal integration works by periodically scraping the Temporal API for metrics. You can set up multiple scrape jobs on one Grafana Cloud instance. This can be useful, if you want to monitor multiple accounts in a single instance.
Create scrape jobs
To configure scrape jobs for the Temporal integration, follow these steps:
- Give a unique name to your scrape job using only alphanumeric characters, dashes, and underscores. All metric series that this scrape job collects will be labeled with the associated scrape job name.
- Set the API key for the scrape job.
- Choose the scrape interval for your job. The default value of 1 minute should serve most use cases. A lower value will increase the DPM of the series collected - this may have billing implications. For more information refer to cost management and billing documentation.
- Test the connection to ensure that Grafana Cloud can connect using this API key. If there is an error, an error message will specify the reason for the failure.
- Save the scrape job, which will automatically begin scraping your metrics and push them into your Grafana Cloud Metrics instance.
After installation, visit the Temporal overview dashboard to check the status of your scrape job or explore your metrics.
Dashboards
The Temporal integration installs the following dashboard in your Grafana Cloud instance.
- Temporal overview
Screenshot of the Temporal Grafana dashboard
Changelog
# 1.0.0 - September 2025
* Initial release