Settings API - OpenTelemetry metrics schema table

OpenTelemetry metrics (builtin:opentelemetry-metrics)

Configure how OpenTelemetry metrics are ingested into Dynatrace via the OTLP endpoint.

Notes:

  • Changes made to these settings only apply to newly ingested data points. Data points that are already stored in Dynatrace will not change.

  • For OpenTelemetry trace/span settings, navigate to: Settings > Server-side service monitoring.

Schema IDSchema groupsScope
builtin:opentelemetry-metrics
  • group:metrics
environment
environment-default
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:opentelemetry-metrics
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:opentelemetry-metrics
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:opentelemetry-metrics

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
Add Meter name and version as metric dimensions
meterNameToDimensionEnabled		boolean

When enabled, the Meter name (also referred to as InstrumentationScope or InstrumentationLibrary in OpenTelemetry SDKs) and version will be added as dimensions (otel.scope.name and otel.scope.version) to ingested OTLP metrics.

Note: Modifying this setting will cause the metric to change. This may have an impact on existing dashboards, events and alerts that make use of these dimensions. In this case, they will need to be updated manually.

required
Add the resource and scope attributes configured below as dimensions
additionalAttributesToDimensionEnabled		boolean-required
additionalAttributesSet<AdditionalAttributeItem>

When enabled, the attributes defined in the list below will be added as dimensions to ingested OTLP metrics if they are present in the OpenTelemetry resource or in the instrumentation scope.

Notes:

  • Attributes must be added in their original format, as exported to Dynatrace by the telemetry source. For example, if the attribute is in PascalCase, the same case must be used when adding the attribute to the list.

  • Modifying this setting (renaming, disabling or removing attributes) will cause the metric to change. This may have an impact on existing dashboards, events and alerts that make use of these dimensions. In this case, they will need to be updated manually.

  • Dynatrace does not recommend changing/removing the attributes starting with "dt.". Dynatrace leverages these attributes to Enrich metrics.

required
toDropAttributesSet<DropAttributeItem>

The attributes defined in the list below will be dropped from all ingested OTLP metrics.

Upon ingest, the Allow list: resource and scope attributes above is applied first. Then, the Deny list: all attributes below is applied. The deny list therefore applies to all attributes from all sources (data points, scope and resource).

Notes:

  • Attributes must be added in their original format, as exported to Dynatrace by the telemetry source. For example, if the attribute is in PascalCase, the same case must be used when adding the attribute to the list.

  • Modifying this setting (adding, renaming, disabling or removing attributes) will cause the metric to change. This may have an impact on existing dashboards, events and alerts that make use of these dimensions. In this case, they will need to be updated manually.

  • Dynatrace does not recommend including attributes starting with "dt." to the deny list. Dynatrace leverages these attributes to Enrich metrics.

required
The AdditionalAttributeItem object
PropertyTypeDescriptionRequired
Enabled
enabled		boolean

When enabled, the attribute will be added as a dimension to ingested metrics if present in the OpenTelemetry resource or in the instrumentation scope.

required
Attribute key
attributeKey		text-required
The DropAttributeItem object
PropertyTypeDescriptionRequired
Enabled
enabled		boolean

When enabled, the attribute will be dropped on all ingested metrics.

required
Attribute key
attributeKey		text-required