Skip to content

Create an entity modelling guide#2328

Merged
jsuereth merged 20 commits intoopen-telemetry:mainfrom
jsuereth:wip-entity-modelling-guide
Jun 23, 2025
Merged

Create an entity modelling guide#2328
jsuereth merged 20 commits intoopen-telemetry:mainfrom
jsuereth:wip-entity-modelling-guide

Conversation

@jsuereth
Copy link
Copy Markdown
Contributor

@jsuereth jsuereth commented Jun 6, 2025

Fixes #2246

Changes

  • Creates new "how to write conventions" section in non-normative guidance
  • Adds "resource and entity" guidance to this section.

Please provide a brief description of the changes here.

Note: if the PR is touching an area that is not listed in the existing areas, or the area does not have sufficient domain experts coverage, the PR might be tagged as experts needed and move slowly until experts are identified.

Merge requirement checklist

@jsuereth jsuereth marked this pull request as ready for review June 6, 2025 14:04
@jsuereth jsuereth requested review from a team as code owners June 6, 2025 14:04
@github-actions github-actions Bot added the enhancement New feature or request label Jun 6, 2025
lmolkova
lmolkova approved these changes Jun 6, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
@lmolkova lmolkova moved this from Untriaged to Needs More Approval in Semantic Conventions Triage Jun 6, 2025
jsuereth and others added 7 commits June 6, 2025 15:17
@jsuereth
Update docs/non-normative/how-to-write-conventions/resource-and-entit…
44affb3 
…ies.md

Co-authored-by: Liudmila Molkova <[email protected]>
@jsuereth
Update docs/non-normative/how-to-write-conventions/resource-and-entit…
3ff126e 
…ies.md

Co-authored-by: Liudmila Molkova <[email protected]>
@jsuereth
Update docs/non-normative/how-to-write-conventions/resource-and-entit…
1cbe833 
…ies.md

Co-authored-by: Liudmila Molkova <[email protected]>
@jsuereth
Update docs/non-normative/how-to-write-conventions/resource-and-entit…
6e9c89d 
…ies.md

Co-authored-by: Liudmila Molkova <[email protected]>
@jsuereth
Update docs/non-normative/how-to-write-conventions/resource-and-entit…
c423c3b 
…ies.md

Co-authored-by: Liudmila Molkova <[email protected]>
@jsuereth
Add link to general naming guidelines for namespacing.
01f35a1
@jsuereth
Fix wording.
a7664fd
smith
smith approved these changes Jun 7, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
tigrannajaryan
tigrannajaryan reviewed Jun 10, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
joaopgrassi
joaopgrassi reviewed Jun 11, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
lmolkova
lmolkova reviewed Jun 12, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
ChrsMark
ChrsMark reviewed Jun 17, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
ChrsMark
ChrsMark reviewed Jun 17, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md Outdated
ChrsMark
ChrsMark reviewed Jun 17, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
ChrsMark
ChrsMark reviewed Jun 17, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
dmitryax
dmitryax reviewed Jun 20, 2025
View reviewed changes
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
Comment thread docs/non-normative/how-to-write-conventions/resource-and-entities.md
@ChrsMark ChrsMark mentioned this pull request Jun 23, 2025
Open
@lmolkova lmolkova moved this from Needs More Approval to Ready to be Merged in Semantic Conventions Triage Jun 23, 2025
@jsuereth jsuereth enabled auto-merge June 23, 2025 21:12
@jsuereth jsuereth added this pull request to the merge queue Jun 23, 2025
Merged via the queue into open-telemetry:main with commit 7db392d Jun 23, 2025
15 checks passed
@jsuereth jsuereth deleted the wip-entity-modelling-guide branch June 23, 2025 21:22
jherbage pushed a commit to jherbage/semantic-conventions that referenced this pull request Jul 1, 2025
@jsuereth @smith
@joaopgrassi @ChrsMark @jherbage
Create an entity modelling guide (open-telemetry#2328)
dc82210 
Co-authored-by: Liudmila Molkova <[email protected]>
Co-authored-by: Nathan L Smith <[email protected]>
Co-authored-by: Joao Grassi <[email protected]>
Co-authored-by: Christos Markou <[email protected]>
spurplewang pushed a commit to spurplewang/semantic-conventions that referenced this pull request Jul 10, 2025
@jsuereth @smith
@joaopgrassi @ChrsMark @spurplewang
Create an entity modelling guide (open-telemetry#2328)
94bf9dd 
Co-authored-by: Liudmila Molkova <[email protected]>
Co-authored-by: Nathan L Smith <[email protected]>
Co-authored-by: Joao Grassi <[email protected]>
Co-authored-by: Christos Markou <[email protected]>
@lmolkova lmolkova mentioned this pull request Oct 15, 2025
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@lmolkova lmolkova lmolkova approved these changes

@tigrannajaryan tigrannajaryan tigrannajaryan left review comments

@joaopgrassi joaopgrassi joaopgrassi left review comments

@dmitryax dmitryax dmitryax approved these changes

@ChrsMark ChrsMark ChrsMark approved these changes

+1 more reviewer

@smith smith smith approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

enhancement New feature or request

Projects

Semantic Conventions Triage
Archived in project

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[entities] Adding Entity Support to Semantic Conventions

7 participants

@jsuereth @smith @lmolkova @tigrannajaryan @joaopgrassi @dmitryax @ChrsMark