Try it free

Primary Grail fields

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

AttributeTypeDescriptionExamples

aws.account.id

string

resource stableThe 12-digit number, such as 123456789012, that uniquely identifies an AWS account.Tags: permission primary-field

123456789012

aws.region

string

resource stableA specific geographical AWS Cloud location.Tags: primary-field

us-east-1

azure.location

string

resource stableA specific geographical location of Azure cloud resource.Tags: primary-field

westeurope

azure.resource.group

string

resource stableA resource group is a container that holds related resources for an Azure solution.Tags: permission primary-field

demo-backend-rg

azure.subscription

string

resource stableAn Azure subscription is a logical container used to provision resources in Azure.Tags: permission primary-field

27e9b03f-04d2-2b69-b327-32f433f7ed21

dt.host_group.id

string

resource stableSee 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.id

string

resource stableIdentifier of the GCP project associated with this resource.Tags: permission primary-field

dynatrace-gcp-extension

gcp.region

string

resource stableA region is a specific geographical location where you can host your resources.Tags: primary-field

europe-west3

k8s.cluster.name

string

resource stableThe 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 stableThe name of the namespace that the pod is running in.Tags: permission primary-field

default; kube-system