Settings API - Kubernetes Telemetry Enrichment schema table

  • Published Mar 17, 2025

Kubernetes Telemetry Enrichment (builtin:kubernetes.generic.metadata.enrichment)

Generic metadata enrichment for Kubernetes.

Schema IDSchema groupsScope
builtin:kubernetes.generic.metadata.enrichment
  • group:cloud-and-virtualization
KUBERNETES_CLUSTER - Kubernetes cluster
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:kubernetes.generic.metadata.enrichment
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:kubernetes.generic.metadata.enrichment
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:kubernetes.generic.metadata.enrichment

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
rulesRule[]

Kubernetes Telemetry Enrichment empowers you to effectively tag your telemetry data using Kubernetes labels and annotations. Additionally, it enables you to tag it for cost allocation and permission purposes.

Enrichment Options:

  • Primary Grail Tags: Tag your telemetry data with existing Kubernetes labels or annotations. These will be made available as domain-specific fields (e.g., k8s.namespace.label.your_key). This allows for flexible pipeline routing, bucket selection, segmentation, and filtering.

  • Security Context and Cost Allocation: Leverage existing Kubernetes labels or annotations as the basis for security context or cost allocation. This provides granular control over permissions and facilitates chargeback functionalities.

Additional Information:

  • You can define up to 20 enrichment rules.

  • New rules may take up to 45 minutes to become effective.

  • After the rules are applied, pod restarts are required to ensure the changes take effect.

To learn more, please refer to our documentation.

required
The Rule object
PropertyTypeDescriptionRequired
Metadata type
type		enum
  • ANNOTATION
  • LABEL
required
Source
source		text

The source must follow the syntax of Kubernetes annotation/label keys as defined in the Kubernetes documentation.

source := (prefix/)?name

prefix := a-z0-9 (/[-a-z0-9][a-z0-9])?(\.a-z0-9 (/[-a-z0-9][a-z0-9])?)*

name := ([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9]

Additionally, the name can have at most 63 characters, and the overall length of the source must not exceed 75 characters.

required
Use as Primary Grail Tag
primaryGrailTag		boolean

Uses the key of the annotation or label as field name

optional
Target
target		enum
  • dt.security_context
  • dt.cost.product
  • dt.cost.costcenter
required