Configure Cost Allocation for OneAgent

Latest Dynatrace
How-to guide
5-min read
Published Mar 31, 2025

For OneAgent deployments, Cost Allocation is configured on hosts via host tags.

This section describes how to configure a OneAgent for Cost Allocation. For background information about Cost Allocation, see Allocate your DPS costs.

Add host tags

OneAgent version 1.291+

When you install OneAgent on a new host, you can use tags to add this host to an existing host group.

In the Install OneAgent page, go to Optional parameters > Tags.
Select Add tag.
1. Enter the Key and Value as appropriate:
  - The key is either dt.cost.costcenter or dt.cost.product.
  - The value is the name of the cost center or product. You've already defined cost centers and hosts in Identify allowed cost centers and products.
2. Select Add.
Continue to install OneAgent.

OneAgent version 1.291+

oneagentctl is a Dynatrace script that performs post-installation OneAgent configuration at the individual host level. You can use it to add or change host tags.

Identify allowed cost centers and products.
Execute oneagentctl with the --set-host-tag option. This option has two forms:
- To set the cost center: --set-host-tag=dt.cost.costcenter=<cost-center>
- To set the product: --set-host-tag=dt.cost.product=<product>
Verify that host tags are set. Use the --get-host-tags and --get-host-properties commands and review the output.
Restart OneAgent with the --restart-service command.

OneAgent version 1.291+

To configure host tags within the Dynatrace web UI, go to Deployment Status Deployment Status > OneAgents.

Select all OneAgent deployments that should be configured with the same host tag.
Select the modify host properties action from the list in the lower-left corner. The Modify host properties page opens:
1. Select Specify host properties to be added or Specify host properties to be removed, as appropriate.
2. Add or modify the relevant dt.cost.costcenter or dt.cost.product.
3. Select Next.
4. Select Apply changes.

Once the changes are applied, the relevant OneAgent deployment is automatically triggered to restart.

OneAgent version 1.291+

You can create a script to automate adding cost center and product allocation host tags.

The code blocks below provide the script for Linux and Windows OS.

Linux:

COSTCENTER=<cost-center>
PRODUCT=<product>

/opt/dynatrace/oneagent/agent/tools/oneagentctl --set-host-tag=dt.cost.costcenter="${COSTCENTER}" --set-host-tag=dt.cost.product="${PRODUCT}" --restart-service

Windows:

COSTCENTER=<cost-center>
PRODUCT=<product>

%PROGRAMFILES%\dynatrace\oneagent\agent\tools\oneagentctl.exe --set-host-tag=dt.cost.costcenter="${COSTCENTER}" --set-host-tag=dt.cost.product="${PRODUCT}" --restart-service

To use this script:

Save the contents to a script file on the host where OneAgent is deployed.
Modify the placeholder values of COSTCENTER and PRODUCT as appropriate.
On the host, execute the script with administrator (root) privileges.
Restart OneAgent.

OneAgent version 1.291+

OneAgent host tags can be added via the API, see OneAgent remote configuration management API - POST a configuration job. The API call consists of two parameters:

body: Provide the JSON body of the request. Within the JSON body, define a remote configuration management operation with the following information:
- Attribute: Use hostTag to modify a host tag.
- operation: Use set to write the tag.
- value:
  - Use dt.cost.costcenter=<cost center> to add a cost center.
  - Use dt.cost.product=<product> to add a product.
See Request body JSON model for examples of the JSON file.
restart: Instruct the OneAgent to restart. Set the value to true.

Modify host tags

Past tracked consumption cannot be changed or reassigned. If you modify host tags, all existing data about already-recorded costs (related to that host tag and that host) will be lost.

Before you reassign existing host tags, you might want to export the existing data via the Dynatrace Platform Subscription API - GET cost allocation.

Before changing the values for dt.cost.costcenter or dt.cost.product, add or remove the target values in the Cost Allocation allow lists. This will ensure that no usage values are unassigned during the transition.

Note that updates to the allow list will take a couple of minutes to go into effect.

OneAgent version 1.291+

To modify existing tags, follow the steps in Add host tags. The new values will overwrite the existing values.

Remove host tags

Removing host tags is irreversible. If you modify host tags, all existing data about already-recorded costs (related to that host tag and that host) will be lost.

Configure Cost Allocation for OneAgent

Add host tags

Modify host tags

Remove host tags

Related topics