Try it free

Settings API - Ingest Enrichment Configuration schema table

  • Published Aug 10, 2026

Ingest Enrichment Configuration (builtin:ingest.enrichment.config)

Map labels, annotations, tags and resource properties from your existing infrastructure to primary Grail tags and fields. Learn more in our documentation.

Schema IDSchema groupsScope
builtin:ingest.enrichment.config
  • group:preferences
HOST - Host
KUBERNETES_CLUSTER - Kubernetes cluster
HOST_GROUP - Host Group
AWS_ACCOUNT
AZURE_MICROSOFT_RESOURCES_SUBSCRIPTIONS
GCP_PROJECT
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:ingest.enrichment.config
GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:ingest.enrichment.config
GETEnvironment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:ingest.enrichment.config

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
Type
type
enum

Defines the enrichment type for this rule.

The element has these enums
  • K8S_NAMESPACE_LABEL
  • K8S_NAMESPACE_ANNOTATION
  • K8S_WORKLOAD_LABEL
  • K8S_WORKLOAD_ANNOTATION
  • K8S_POD_LABEL
  • K8S_POD_ANNOTATION
  • AWS_TAG
  • GCP_LABEL
  • GCP_TAG
  • AZURE_TAG
  • HOST_PROCESS_PROPERTY
  • CUSTOM
Required
Value source
valueSource
text

Defines the value source for the enrichment. Depending on the enrichment type, this is a key (for Kubernetes labels/annotations, cloud tags/labels, and host process properties) or a literal (for type 'Custom').

Required
Value extraction
valueExtraction
text

An optional DPL expression to extract the enrichment value. This is only allowed when the enrichment type is set to 'Host/process property'.

Optional
Target
target
text

The field or tag to populate with the source value.

Required
Condition
condition
text

Optional DQL condition to filter signals.

Optional