From e4e0aaebd667713454d2a8d0e794784431151ec1 Mon Sep 17 00:00:00 2001 From: Rosa Trieu Date: Fri, 18 Jul 2025 15:11:02 -0700 Subject: [PATCH 1/4] [DOCS-10758] Consolidate CCMTags docs --- config/_default/menus/main.en.yaml | 29 +++-- content/en/cloud_cost_management/_index.md | 15 +-- .../custom_allocation_rules.md | 2 +- content/en/cloud_cost_management/setup/aws.md | 9 +- .../en/cloud_cost_management/setup/azure.md | 5 +- .../setup/google_cloud.md | 6 +- .../en/cloud_cost_management/tags/_index.md | 107 ++++++++++++++++++ .../_index.md => tags/tag_explorer.md} | 6 +- .../{ => tags}/tag_pipelines.md | 4 +- 9 files changed, 151 insertions(+), 32 deletions(-) create mode 100644 content/en/cloud_cost_management/tags/_index.md rename content/en/cloud_cost_management/{tag_explorer/_index.md => tags/tag_explorer.md} (97%) rename content/en/cloud_cost_management/{ => tags}/tag_pipelines.md (96%) diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 1e1111e5e454c..e21938109768e 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -3638,46 +3638,51 @@ menu: parent: cloud_cost_planning identifier: cloud_cost_planning_commitment_programs weight: 502 - - name: Tag Pipelines - url: cloud_cost_management/tag_pipelines + - name: Tags + url: cloud_cost_management/tags parent: cloud_cost - identifier: cloud_cost_tag_pipelines + identifier: cloud_cost_tags weight: 6 - name: Tag Explorer - url: cloud_cost_management/tag_explorer - parent: cloud_cost + url: cloud_cost_management/tags/tag_explorer + parent: cloud_cost_tags identifier: cloud_cost_tag_explorer - weight: 7 + weight: 601 + - name: Tag Pipelines + url: cloud_cost_management/tags/tag_pipelines + parent: cloud_cost_tags + identifier: cloud_cost_tag_pipelines + weight: 602 - name: Multisource Querying url: cloud_cost_management/multisource_querying parent: cloud_cost identifier: cloud_cost_multisource_querying - weight: 8 + weight: 7 - name: Reports url: /cloud_cost_management/reports parent: cloud_cost identifier: cloud_cost_reports - weight: 9 + weight: 8 - name: Recommendations url: cloud_cost_management/recommendations parent: cloud_cost identifier: cloud_cost_recommendations - weight: 10 + weight: 9 - name: Custom Recommendations url: cloud_cost_management/recommendations/custom_recommendations parent: cloud_cost_recommendations identifier: cloud_cost_custom_recommendations - weight: 1001 + weight: 901 - name: Monitors url: /cloud_cost_management/monitors parent: cloud_cost identifier: cloud_cost_monitors - weight: 11 + weight: 10 - name: Anomalies url: /cloud_cost_management/anomalies parent: cloud_cost identifier: cloud_cost_anomalies - weight: 12 + weight: 11 - name: APM url: tracing/ pre: apm diff --git a/content/en/cloud_cost_management/_index.md b/content/en/cloud_cost_management/_index.md index bfb8fcb4469c0..53bdf5f2b375e 100644 --- a/content/en/cloud_cost_management/_index.md +++ b/content/en/cloud_cost_management/_index.md @@ -19,12 +19,9 @@ further_reading: - link: "/monitors/types/cloud_cost/" tag: "Documentation" text: "Create a Cloud Cost monitor" - - link: "/cloud_cost_management/tag_pipelines/" + - link: "/cloud_cost_management/tags/" tag: "Documentation" - text: "Learn about Tag Pipelines" - - link: "/cloud_cost_management/tag_pipelines" - tag: "Documentation" - text: "Standardize tags across Cloud Cost Management with Tag Pipelines" + text: "Learn about Tags in Cloud Cost Management" - link: "https://www.datadoghq.com/blog/cloud-costs-study-learnings/" tag: "Blog" text: "Key learnings from the State of Cloud Costs study" @@ -84,11 +81,9 @@ When creating a dashboard, select **Cloud Cost** as the data source for your sea Optionally, you can programmatically export a timeseries graph of your Datadog cost data by using the [Metrics API][2]. -## Create tag rules - -Use [Tag Pipelines][5] to ensure comprehensive cost tracking by standardizing the tags across all cloud resources. This prevents any cost data from being overlooked. +## Tagging and cost allocation -{{< img src="cloud_cost/tags_addnew.png" alt="Create a tag rule in Tag Pipelines to ensure your cloud resources use standard tags" style="width:60%;" >}} +Use the [Tags documentation][5] to understand how tags are sourced, enriched, and managed in Cloud Cost Management. You can create tag rules to correct missing or incorrect tags and add inferred tags that align with your organization's business logic. @@ -135,4 +130,4 @@ The table below describes the impact of these permissions in both Cloud Cost Man [2]: /api/latest/metrics/#query-timeseries-data-across-multiple-products [3]: /monitors/types/cloud_cost/ [4]: /cloud_cost_management/container_cost_allocation -[5]: /cloud_cost_management/tag_pipelines +[5]: /cloud_cost_management/tags/ diff --git a/content/en/cloud_cost_management/custom_allocation_rules.md b/content/en/cloud_cost_management/custom_allocation_rules.md index 5bf40288f4665..8f2964b5f5251 100644 --- a/content/en/cloud_cost_management/custom_allocation_rules.md +++ b/content/en/cloud_cost_management/custom_allocation_rules.md @@ -173,6 +173,6 @@ Changes to custom allocation rules may take up to 24 hours to be applied. After ## Further reading {{< partial name="whats-next/whats-next.html" >}} -[1]: /cloud_cost_management/tag_pipelines +[1]: /cloud_cost_management/tags/tag_pipelines [2]: https://app.datadoghq.com/cost/settings/custom-allocation-rules [3]: https://www.datadoghq.com/support/ diff --git a/content/en/cloud_cost_management/setup/aws.md b/content/en/cloud_cost_management/setup/aws.md index 93141fce8d2a0..49a499931f5a6 100644 --- a/content/en/cloud_cost_management/setup/aws.md +++ b/content/en/cloud_cost_management/setup/aws.md @@ -260,7 +260,9 @@ In general: ## Tag enrichment -Datadog adds tags to the ingested cost data using many sources, described in detail below. +Datadog automatically enriches your AWS cost data with tags from multiple sources. For a comprehensive overview of how tags are applied to cost data, see [Tags][18]. + +The following tag sources are available for AWS: - Cost and Usage Report columns - AWS Resource tags @@ -404,7 +406,7 @@ _Requires [container cost allocation][11], and applies only to `shared.resources ### Tag pipelines -Finally, all of your [tag pipeline][15] rulesets are applied, providing complete cost allocation when infrastructure tagging is not possible. +Finally, all of your [tag pipeline][15] rulesets are applied, providing complete cost allocation when infrastructure tagging is not possible. Tag pipelines are the final enrichment layer and can override tags from other sources. ## Billing conductor [AWS Billing Conductor][16] is a custom billing service for AWS Marketplace Channel Partners (Partners) and organizations that have chargeback requirements. @@ -434,6 +436,7 @@ After the billing conductor CUR is created, follow the Cloud Cost Management ins [12]: https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html [13]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html [14]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tagging.html -[15]: /cloud_cost_management/tag_pipelines +[15]: /cloud_cost_management/tags/tag_pipelines [16]: https://docs.aws.amazon.com/billingconductor/latest/userguide/what-is-billingconductor.html [17]: https://app.datadoghq.com/cost/settings/accounts +[18]: /cloud_cost_management/tags diff --git a/content/en/cloud_cost_management/setup/azure.md b/content/en/cloud_cost_management/setup/azure.md index 886abd5784178..548b64a9bccdb 100644 --- a/content/en/cloud_cost_management/setup/azure.md +++ b/content/en/cloud_cost_management/setup/azure.md @@ -151,7 +151,9 @@ You can visualize your ingested data using the following cost types: ### Out-of-the-box tags -Datadog adds out-of-the-box tags to ingested cost data to help you further break down and allocate your costs. These tags are derived from your [usage cost report][9] and make it easier to discover and understand cost data. +Datadog automatically enriches your Azure cost data with tags from multiple sources. For a comprehensive overview of how tags are applied to cost data, see [Tags][12]. + +The following out-of-the-box tags are derived from your [usage cost report][9] and make it easier to discover and understand cost data: | Tag Name | Tag Description | | ---------------------------- | ----------------- | @@ -239,3 +241,4 @@ You can create historical data in your storage account using the [Microsoft API] [9]: https://learn.microsoft.com/en-us/azure/cost-management-billing/understand/download-azure-daily-usage [10]: https://docs.azure.cn/en-us/cost-management-billing/manage/resolve-past-due-balance#check-the-type-of-your-account [11]: /help/ +[12]: /cloud_cost_management/tags diff --git a/content/en/cloud_cost_management/setup/google_cloud.md b/content/en/cloud_cost_management/setup/google_cloud.md index 81c6c49af4e47..cd4debd709d0d 100644 --- a/content/en/cloud_cost_management/setup/google_cloud.md +++ b/content/en/cloud_cost_management/setup/google_cloud.md @@ -142,9 +142,10 @@ You can visualize your ingested data using the following cost types: | `gcp.cost.ondemand` | Total public, on-demand cost of resources before public and private discounts are applied over an interval. | ### Out-of-the-box tags -Datadog adds out-of-the-box tags to ingested cost data to help you further break down and allocate your costs. These tags are derived from your [detailed usage cost report][16] and make it easier to discover and understand cost data. -The following out-of-the-box tags are available for filtering and grouping data: +Datadog automatically enriches your Google Cloud cost data with tags from multiple sources. For a comprehensive overview of how tags are applied to cost data, see [Tags][17]. + +The following out-of-the-box tags are derived from your [detailed usage cost report][16] and make it easier to discover and understand cost data: | Tag Name | Tag Description | | ---------------------------- | ----------------- | @@ -204,3 +205,4 @@ The following out-of-the-box tags are available: [14]: /cloud_cost_management/container_cost_allocation/ [15]: /cloud_cost_management/setup/google_cloud/#create-or-select-a-google-cloud-storage-bucket [16]: https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables/detailed-usage +[17]: /cloud_cost_management/tags diff --git a/content/en/cloud_cost_management/tags/_index.md b/content/en/cloud_cost_management/tags/_index.md new file mode 100644 index 0000000000000..b2a4de2b458b7 --- /dev/null +++ b/content/en/cloud_cost_management/tags/_index.md @@ -0,0 +1,107 @@ +--- +title: Tags +description: Learn how tags are sourced, enriched, and managed in Cloud Cost Management. +further_reading: +- link: "/cloud_cost_management/" + tag: "Documentation" + text: "Learn about Cloud Cost Management" +- link: "/cloud_cost_management/tags/tag_pipelines" + tag: "Documentation" + text: "Tag Pipelines" +- link: "/cloud_cost_management/tags/tag_explorer" + tag: "Documentation" + text: "Tag Explorer" +- link: "/getting_started/tagging/" + tag: "Documentation" + text: "Getting Started with Tags" +--- + +## Overview + +Tags help you organize, filter, and allocate your cloud costs effectively. With proper tagging, you can see exactly who's spending what, identify optimization opportunities, and create accurate chargeback reports. Cloud Cost Management automatically enriches your cost data with tags from multiple sources, so you can focus on using tags to drive insights rather than managing the technical details. + +## Getting started + +Get started with tags in three steps: + +1. **See what you have** - Use [Tag Explorer][5] to discover which tags are already available in your cost data. +2. **Identify gaps** - Look for missing tags that would help you track costs by team, project, or environment. +3. **Add missing tags** - Use [Tag Pipelines][4] to automatically add tags based on your business logic. + +{{< img src="cloud_cost/tag_explorer/aws_1.png" alt="Tag Explorer interface showing available AWS tags and their usage" style="width:80%;" >}} + +## Common scenarios + +- **Track costs by team, service, or environment** - See exactly who's spending what and identify optimization opportunities +- **Allocate shared costs fairly** - Distribute costs across teams and projects for accurate chargeback and showback + +## Where your tags come from + +Datadog applies tags to cost data using the following sources: + +- **[Out-of-the-box tags][1]** - Standardized tags that Datadog automatically generates from some billing data columns (like `aws_product` and `aws_region`) in your cost and usage report. +- **[Container allocation tags][2]** - Tags from your container workloads +- **[Resource and account tags][3]** - Tags you've applied to your cloud resources +- **[Tag pipelines][4]** - Custom rules you create to add missing tags + +## How tags are attached to cost data + +Datadog automatically associates tags with your cost data through a multi-step process as new cost data is ingested. Your cost analysis always reflects the most current tag information. + +1. **Data ingestion** - When cost data arrives from your cloud provider (through billing reports, APIs, and so on), Datadog identifies the specific resources and services being billed. +2. **Tag lookup** - For each cost datapoint, Datadog looks up available tags from all configured sources (billing data, resource tags, container metadata, and so on). +3. **Tag application** - Tags are attached to the cost data based on a precedence order: + - Tag Pipelines (highest priority) + - Container tags + - Resource/account tags + - Out-of-the-box tags + - Billing data (lowest priority) + +4. **Data storage** - The enriched cost data with all associated tags is stored and made available for analysis. + +## Essential tags and examples + +In addition to out-of-the-box tags, you can add these key tags to get the most value from your cost data: + +### Team and ownership tags +- `team` - Which team owns the resource +- `owner` - Individual responsible for the resource +- `project` - Project or initiative the resource supports + +**Example: Track costs by team** +Tag your resources with `team:engineering` or `team:marketing`, then: +- Create dashboards showing spend by team +- Set up alerts for unusual team spending +- Generate monthly cost reports per team + +### Environment and lifecycle tags +- `env` - Environment (prod, staging, dev) +- `service` - Application or service name +- `version` - Application version or release + +**Example: Identify unused resources** +Use tags like `env:dev` and `purpose:testing` to: +- Find development resources that can be stopped +- Track costs for temporary projects +- Clean up abandoned test environments + +### Business context tags +- `cost-center` - Budget or cost center +- `business-unit` - Business unit or department +- `purpose` - What the resource is used for + +**Example: Optimize container costs** +With container cost allocation, you can: +- See costs broken down by pod, namespace, or deployment +- Identify which applications are most expensive +- Optimize resource requests and limits + +## Further reading + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /cloud_cost_management/multisource_querying/ +[2]: /cloud_cost_management/container_cost_allocation +[3]: /cloud_cost_management/setup/aws/#aws-resource-tags +[4]: /cloud_cost_management/tags/tag_pipelines +[5]: /cloud_cost_management/tags/tag_explorer \ No newline at end of file diff --git a/content/en/cloud_cost_management/tag_explorer/_index.md b/content/en/cloud_cost_management/tags/tag_explorer.md similarity index 97% rename from content/en/cloud_cost_management/tag_explorer/_index.md rename to content/en/cloud_cost_management/tags/tag_explorer.md index ae94e767838d5..abe681600ca37 100644 --- a/content/en/cloud_cost_management/tag_explorer/_index.md +++ b/content/en/cloud_cost_management/tags/tag_explorer.md @@ -1,5 +1,7 @@ --- title: Tag Explorer +aliases: + - /cloud_cost_management/tag_explorer description: Search and manage all cost-related tags, including those from your bills, with insights into their sources. further_reading: - link: "/cloud_cost_management/" @@ -14,7 +16,7 @@ further_reading: - link: "/cloud_cost_management/setup/saas_costs" tag: "Documentation" text: "Learn about SaaS Cost Integrations" -- link: "/cloud_cost_management/tag_pipelines" +- link: "/cloud_cost_management/tags/tag_pipelines" tag: "Documentation" text: "Learn about Tag Pipelines" --- @@ -152,7 +154,7 @@ For Twilio tags, select **Twilio** from the dropdown menu on the top right corne [1]: /cloud_cost_management/ [2]: https://app.datadoghq.com/cost/tags -[3]: /cloud_cost_management/tag_pipelines +[3]: /cloud_cost_management/tags/tag_pipelines [4]: /cloud_cost_management/setup/custom [5]: /cloud_cost_management/datadog_costs [6]: /cloud_cost_management/setup/saas_costs diff --git a/content/en/cloud_cost_management/tag_pipelines.md b/content/en/cloud_cost_management/tags/tag_pipelines.md similarity index 96% rename from content/en/cloud_cost_management/tag_pipelines.md rename to content/en/cloud_cost_management/tags/tag_pipelines.md index 0695eba57064f..e607232599ace 100644 --- a/content/en/cloud_cost_management/tag_pipelines.md +++ b/content/en/cloud_cost_management/tags/tag_pipelines.md @@ -1,5 +1,7 @@ --- title: Tag Pipelines +aliases: + - /cloud_cost_management/tag_pipelines/ further_reading: - link: "/cloud_cost_management/" tag: "Documentation" @@ -81,7 +83,7 @@ Certain tags such as `env` and `host` are [reserved tags][4], and are part of [U Using tags helps correlate your metrics, traces, processes, and logs. Reserved tags like `host` provide visibility and effective monitoring across your infrastructure. For optimal correlation and actionable insights, use these reserved tags as part of your tagging strategy in Datadog. ## Delete tags -To delete a tag created using Tag Pipelines, delete the rule that created it. Within 24 hours, the tag will be automatically removed from the most recent three months of data. To remove the tag from older data, request a backfill through [Datadog support][5]. +To delete a tag created using Tag Pipelines, delete the rule that created it. Within 24 hours, the tag is automatically removed from the most recent three months of data. To remove the tag from older data, request a backfill through [Datadog support][5]. ## Further reading From 042779ea383fd41be64f53a1f655cb559bef5c59 Mon Sep 17 00:00:00 2001 From: Rosa Trieu Date: Fri, 18 Jul 2025 15:23:34 -0700 Subject: [PATCH 2/4] consolidate overview --- content/en/cloud_cost_management/tags/_index.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/content/en/cloud_cost_management/tags/_index.md b/content/en/cloud_cost_management/tags/_index.md index b2a4de2b458b7..80004906daeff 100644 --- a/content/en/cloud_cost_management/tags/_index.md +++ b/content/en/cloud_cost_management/tags/_index.md @@ -18,7 +18,11 @@ further_reading: ## Overview -Tags help you organize, filter, and allocate your cloud costs effectively. With proper tagging, you can see exactly who's spending what, identify optimization opportunities, and create accurate chargeback reports. Cloud Cost Management automatically enriches your cost data with tags from multiple sources, so you can focus on using tags to drive insights rather than managing the technical details. +Tags help you organize, filter, and allocate your cloud costs effectively. Cloud Cost Management automatically enriches your cost data with tags from multiple sources, so you can focus on using tags to drive insights rather than managing the technical details. + +- **Track costs by team, service, or environment** - See exactly who's spending what and identify optimization opportunities +- **Allocate shared costs fairly** - Distribute costs across teams and projects for accurate chargeback and showback +- **Create accurate reports** - Generate detailed cost reports for stakeholders and budget planning ## Getting started @@ -30,11 +34,6 @@ Get started with tags in three steps: {{< img src="cloud_cost/tag_explorer/aws_1.png" alt="Tag Explorer interface showing available AWS tags and their usage" style="width:80%;" >}} -## Common scenarios - -- **Track costs by team, service, or environment** - See exactly who's spending what and identify optimization opportunities -- **Allocate shared costs fairly** - Distribute costs across teams and projects for accurate chargeback and showback - ## Where your tags come from Datadog applies tags to cost data using the following sources: From 008d0898025dbeaf71e401a4a9135389469c49e0 Mon Sep 17 00:00:00 2001 From: Rosa Trieu Date: Mon, 21 Jul 2025 11:17:08 -0700 Subject: [PATCH 3/4] remove bullets --- content/en/cloud_cost_management/tags/_index.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/content/en/cloud_cost_management/tags/_index.md b/content/en/cloud_cost_management/tags/_index.md index 80004906daeff..d99e49cc1be93 100644 --- a/content/en/cloud_cost_management/tags/_index.md +++ b/content/en/cloud_cost_management/tags/_index.md @@ -18,11 +18,7 @@ further_reading: ## Overview -Tags help you organize, filter, and allocate your cloud costs effectively. Cloud Cost Management automatically enriches your cost data with tags from multiple sources, so you can focus on using tags to drive insights rather than managing the technical details. - -- **Track costs by team, service, or environment** - See exactly who's spending what and identify optimization opportunities -- **Allocate shared costs fairly** - Distribute costs across teams and projects for accurate chargeback and showback -- **Create accurate reports** - Generate detailed cost reports for stakeholders and budget planning +Tags help you organize, filter, and allocate your cloud costs effectively. Cloud Cost Management automatically enriches your cost data with tags from multiple sources, so you can focus on using tags to drive insights rather than managing the technical details. Using tags, you can allocate shared costs fairly, create accurate reports, and track costs by team, service, or environment. ## Getting started From f20ba5a2df128ac6badbd65c0755343936642f14 Mon Sep 17 00:00:00 2001 From: Rosa Trieu Date: Wed, 23 Jul 2025 11:30:24 -0700 Subject: [PATCH 4/4] remove period for consistency --- content/en/cloud_cost_management/tags/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/cloud_cost_management/tags/_index.md b/content/en/cloud_cost_management/tags/_index.md index d99e49cc1be93..c7cfce3df91da 100644 --- a/content/en/cloud_cost_management/tags/_index.md +++ b/content/en/cloud_cost_management/tags/_index.md @@ -34,7 +34,7 @@ Get started with tags in three steps: Datadog applies tags to cost data using the following sources: -- **[Out-of-the-box tags][1]** - Standardized tags that Datadog automatically generates from some billing data columns (like `aws_product` and `aws_region`) in your cost and usage report. +- **[Out-of-the-box tags][1]** - Standardized tags that Datadog automatically generates from some billing data columns (like `aws_product` and `aws_region`) in your cost and usage report - **[Container allocation tags][2]** - Tags from your container workloads - **[Resource and account tags][3]** - Tags you've applied to your cloud resources - **[Tag pipelines][4]** - Custom rules you create to add missing tags