---
title: Temporal Cloud Cost Management
description: >-
  Collects Temporal Cloud cost data in Cloud Cost Management, grouped by
  namespace and service subcategory.
breadcrumbs: Docs > Integrations > Temporal Cloud Cost Management
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Temporal Cloud Cost Management
Supported OS Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}
   Temporal Cloud Cost Management DashboardTemporal Cloud Cost Management DashboardCloud Costs Explorer
## Overview{% #overview %}

Temporal Cloud is a managed workflow orchestration platform. This integration sends Temporal Cloud billing data to Datadog Cloud Cost Management, so you can attribute spend across your Temporal namespaces and usage types.

### What this integration provides{% #what-this-integration-provides %}

The integration collects daily cost line items from the Temporal Cloud Billing API and submits them to Cloud Cost Management. It attributes costs across the following dimensions:

- **Namespace**: the Temporal namespace that generated the cost
- **Service subcategory**: the usage type, such as Actions, Active Storage, or Retained Storage
- **Stock keeping unit (SKU)**: the billable unit and the meter it is measured by

Custom namespace tags are preserved as `temporal_tag_<key>` tags, so you can group and filter costs by your own labels.

### Analyze Temporal Cloud spend in Datadog{% #analyze-temporal-cloud-spend-in-datadog %}

After you set up the integration, view your Temporal Cloud costs in Cloud Cost Management. Filter by `providername:temporal_cloud` to break down spend by namespace, sku, service subcategory, and tag. You can also combine Temporal Cloud costs with your other cloud provider costs in a single view.

## Setup{% #setup %}

### Prerequisites{% #prerequisites %}

- A Temporal Cloud account with the Billing API enabled. The Billing API is in pre-release. Request access from Temporal Cloud support.
- Datadog Cloud Cost Management enabled.

### Create a Temporal Cloud service account and API key{% #create-a-temporal-cloud-service-account-and-api-key %}

1. Sign in to Temporal Cloud at `https://cloud.temporal.io`.
1. Go to **Settings** > **Service Accounts** > **Create Service Account**.
1. Set the account role to **Finance Admin** or **Account Owner**. (The **Metrics Read-Only** and **Account Admin** roles cannot access the Billing API.)
1. Select **Generate API Key**, then copy the key. Note that Temporal will not display this key again.

### Configure the Temporal Cloud Cost Management integration in Datadog{% #configure-the-temporal-cloud-cost-management-integration-in-datadog %}

1. In Datadog, open the **Temporal Cloud Cost Management** tile and click **Install Integration**.
1. Click **Configure**, then **Add Account**.
1. In the **API Key** field, enter the service account API key you generated earlier.
1. Click **Save**.

Temporal Cloud cost data begins to appear in Cloud Cost Management within 25–30 hours.

## Uninstallation{% #uninstallation %}

To uninstall the integration, remove the configured account from the **Temporal Cloud Cost Management** tile in Datadog. Deleting the last account uninstalls the integration and stops cost collection.

## Support{% #support %}

Need help? Contact [Datadog Support](https://app.datadoghq.com/help).