Monitor usage using cluster and pool tags
To monitor cost and accurately attribute Databricks usage to your organization’s business units and teams (for chargebacks, for example), you can tag clusters and pools.
These tags propagate to detailed downloadable DBU usage reports for cost analysis.
Note
The Databricks billable usage graphs in the account console do not aggregate usage by tags but billable usage downloaded CSV reports from the same page include default and custom tags. Tags do not propagate to the clusters that you view in the Google Cloud console, but you can use custom and default tags for Google GKE usage metering
Tagged objects and resources
You can add custom tags for the following objects managed by Databricks:
Object |
Tagging interface (UI) |
Tagging interface (API) |
---|---|---|
Pool |
Pool UI in the Databricks workspace |
|
Cluster |
Cluster UI in the Databricks workspace |
Databricks adds the following default tags to all pools and clusters:
Pool tag key name |
Value |
---|---|
|
Constant “Databricks” |
|
Databricks internal identifier of the user who created the pool |
|
Databricks internal identifier of the pool |
Cluster tag key name |
Value |
---|---|
|
Constant “Databricks” |
|
Databricks internal identifier of the cluster |
|
Name of the cluster |
|
Username (email address) of the user who created the cluster |
On job clusters, Databricks also applies the following default tags:
Cluster tag key name |
Value |
---|---|
|
Job name |
|
Job ID |
Tag propagation
Tags are propagated to node instances differently depending on whether or not a cluster was created from a pool.

If a cluster is created from a pool, its instances inherit only the custom and default pool tags, not the cluster tags. Therefore if you want to create clusters from a pool, make sure to assign all of the custom cluster tags you need to the pool.
If a cluster is not created from a pool, its tags propagate as expected to node instances.
Cluster and pool tags both propagate to DBU usage reports in the the downloaded reports, whether or not the cluster was created from a pool.
If there is a tag name conflict, Databricks default tags take precedence over custom tags and pool tags take precedence over cluster tags.