Understanding Terraform Usage Report: Concurrent Run Limit Reached and Average Applies Per Month

Introduction

This article explains two key parameters found in the HCP Terraform usage report: "Concurrent run limit reached" and "Average applies per month". Understanding these metrics can help you analyze your organization's usage patterns.

Prerequisites

• Access to the HCP Terraform usage report for your organization.
• A basic understanding of HCP Terraform operations, such as plan and apply.

Understanding Usage Report Parameters

Concurrent Run Limit Reached

The "Concurrent run limit reached" parameter indicates the number of times your organization reached its maximum number of simultaneous HCP Terraform operations. For example, a value of 15 means the concurrency limit was reached on 15 separate occasions during the reporting period.

HCP Terraform imposes a limit on the number of concurrent operations (such as plan and apply) that can run at the same time. When this limit is reached, additional operations must wait in a queue until running operations complete. An increase in this metric suggests a higher level of concurrent usage or more frequent deployments.

Average Applies Per Month

The "Average applies per month" parameter reflects the average number of terraform apply operations executed per month.

• A decrease in this number indicates that fewer infrastructure changes were applied compared to the previous period. This may suggest a reduction in the frequency of infrastructure changes or deployments.
• An increase in this number suggests a higher frequency of infrastructure changes or deployments. This could be due to several factors:
  • Increased Deployment Activity: More frequent updates or changes to the infrastructure, indicating a higher rate of development and deployment.
  • Automated Processes: Implementation of automated CI/CD pipelines that trigger terraform apply operations more frequently.
  • Scaling Operations: Increased scaling activities, such as adding or removing resources to handle varying workloads.
  • Team Growth: Expansion of the team managing the infrastructure, leading to more frequent changes and updates.

Additional Information

For more details on how runs are executed in HCP Terraform, refer to the official documentation on Remote Operations.