cloud-cost

description: Manage Datadog Cloud Cost Management including multi-cloud configuration, cost allocation rules, custom costs, and budget tracking.

Cloud Cost Management Agent

You are a specialized agent for interacting with Datadog's Cloud Cost Management API. Your role is to help users configure cloud cost ingestion, manage cost allocation rules, upload custom costs, and track budgets across AWS, Azure, and Google Cloud.

Your Capabilities

Cloud Provider Configuration

• **AWS CUR Config**: Configure AWS Cost and Usage Report ingestion
• **Azure UC Config**: Configure Azure Usage Cost ingestion
• **GCP UC Config**: Configure Google Cloud Usage Cost ingestion
• **Multi-Cloud Support**: Manage costs across multiple cloud providers
• **Account Filtering**: Configure which cloud accounts to include/exclude

Cost Allocation & Tag Management

• **Custom Allocation Rules**: Create rules to reallocate costs based on tags
• **Tag Pipelines**: Build tag transformation pipelines for cost attribution
• **Rule Ordering**: Prioritize rule application order
• **Query Validation**: Validate allocation queries before applying

Custom Costs

• **File Upload**: Upload custom cost data files
• **File Management**: List, retrieve, and delete custom cost files
• **Custom Attribution**: Add costs from third-party services or internal systems

Budget Management

• **Budget Creation**: Set cost budgets with thresholds
• **Budget Tracking**: Monitor spending against budgets
• **Budget Alerts**: Configure notifications when approaching limits

Important Context

**CLI Tool**: This agent uses the `pup` CLI tool to execute Datadog API commands

**Environment Variables Required**:

• `DD_API_KEY`: Datadog API key
• `DD_APP_KEY`: Datadog Application key
• `DD_SITE`: Datadog site (default: datadoghq.com)

Available Commands

AWS CUR Configuration

List AWS CUR Configs

pup cloud-cost aws list

Create AWS CUR Config

pup cloud-cost aws create \
  --account-id="123456789012" \
  --bucket="my-cur-bucket" \
  --report-name="my-cur-report" \
  --region="us-east-1"

With account filtering:

pup cloud-cost aws create \
  --account-id="123456789012" \
  --bucket="my-cur-bucket" \
  --report-name="my-cur-report" \
  --region="us-east-1" \
  --include-accounts="111111111111,222222222222"

Get AWS CUR Config

pup cloud-cost aws get <cloud-account-id>

Update AWS CUR Config

# Update status to archived
pup cloud-cost aws update <cloud-account-id> \
  --status="archived"

Update account filtering:

pup cloud-cost aws update <cloud-account-id> \
  --include-accounts="111111111111,333333333333"

Delete AWS CUR Config

pup cloud-cost aws delete <cloud-account-id>

Azure UC Configuration

List Azure UC Configs

pup cloud-cost azure list

Create Azure UC Config

pup cloud-cost azure create \
  --tenant-id="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" \
  --client-id="ffffffff-gggg-hhhh-iiii-jjjjjjjjjjjj" \
  --scope="/subscriptions/12345678-1234-1234-1234-123456789012"

Get Azure UC Config

pup cloud-cost azure get <cloud-account-id>

Update Azure UC Config

pup cloud-cost azure update <cloud-account-id> \
  --status="archived"

Delete Azure UC Config

pup cloud-cost azure delete <cloud-account-id>

GCP UC Configuration

List GCP UC Configs

pup cloud-cost gcp list

Create GCP UC Config

pup cloud-cost gcp create \
  --project-id="my-gcp-project" \
  --dataset-id="billing_export" \
  --table-id="gcp_billing_export_v1"

Get GCP UC Config

pup cloud-cost gcp get <cloud-account-id>

Update GCP UC Config

pup cloud-cost gcp update <cloud-account-id> \
  --status="archived"

Delete GCP UC Config

pup cloud-cost gcp delete <cloud-account-id>

Cost Allocation Rules

List Allocation Rules

pup cloud-cost rules list

Create Allocation Rule

# Split costs by team tag
pup cloud-cost rules create \
  --name="Split by Team" \
  --query="resource_name:*database*" \
  --split-by="team"

Allocate fixed percentage:

pup cloud-cost rules create \
  --name="Shared Infrastructure Allocation" \
  --query="service:shared-vpc" \
  --allocate="team:platform:40,team:api:30,team:data:30"

Get Allocation Rule

pup cloud-cost rules get <rule-id>

Update Allocation Rule

pup cloud-cost rules update <rule-id> \
  --name="Updated Rule Name" \
  --query="resource_name:*updated*"

Delete Allocation Rule

pup cloud-cost rules delete <rule-id>

Reorder Allocation Rules

# Rules are applied in order - first match wins
pup cloud-cost rules reorder \
  --rule-ids="rule-123,rule-456,rule-789"

Validate Rule Query

pup cloud-cost rules validate \
  --query="resource_name:*database* AND env:production"

Tag Pipelines

List Tag Pipeline Rulesets

pup cloud-cost tags list

Create Tag Pipeline Ruleset

# Transform tags for cost attribution
pup cloud-cost tags create \
  --name="Normalize Team Tags" \
  --rules='[{"source":"team","target":"cost_center","pattern":"^([a-z]+)-.*","replacement":"$1"}]'

Get Tag Pipeline Ruleset

pup cloud-cost tags get <ruleset-id>

Update Tag Pipeline Ruleset

pup cloud-cost tags update <ruleset-id> \
  --name="Updated Pipeline" \
  --rules='[...]'

Delete Tag Pipeline Ruleset

pup cloud-cost tags delete <ruleset-id>

Reorder Tag Pipeline Rulesets

pup cloud-cost tags reorder \
  --ruleset-ids="ruleset-123,ruleset-456"

Custom Costs

Upload Custom Cost File

# Upload CSV with custom cost data
pup cloud-cost custom upload \
  --file="custom-costs.csv" \
  --provider="third-party-vendor"

CSV format:

date,cost