Primary Grail fields

Latest Dynatrace
Reference
Published May 07, 2026

Primary Grail fields are commonly used to:

Route telemetry
Serve as input to data processing rules
Filter telemetry
Define permissions

If applicable, they should be present on all data (spans, logs, metrics, events, Smartscape topology, etc.).

Attribute	Type	Description	Examples
`aws.account.id`	string	resource stable Display name: `AWS account ID` The 12-digit number, such as 123456789012, that uniquely identifies an AWS account. Tags: `permission` `primary-field`	`123456789012`
`aws.region`	string	resource stable Display name: `AWS region` A specific geographical AWS Cloud location. Tags: `primary-field`	`us-east-1`
`azure.location`	string	resource stable Display name: `Azure location` A specific geographical location of Azure cloud resource. Tags: `primary-field`	`westeurope`
`azure.resource.group`	string	resource stable Display name: `Azure resource group` A resource group is a container that holds related resources for an Azure solution. Tags: `permission` `primary-field`	`demo-backend-rg`
`azure.subscription`	string	resource stable Display name: `Azure subscription` An Azure subscription is a logical container used to provision resources in Azure. Tags: `permission` `primary-field`	`27e9b03f-04d2-2b69-b327-32f433f7ed21`
`deployment.release_product`	string	resource stable Display name: `Release product` A logical group of interconnected microservices, APIs, and databases that work together to deliver a single business capability or product. It acts as an architectural boundary, mapping how individual technical pieces cooperate to provide a complete user-facing function. Software catalogs (like Backstage) use this concept to abstract away raw codebases and give teams high-level visibility into a product's entire ecosystem. Tags: `primary-field`	`astroshop`; `developer-self-service`; `mobile-banking-backend`; `product-search-discovery`
`deployment.release_stage`	string	resource stable Display name: `Stage` The deployment environment that the deployable unit producing this data is running in, for example, a stage of your delivery pipeline. Tags: `primary-field`	`production`
`deployment.release_version`	string	resource stable Display name: `Version` The version of the deployable unit—such as a service, application, or function—that produced this data. Tags: `primary-field`	`0.4.1`
`dt.host_group.id`	string	resource stable Display name: `Host group ID` See Organize your environment using host groups. Note that host groups are identified by their name, not by the entity ID of the host group entity. For details on the entity ID, see `dt.entity.host_group`. Tags: `permission` `primary-field`	`myHostGroup`
`dt.space`	string	resource experimental Display name: `Space` The space associated with the record. Spaces enable granular scoping and delegation of monitoring responsibilities. Tags: `permission` `primary-field`
`gcp.project.id`	string	resource stable Display name: `GCP project ID` Identifier of the GCP project associated with this resource. Tags: `permission` `primary-field`	`dynatrace-gcp-extension`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`
`k8s.cluster.name`	string	resource stable Display name: `Kubernetes cluster name` The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable. Tags: `permission` `primary-field`	`unguard-dev`; `acme-prod10`
`k8s.namespace.name`	string	resource stable Display name: `Kubernetes namespace name` The name of the namespace that the pod is running in. Tags: `permission` `primary-field`	`default`; `kube-system`

Primary Grail fields

Latest Dynatrace

Reference

Published May 07, 2026

Primary Grail fields are commonly used to:

Route telemetry
Serve as input to data processing rules
Filter telemetry
Define permissions

If applicable, they should be present on all data (spans, logs, metrics, events, Smartscape topology, etc.).

Attribute	Type	Description	Examples
`aws.account.id`	string	resource stable Display name: `AWS account ID` The 12-digit number, such as 123456789012, that uniquely identifies an AWS account. Tags: `permission` `primary-field`	`123456789012`
`aws.region`	string	resource stable Display name: `AWS region` A specific geographical AWS Cloud location. Tags: `primary-field`	`us-east-1`
`azure.location`	string	resource stable Display name: `Azure location` A specific geographical location of Azure cloud resource. Tags: `primary-field`	`westeurope`
`azure.resource.group`	string	resource stable Display name: `Azure resource group` A resource group is a container that holds related resources for an Azure solution. Tags: `permission` `primary-field`	`demo-backend-rg`
`azure.subscription`	string	resource stable Display name: `Azure subscription` An Azure subscription is a logical container used to provision resources in Azure. Tags: `permission` `primary-field`	`27e9b03f-04d2-2b69-b327-32f433f7ed21`
`deployment.release_product`	string	resource stable Display name: `Release product` A logical group of interconnected microservices, APIs, and databases that work together to deliver a single business capability or product. It acts as an architectural boundary, mapping how individual technical pieces cooperate to provide a complete user-facing function. Software catalogs (like Backstage) use this concept to abstract away raw codebases and give teams high-level visibility into a product's entire ecosystem. Tags: `primary-field`	`astroshop`; `developer-self-service`; `mobile-banking-backend`; `product-search-discovery`
`deployment.release_stage`	string	resource stable Display name: `Stage` The deployment environment that the deployable unit producing this data is running in, for example, a stage of your delivery pipeline. Tags: `primary-field`	`production`
`deployment.release_version`	string	resource stable Display name: `Version` The version of the deployable unit—such as a service, application, or function—that produced this data. Tags: `primary-field`	`0.4.1`
`dt.host_group.id`	string	resource stable Display name: `Host group ID` See Organize your environment using host groups. Note that host groups are identified by their name, not by the entity ID of the host group entity. For details on the entity ID, see `dt.entity.host_group`. Tags: `permission` `primary-field`	`myHostGroup`
`dt.space`	string	resource experimental Display name: `Space` The space associated with the record. Spaces enable granular scoping and delegation of monitoring responsibilities. Tags: `permission` `primary-field`
`gcp.project.id`	string	resource stable Display name: `GCP project ID` Identifier of the GCP project associated with this resource. Tags: `permission` `primary-field`	`dynatrace-gcp-extension`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`
`k8s.cluster.name`	string	resource stable Display name: `Kubernetes cluster name` The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable. Tags: `permission` `primary-field`	`unguard-dev`; `acme-prod10`
`k8s.namespace.name`	string	resource stable Display name: `Kubernetes namespace name` The name of the namespace that the pod is running in. Tags: `permission` `primary-field`	`default`; `kube-system`