Specificationv1.46.0
since v1.45.00 breaking12 notable17 editorial
From the upstream release notes
- Prometheus receiver can expect otel_scope_schema_url and otel_scope_[attribute] labels on all metrics.
- Prometheus receiver no longer expects otel_scope_info metric.
- Prometheus exporter adds otel_scope_schema_url and otel_scope_[attribute] labels on all metrics.
- Prometheus exporter no longer exports otel_scope_info metric.
- Define rules for setting identifying attributes.
- Define rules for entity-resource referencing model.
- Move Instrumentation Scope definition from glossary to a dedicated document and use normative language.
Notable12
- rule droppedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scopeMUST removed: Labels on
otelscopeinfometric points other thanotelscopenameandotelscopeversion, MUST be added as scope attributes to the scope with the matching name and version. - rule droppedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scope-1MUST removed: Scope attributes MUST also be added as labels following the rules described in the
Metric Attributessection below. - rule droppedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scope-1MUST removed: Prometheus exporters MUST add the scope name as the
otelscopenamelabel and the scope version as theotelscopeversionlabel on all metric points by default, based on the scope the original data point was nested in. - strengthrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scopeSHOULD strengthened to MUST: Labels with
otelscopeprefix MUST be dropped from all metric points and used as the Instrumentation Scope name (otelscopename), version (otelscopeversion), schema URL (otelscopeschemaurl), at... - new rulerequirementcommon/instrumentation-scope.md#instrumentation-scopeSHOULD added: This tuple SHOULD uniquely identify the logical unit of software that emits the telemetry.
- new rulerequirementcommon/instrumentation-scope.md#instrumentation-scopeSHOULD added: The instrumentation scope's name SHOULD be specified to identify the
InstrumentationScopename. - new rulerequirementcommon/instrumentation-scope.md#instrumentation-scopeSHOULD added: The instrumentation scope's optional Schema URL SHOULD identify the Telemetry Schema that the instrumentation's emitted telemetry conforms to.
- new rulerequiremententities/data-model.md#identifying-attributesMUST added: OpenTelemetry Semantic Conventions MUST define a set of identifying attribute keys for every defined entity type.
- new rulerequiremententities/data-model.md#identifying-attributesMUST added: Two independent observers that report the same entity MUST be able to supply identical values for all identifying attributes.
- new rulerequiremententities/data-model.md#identifying-attributesMUST NOT added: If an observer cannot reliably obtain one or more identifying attributes, it MUST NOT emit telemetry using that entity type.
- new rulerequiremententities/data-model.md#placement-of-shared-descriptive-attributesMUST added: If multiple entities share the same descriptive attribute key with potentially conflicting values, the attribute MUST logically belong to only one of them.
- new rulerequiremententities/data-model.md#placement-of-shared-descriptive-attributesMUST added: The attribute MUST be referenced by the most specific entity, the one closest in the topology graph to the entity associated with the telemetry signal.
Editorial17
- removedsectionspecification/glossary.md#instrumentation-scopeSection "Instrumentation Scope" removed.
- rule droppedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scopeSHOULD removed: All
otelscopeinfometrics present in a batch of metrics SHOULD be dropped from the incoming scrape. - rule droppedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scope-1SHOULD removed: Prometheus exporters SHOULD generate an Info-typed metric named
otelscopeinfofor each Instrumentation Scope with non-empty scope attributes. - rule droppedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scope-1SHOULD removed: Prometheus exporters SHOULD provide a configuration option to disable the
otelscopeinfometric andotelscopelabels. - new rulerequiremententities/data-model.md#identifying-attributesSHOULD added: Names of the identifying attributes SHOULD use the entity type as a prefix to avoid collisions with other entity types.
- new rulerequiremententities/data-model.md#identifying-attributesSHOULD added: Instead, it SHOULD:
- new rulerequiremententities/data-model.md#placement-of-shared-descriptive-attributesSHOULD NOT added: All others SHOULD NOT reference it.
- rewordedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scopeMUST reworded: Metrics which do not have any label with
otelscopeprefix MUST be assigned an instrumentation scope identifying the entity performing the translation from Prometheus to OpenTelemetry (e.g. the coll... - rewordedrequirementcompatibility/prometheus_and_openmetrics.md#instrumentation-scope-1MUST reworded: Prometheus exporters MUST by default add the scope name as the
otelscopenamelabel, the scope version as theotelscopeversionlabel, the scope schema URL as theotelscopeschemaurllabel, the sc... - rewordedrequirementsdk_exporters/prometheus.md#configurationMAY reworded: A Prometheus Exporter MAY support a configuration option to produce metrics without scope labels.
- addeddocumentcommon/instrumentation-scope.mdNew document: Instrumentation Scope (Stable).
- addedsectionentities/data-model.md#attribute-referencing-modelNew section "Attribute Referencing Model".
- addedsectionentities/data-model.md#identifying-attributesNew section "Identifying Attributes".
- addedsectionentities/data-model.md#placement-of-shared-descriptive-attributesNew section "Placement of Shared Descriptive Attributes".
- addedsectionentities/data-model.md#resource-and-entitiesNew section "Resource and Entities".
- rewrittensectioncompatibility/prometheus_and_openmetrics.md#instrumentation-scope"Instrumentation Scope" substantially rewritten (774 to 490 characters).
- rewrittensectioncompatibility/prometheus_and_openmetrics.md#instrumentation-scope-1"Instrumentation Scope" substantially rewritten (849 to 434 characters).