Skip to content

[spec] [entities] Mention entity references in the stability guarantees#4593

Merged
reyang merged 2 commits intoopen-telemetry:mainfrom
dmitryax:guarantees-for-entity-type
Aug 6, 2025
Merged

[spec] [entities] Mention entity references in the stability guarantees#4593
reyang merged 2 commits intoopen-telemetry:mainfrom
dmitryax:guarantees-for-entity-type

Conversation

@dmitryax
Copy link
Member

Since an entity’s type is part of its identity, we should define stability guarantees for it, considering that the identifying attributes are already covered by resource attribute guarantees.

Fixes #4451

Given that type of an entity is a part of it's identity, we should define stability guarantees for that given that identifying attributes already covered by the guarantees for the resource attributes.
@dmitryax dmitryax requested review from a team July 17, 2025 03:37
@github-actions
Copy link

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@github-actions github-actions bot added the Stale label Jul 25, 2025
@carlosalberto
Copy link
Contributor

@jsuereth Would you like to get anybody else to review this, or we merge it?

@github-actions github-actions bot removed the Stale label Jul 29, 2025
Copy link
Member

@dyladan dyladan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

aside: the section this is in says "Semantic Conventions defines the set of fields in the OTLP data model." Should this say "Semantic Conventions defines the set of stable fields in the OTLP data model?" (added word stable). SemConv also defines other things, they're just not guaranteed stability (attr value for example).

@github-actions
Copy link

github-actions bot commented Aug 6, 2025

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@github-actions github-actions bot added the Stale label Aug 6, 2025
@dyladan
Copy link
Member

dyladan commented Aug 6, 2025

I think this can be merged?

@reyang reyang enabled auto-merge August 6, 2025 16:14
@reyang reyang added this pull request to the merge queue Aug 6, 2025
Merged via the queue into open-telemetry:main with commit 10acd40 Aug 6, 2025
5 of 6 checks passed
@carlosalberto carlosalberto mentioned this pull request Aug 11, 2025
github-merge-queue bot pushed a commit that referenced this pull request Aug 13, 2025
August 2025 release.

### Logs

- Improve concurrency safety description of `LogRecordProcessor.OnEmit`.

([#4578](#4578))
- Clarify that `SeverityNumber` values are used when comparing
severities.

([#4552](#4552))

### Entities

- Mention entity references in the stability guarantees.

([#4593](#4593))

### OpenTelemetry Protocol

- Clarify protocol defaults on specification.

([#4585](#4585))

### Compatibility

- Flexibilie escaping of characters that are discouraged by Prometheus
Conventions
  in Prometheus exporters.

([#4533](#4533))
- Flexibilize addition of unit/type related suffixes in Prometheus
exporters.

([#4533](#4533))
- Define the configuration option "Translation Strategies" for
Prometheus exporters.

([#4533](#4533))
- Define conversion of Prometheus native histograms to OpenTelemetry
exponential histograms.

([#4561](#4561))
- Clarify what to do when scope attribute conflicts with name, version
and schema URL.

([#4599](#4599))

### SDK Configuration

- Enum values provided via environment variables SHOULD be interpreted
in a case-insensitive manner.

([#4576](#4576))

Co-authored-by: Armin Ruech <7052238+arminru@users.noreply.github.com>
@dmitryax dmitryax deleted the guarantees-for-entity-type branch January 12, 2026 01:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update resource model in versioning and stability specification.

6 participants