New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[CCA-443] add Custom allocation rules docs #27499

Open

ashleyyip wants to merge 8 commits into master from ashley.yip/dynamic-cost-allocation-docs

ashleyyip commented Feb 7, 2025 •

edited

Loading

What does this PR do? What is the motivation?

Merge instructions

Merge readiness:

Ready for merge

Merge queue is enabled in this repo. To have it automatically merged after it receives the required reviews, create the PR (from a branch that follows the <yourname>/description naming convention) and then add the following PR comment:

/merge

Additional notes

Contributor

github-actions bot commented Feb 7, 2025 •

edited

Loading

Preview links (active after the `build_preview` check completes)

New or renamed files

https://docs-staging.datadoghq.com/ashley.yip/dynamic-cost-allocation-docs/cloud_cost_management/custom_allocation_rules/

github-actions bot added Architecture Images labels

ashleyyip force-pushed the ashley.yip/dynamic-cost-allocation-docs branch 3 times, most recently from a94eff4 to a7f8e7d Compare

February 10, 2025 15:47

ashleyyip marked this pull request as ready for review

February 12, 2025 20:30

ashleyyip requested a review from a team as a code owner

February 12, 2025 20:30

buraizu requested changes

View reviewed changes

Contributor

buraizu left a comment

Thanks for the PR! This looks good overall, just requesting some minor updates.

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated


		## Overview

		Custom cost allocation allows you to showback or chargeback your costs by attributing selected costs to relevant business dimensions. Once you have set up allocation rules, you can report on which costs were allocated by a rule.

Contributor

buraizu Feb 12, 2025

Suggested change

      
            Custom cost allocation allows you to showback or chargeback your costs by attributing selected costs to relevant business dimensions. Once you have set up allocation rules, you can report on which costs were allocated by a rule. 
          
            Custom cost allocation allows you to showback or chargeback your costs by attributing selected costs to relevant business dimensions. After you have set up allocation rules, you can report on which costs were allocated by a rule.

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated


		Custom cost allocation allows you to showback or chargeback your costs by attributing selected costs to relevant business dimensions. Once you have set up allocation rules, you can report on which costs were allocated by a rule.

		Custom cost allocation follows Tag Pipelines, enabling allocations based on user-defined tags. Costs are allocated on a daily basis, and can be applied to Cloud Cost metrics from AWS, GCP, and Azure.

Contributor

buraizu Feb 12, 2025

Suggested change

      
            Custom cost allocation follows Tag Pipelines, enabling allocations based on user-defined tags. Costs are allocated on a daily basis, and can be applied to Cloud Cost metrics from AWS, GCP, and Azure. 
          
            Custom cost allocation follows Tag Pipelines, enabling allocations based on user-defined tags. Costs are allocated on a daily basis, and can be applied to Cloud Cost metrics from AWS, Google Cloud, and Azure.

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated

+              ### Specify what costs are included in the allocation
+              | Step | Required | Examples |
+              | ---- | ---- | ---- |
+              | Cost Provider | Yes | AWS, GCP, Azure |

Contributor

buraizu Feb 12, 2025

Suggested change

      
            | Cost Provider | Yes | AWS, GCP, Azure |
          
            | Select the cost provider | Yes | AWS, Google Cloud, Azure |

Contributor

buraizu Feb 12, 2025

Suggesting to update the step's name to match how it's shown in the UI, which seems to be the pattern followed for other steps. This is also helpful for those using screen readers, as it can reduce ambiguity about what's being referenced

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated

+              | Define the destination | Yes | `team` is `teamA`, `teamB`, `teamC` |
+              | Filter by | Only applicable for Proportional and Even strategies, optional | `aws_product` is `ec2` |
+              | Partition costs by | Only applicable for Proportional and Even strategies, optional | `environment` is all values |
+              | Rule Name | Yes | allocate\_untagged\_support\_costs |

Contributor

buraizu Feb 12, 2025

Suggested change

      
            | Rule Name | Yes | allocate\_untagged\_support\_costs |
          
            | Name | Yes | allocate\_untagged\_support\_costs |

Contributor

buraizu Feb 12, 2025

