> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/infrastructure-as-code-management/3.0/platform/workspaces/cost-estimation.md).

# Cost Estimation

Harness IaCM provides two independent cost visibility features for workspaces. **Cloud Cost Estimation** uses [Infracost](https://www.infracost.io/) to estimate monthly cost changes from a Terraform or OpenTofu plan, while **Cloud Cost Management Integration** pulls actual infrastructure costs and optimization recommendations from the Harness Cloud Cost Management (CCM) module. Enable either or both features per workspace from the **Configuration** tab.

***

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

* **Workspace configuration access:** You need **View** and **Edit** permissions for IaCM workspaces to enable cost features. Go to [Workspace RBAC](/infrastructure-as-code-management/3.0/platform/workspaces/workspace-rbac.md) to configure permissions.
* **Terraform-based workspace:** Cloud Cost Estimation works with Terraform and OpenTofu workspaces. Go to [Create a workspace](/infrastructure-as-code-management/3.0/platform/workspaces/create-workspace.md) to set up a workspace.
* **CCM Integration (optional):** Cloud Cost Management Integration requires the Harness CCM module to be active on your account and cloud resources provisioned on AWS, Azure, or GCP.
* **Paid Infracost Cloud (optional):** Add an Infracost API key only if you subscribe to a paid Infracost Cloud plan and maintain custom pricing there. Go to [Infracost Cloud](https://www.infracost.io/) and [Infracost documentation](https://www.infracost.io/docs/) for account types and setup.

***

### How cost estimation works <a href="#how-cost-estimation-works" id="how-cost-estimation-works"></a>

Harness IaCM integrates with Infracost to estimate cloud infrastructure costs by analyzing Terraform plan output. When enabled, Harness automatically runs Infracost during every Terraform plan operation and calculates the estimated monthly cost difference based on current cloud provider pricing.

**Key characteristics:**

* **Approximations only:** Cost estimates may differ from actual costs based on your cloud provider agreement, usage patterns, and regional pricing variations.
* **Infrastructure focus:** Estimates cover infrastructure costs (compute, storage, networking) but not usage-based charges like data transfer or API calls.
* **Cloud provider support:** Works with AWS, Azure, and Google Cloud Platform.
* **Infracost Cloud API key (optional):** Harness integrates Infracost into IaCM, so estimates use public list prices from the open-source pricing data without an Infracost Cloud account. Set `INFRACOST_API_KEY` only if you have a **paid** Infracost Cloud plan **and** you define custom pricing in Infracost Cloud; otherwise the key does not add value.

***

### Cloud Cost Management Integration <a href="#cloud-cost-management-integration" id="cloud-cost-management-integration"></a>

{% hint style="info" %}
**PENDING RELEASE**

Cloud Cost Management Integration is currently **pending release**. Contact [Harness Support](mailto:support@harness.io) to request access.
{% endhint %}

Cloud Cost Management (CCM) Integration connects a workspace to the Harness CCM module to surface **actual** cloud infrastructure costs and cost optimization recommendations for the resources the workspace manages.

When enabled, Harness syncs cost and recommendation data from CCM approximately every 12 hours and writes it to the workspace. The following data appears on the workspace **Overview** tab:

* **Current Monthly Cost:** The total actual monthly spend for cloud resources in this workspace, based on usage data from your cloud provider as reported by CCM.
* **Optimization Opportunity:** The estimated potential monthly savings from CCM cost recommendations, along with a count of available recommendations.

#### How it differs from Cloud Cost Estimation <a href="#how-it-differs-from-cloud-cost-estimation" id="how-it-differs-from-cloud-cost-estimation"></a>

|                            | Cloud Cost Estimation                       | Cloud Cost Management Integration                      |
| -------------------------- | ------------------------------------------- | ------------------------------------------------------ |
| **Data source**            | Infracost (plan-time estimates)             | Harness CCM (actual usage costs)                       |
| **When it runs**           | During each Terraform or OpenTofu plan      | Approximately every 12 hours in the background         |
| **What it shows**          | Estimated cost change from a planned change | Actual current monthly spend and savings opportunities |
| **Where it appears**       | Approval steps, Cost Change Estimation tab  | Workspace Overview tab                                 |
| **Cloud provider support** | AWS, Azure, GCP                             | AWS, Azure, GCP                                        |

CCM Integration requires provisioned cloud resources with recognized provider types (AWS, Azure, or GCP) and the Harness CCM module active on your account.

***

### Enable cloud cost features <a href="#enable-cloud-cost-features" id="enable-cloud-cost-features"></a>

Both cost features are controlled from the **Cloud Cost Integration** section of the workspace **Configuration** tab. You can enable either or both independently.

1. In your IaCM project, go to **Workspaces**.
2. Select the workspace you want to configure.
3. Go to the **Configuration** tab.
4. Under **Cloud Cost Integration**, toggle the features you want to enable:
   * **Cloud Cost Estimation:** Enables Infracost-based cost estimates during Terraform and OpenTofu plan operations. Estimates appear in approval steps and the Cost Change Estimation tab.
   * **Cloud Cost Management Integration:** Pulls actual infrastructure costs and optimization recommendations from the Harness CCM module. Results appear on the workspace Overview tab.

<div data-with-frame="true"><figure><img src="/files/Cpna54FKCPkl60bjbzVD" alt=""><figcaption></figcaption></figure></div>

Settings apply immediately. Future pipeline executions will reflect the updated configuration.

***

### Where to view cost data <a href="#where-to-view-cost-data" id="where-to-view-cost-data"></a>

Each cost feature surfaces data in a different location.

#### Workspace Overview tab <a href="#workspace-overview-tab" id="workspace-overview-tab"></a>

When Cloud Cost Management Integration is enabled, the workspace **Overview** tab displays the **Current Monthly Cost** and **Optimization Opportunity** cards. These show actual infrastructure costs and CCM recommendations for the resources managed by the workspace.

Go to [Workspaces overview](/infrastructure-as-code-management/3.0/platform/workspaces/workspace-overview.md) to understand the workspace Overview tab.

#### Approval steps <a href="#approval-steps" id="approval-steps"></a>

When your pipeline includes an approval step after a Terraform plan, the approval interface displays Infracost cost estimates alongside resource changes. This allows approvers to review the estimated financial impact before authorizing the apply operation.

<figure><img src="/files/LP525uFzGAX0kEq9wOHH" alt="Cost estimates in approval step"><figcaption><p>Click to view full size</p></figcaption></figure>

*Infracost cost estimates displayed in the approval step alongside resource changes*

The approval step shows the estimated monthly cost difference (increase or decrease) compared to the current infrastructure state.

#### Cost Change Estimation tab <a href="#cost-change-estimation-tab" id="cost-change-estimation-tab"></a>

For a complete audit trail, Harness stores Infracost cost estimation data for every pipeline execution in the **Cost Change Estimation** tab. You can review historical cost estimates for past runs, compare cost impacts across different changes, and track infrastructure spending trends over time.

<figure><img src="/files/4pyUaZiQ2RBKrRaoBf95" alt="Cost Change Estimation tab"><figcaption><p>Click to view full size</p></figcaption></figure>

*Cost Change Estimation tab showing historical Infracost data for pipeline executions*

This tab is available in the pipeline execution details view and persists the cost data even after the pipeline completes.

***

### Configure Infracost Cloud (optional) <a href="#configure-infracost-cloud-optional" id="configure-infracost-cloud-optional"></a>

Harness integrates Infracost into IaCM. Cost estimation uses Infracost's open-source pricing database and public list prices by default, so you get estimates without signing up for Infracost Cloud.

Configure an Infracost Cloud API key **only** when you meet **both** of the following:

* You subscribe to a **paid** Infracost Cloud plan.
* You maintain **custom pricing** in Infracost Cloud (for example, enterprise discounts or negotiated rates), and you want those rules applied to estimates in IaCM.

If you do not need custom pricing or do not have a paid Infracost Cloud plan, skip this step. An API key does not change the default experience.

To connect a paid Infracost Cloud organization that uses custom pricing:

1. Use your paid Infracost Cloud account at [Infracost Cloud](https://www.infracost.io/).
2. Generate an API key from the Infracost dashboard. Go to [Infracost documentation](https://www.infracost.io/docs/) to follow the setup instructions.
3. In your workspace, go to the **Connectors and Variables** tab.
4. Under **Environment Variables**, select **+ Add Variable**, enter `INFRACOST_API_KEY` as the key, and your API key as the value.

With a valid key from a paid plan, Infracost can apply the custom pricing rules you configure in Infracost Cloud where supported.

***

### Limitations <a href="#limitations" id="limitations"></a>

Be aware of these limitations when using cost estimation:

* **Cloud provider support:** Cost estimation supports AWS, Azure, and Google Cloud Platform. Other cloud providers are not currently supported.
* **Resource coverage:** Not all Terraform resources have cost estimates. Infracost maintains pricing data for common infrastructure resources (compute instances, storage, databases, networking), but some specialized or newer resource types may show as "unsupported" or display $0 estimates.
* **Estimation accuracy:** Cost estimates are approximations based on standard pricing. Actual costs may vary due to enterprise agreements, reserved instances, committed use discounts, spot pricing, or usage-based charges that cannot be predicted from Terraform plans alone.
* **OpenTofu compatibility:** Cost estimation works with both Terraform and OpenTofu workspaces, but ensure you are using a recent version of Infracost that supports your OpenTofu version.
* **Performance impact:** Enabling cost estimation adds minimal overhead to Terraform plan operations. Most plans complete within seconds, but very large plans with thousands of resources may see a slight increase in execution time.

***

### Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

<details>

<summary>Cost estimates do not appear after enabling cost estimation</summary>

Verify that your pipeline includes a Terraform plan operation. Cost estimates only appear for plan operations, not for apply-only runs. Check the workspace Configuration tab to confirm cost estimation is toggled on.

</details>

<details>

<summary>Infracost API errors or authentication failures with Infracost Cloud</summary>

Verify the INFRACOST\_API\_KEY environment variable is correctly set in the workspace Connectors and Variables tab under Environment Variables. Test your API key by running \`infracost auth login\` locally. Ensure your Infracost Cloud account is active and the API key has not expired.

</details>

<details>

<summary>Cost estimate shows $0 or unavailable for specific resources</summary>

Some Terraform resources are not supported by Infracost's pricing database. Check the Infracost documentation for supported resources at <https://www.infracost.io/docs/supported\\_resources/>. If you need estimates that reflect negotiated rates, you need a paid Infracost Cloud plan with custom pricing and an API key configured as described under Configure Infracost Cloud (optional).

</details>

<details>

<summary>Cost estimate differs significantly from actual cloud bill</summary>

Cost estimates are based on standard cloud provider pricing and cannot account for enterprise agreements, reserved instances, spot pricing, or usage-based charges. Review your cloud provider's billing dashboard to understand the source of cost differences. Use cost estimates as directional guidance, not exact predictions.

</details>

<details>

<summary>Cloud Cost Management Integration shows no data on the workspace Overview tab despite the toggle being enabled in IaCM</summary>

Confirm the Harness CCM module is active on your account and that the workspace manages resources on AWS, Azure, or GCP. CCM Integration syncs approximately every 12 hours, so data may not appear immediately after enabling the toggle. If no data appears after 24 hours, verify that CCM has visibility into the cloud account where these resources are provisioned.

</details>

***

### Next steps <a href="#next-steps" id="next-steps"></a>

Now that you understand how cost estimation works in IaCM, explore related workspace and governance topics:

* [Create a workspace](/infrastructure-as-code-management/3.0/platform/workspaces/create-workspace.md): Learn how to create and configure workspaces.
* [Workspace RBAC](/infrastructure-as-code-management/3.0/platform/workspaces/workspace-rbac.md): Control who can enable cost estimation and view cost estimates.
* [IaCM pipelines](/infrastructure-as-code-management/3.0/platform/iacm-pipelines.md): Understand how cost estimates integrate with Terraform plan and approval steps.
* [Infracost documentation](https://www.infracost.io/docs/): Optional Infracost Cloud setup, API keys for paid plans, and supported resources.