Try it free

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

AttributeTypeDescriptionExamples
aws.account.idstringresource 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.regionstringresource stable
Display name: AWS region
A specific geographical AWS Cloud location.
Tags: primary-field
us-east-1
azure.locationstringresource stable
Display name: Azure location
A specific geographical location of Azure cloud resource.
Tags: primary-field
westeurope
azure.resource.groupstringresource 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.subscriptionstringresource 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_productstringresource stable
Display name: Product
The product that the deployable unit belongs to: a logical group of services, APIs, and data stores that together deliver one business capability or user-facing function.
Tags: primary-field
astroshop; mobile-banking-backend; product-search-discovery
deployment.release_stagestringresource stable
Display name: Stage
The name of the deployment environment that the deployable unit producing this data runs in, for example, a stage of the delivery pipeline.
Tags: primary-field
development; hardening; production
deployment.release_versionstringresource stable
Display name: Version
The version string of the deployable unit, such as a service, application, or function, that produced this data. The format is not prescribed.
Tags: primary-field
1.4.1; 2.5.1-beta
dt.host_group.idstringresource 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.spacestringresource 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.idstringresource stable
Display name: GCP project ID
Identifier of the GCP project associated with this resource.
Tags: permission primary-field
dynatrace-gcp-extension
gcp.regionstringresource 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.namestringresource 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.namestringresource stable
Display name: Kubernetes namespace name
The name of the namespace that the pod is running in.
Tags: permission primary-field
default; kube-system