As above, suggesting this update for an exact match with the UI

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated


		## Rule creation

		Access the Custom Allocation Rules section under [Cloud Cost settings][1] to establish rules. Choose from the following allocation methods:

Contributor

buraizu Feb 12, 2025

Suggested change

      
            Access the Custom Allocation Rules section under [Cloud Cost settings][1] to establish rules. Choose from the following allocation methods:
          
            Access the [Custom Allocation Rules section][1] under Cloud Cost settings to establish rules. Choose from the following allocation methods:

Contributor

buraizu Feb 12, 2025

Suggesting this update since the link leads directly to the Custom Allocation Rules section

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated

+              | Rule Name | Yes | allocate\_untagged\_support\_costs |
+              ## Managing rules
+              Rules can be modified and deleted in the Custom Allocation Rules section of the Cloud Cost settings page. All fields except for the rule name can be reconfigured.

Contributor

buraizu Feb 12, 2025

Suggested change

      
            Rules can be modified and deleted in the Custom Allocation Rules section of the Cloud Cost settings page. All fields except for the rule name can be reconfigured.
          
            Rules can be modified and deleted in the [Custom Allocation Rules section][1] of the Cloud Cost settings page. All fields except for the rule name can be reconfigured.

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated

+              Rules are applied in the same order as shown in the list.
+              ## Visualize your allocations
+              Changes to dynamic allocation rules may take up to 24 hours to be applied. Once applied, the new allocations can be seen throughout the Cloud Cost product. Dynamically allocated costs also include an `allocated_by_rule` tag, denoting the rule name that applied the allocation.

Contributor

buraizu Feb 12, 2025

Suggested change

      
            Changes to dynamic allocation rules may take up to 24 hours to be applied. Once applied, the new allocations can be seen throughout the Cloud Cost product. Dynamically allocated costs also include an `allocated_by_rule` tag, denoting the rule name that applied the allocation.
          
            Changes to dynamic allocation rules may take up to 24 hours to be applied. After being applied, the new allocations can be seen throughout Cloud Cost Management. Dynamically allocated costs also include an `allocated_by_rule` tag, denoting the rule name that applied the allocation.

Contributor

buraizu Feb 12, 2025

Per the documentation style guide

content/en/cloud_cost_management/custom_allocation_rules/_index.md


		{{< img src="cloud_cost/custom_allocation_rules/visualize_your_allocations.png" alt="See your allocations throughout the Datadog product" style="width:90%;" >}}

Contributor

buraizu Feb 12, 2025

Suggested change

      
            ## Further reading
          
            {{< partial name="whats-next/whats-next.html" >}}

Contributor

buraizu Feb 12, 2025

This is required to render the Further reading section

alextmeyer reviewed

View reviewed changes

content/en/cloud_cost_management/custom_allocation_rules/_index.md Outdated


		Custom cost allocation allows you to showback or chargeback your costs by attributing selected costs to relevant business dimensions. Once you have set up allocation rules, you can report on which costs were allocated by a rule.

		Custom cost allocation follows Tag Pipelines, enabling allocations based on user-defined tags. Costs are allocated on a daily basis, and can be applied to Cloud Cost metrics from AWS, GCP, and Azure.

Contributor

alextmeyer Feb 12, 2025

Did we not end up supporting allocation by month in the UI?

ashleyyip force-pushed the ashley.yip/dynamic-cost-allocation-docs branch from 34343e3 to 45d8870 Compare

February 19, 2025 18:36

ashleyyip added 8 commits

February 19, 2025 14:22


          add dynamic cost allocation docs

aa5413d


          update doc and add images

ecc7bd6


          address comments

07152bf


          add visualize allocations ui

835633a


          update wording and diagrams

a77a7ba


          address PR comments

9b8872e


          address PR comments

3b5ec21


          fix typo

fdbbc34

ashleyyip force-pushed the ashley.yip/dynamic-cost-allocation-docs branch from 45d8870 to fdbbc34 Compare

February 19, 2025 19:22

buraizu approved these changes

View reviewed changes

Contributor

buraizu left a comment

Thanks for applying those changes, LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Images