Skip to content

Session.id semantic convention#215

Merged
joaopgrassi merged 30 commits intoopen-telemetry:mainfrom
bryce-b:client-sessions
Sep 22, 2023
Merged

Session.id semantic convention#215
joaopgrassi merged 30 commits intoopen-telemetry:mainfrom
bryce-b:client-sessions

Conversation

@bryce-b
Copy link
Copy Markdown
Member

@bryce-b bryce-b commented Jul 26, 2023

Discussed this in the client-side sig. Added a basic definition to start discussion.

Comment thread docs/client/session.md Outdated
Comment thread docs/client/session.md Outdated
Comment thread docs/client/session.md Outdated
Comment thread docs/client/session.md Outdated
Comment thread docs/client/README.md Outdated
Comment thread docs/client/session.md Outdated
Comment thread docs/client/session.md Outdated
Comment thread docs/client/README.md Outdated
bryce-b and others added 3 commits July 27, 2023 11:38
Comment thread docs/client/session.md Outdated
Comment thread docs/client/session.md Outdated
Comment thread docs/client/session.md Outdated
Comment thread docs/client/README.md Outdated
Comment thread docs/client/README.md Outdated
Comment thread docs/client/session.md
Comment thread docs/client/session.md Outdated
bryce-b added 2 commits August 7, 2023 12:38
- removed 'client' prefix
- added session duration & start
- removed behavior definitions of session
Comment thread docs/general/session.md Outdated
@bryce-b bryce-b marked this pull request as ready for review August 22, 2023 16:01
@bryce-b bryce-b requested review from a team August 22, 2023 16:01
@bryce-b bryce-b changed the title first pass at client sessions semconv Session.id semantic convention Aug 22, 2023
@bryce-b
Copy link
Copy Markdown
Member Author

bryce-b commented Aug 29, 2023

@open-telemetry/specs-approvers @open-telemetry/specs-semconv-maintainers This is ready for your review!

Comment thread docs/general/session.md Outdated
Comment thread docs/general/session.md
@breedx-splk
Copy link
Copy Markdown
Contributor

We have 3 approvals on this and it's been open for months.
@open-telemetry/specs-semconv-approvers @open-telemetry/specs-semconv-maintainers is anything else holding this up? It's pretty small and entirely new experimental spec, required to make some traction on client instrumentation. Thanks!

Copy link
Copy Markdown
Member

@joaopgrassi joaopgrassi left a comment

Choose a reason for hiding this comment

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

Usually in conventions, we also describe things like span names, maybe a structure of a trace (in this case modeling a session). Is this something the group discussed and want to work on? Or the idea is to just define the attribute for now?

I'm missing a bit more of context on why this change is needed. Is there any issue/meeting notes/discussion documented that could help understanding the need for this attribute?

Also please add a changelog entry.

@breedx-splk
Copy link
Copy Markdown
Contributor

@joaopgrassi respectfully, this has been discussed at length in the client SIG. Sessions don't really have a data shape themselves (or at least not yet in our mental model), it's more like a sequence of telemetry all grouped together, as identified by a session identifier. Hence this PR.

The idea is to get something started so that we can iterate on it. This is not intended to be comprehensive yet.

@joaopgrassi
Copy link
Copy Markdown
Member

joaopgrassi commented Sep 14, 2023

@breedx-splk all good, the concept of a session is clear to me. I was more interested in for example an issue where the SIG discussions and agreements/plans are documented. I don't participate in the SIG so having that piece of extra context IMO helps the general semconv approvers.

@joaopgrassi
Copy link
Copy Markdown
Member

This has several approvals and has been open for a while with no objections. Merging :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.