Primary Grail Fields

  • Reference
  • Published Nov 18, 2025

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.).

AttributeTypeDescriptionExamples
aws.account.idstringresource stable
The 12-digit number, such as 123456789012, that uniquely identifies an AWS account.
Tags: permission primary-field
123456789012
aws.regionstringresource stable
A specific geographical AWS Cloud location.
Tags: primary-field
us-east-1
azure.locationstringresource stable
A specific geographical location of Azure Cloud resource.
Tags: primary-field
westeurope
azure.resource.groupstringresource stable
A resource group is a container that holds related resources for an Azure solution.
Tags: permission primary-field
demo-backend-rg
azure.subscriptionstringresource stable
An Azure subscription is a logical container used to provision resources in Azure.
Tags: permission primary-field
27e9b03f-04d2-2b69-b327-32f433f7ed21
dt.host_group.idstringresource stable
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
gcp.project.idstringresource stable
Identifier of the GCP project associated with this resource.
Tags: permission primary-field
dynatrace-gcp-extension
gcp.regionstringresource experimental
A region is a specific geographical location where you can host your resources.
Tags: primary-field
europe-west3
k8s.cluster.namestringresource stable
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.namestringresource stable
The name of the namespace that the pod is running in.
Tags: permission primary-field
default; kube-system