Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Session.id semantic convention #215

Merged
merged 30 commits into from
Sep 22, 2023

Conversation

bryce-b
Copy link
Member

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

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

docs/client/session.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/README.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/README.md Outdated Show resolved Hide resolved
bryce-b and others added 3 commits July 27, 2023 11:38
Co-authored-by: jason plumb <75337021+breedx-splk@users.noreply.github.com>
Co-authored-by: jason plumb <75337021+breedx-splk@users.noreply.github.com>
Co-authored-by: Chengzhong Wu <legendecas@gmail.com>
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/README.md Outdated Show resolved Hide resolved
docs/client/README.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
docs/client/session.md Outdated Show resolved Hide resolved
- removed 'client' prefix
- added session duration & start
- removed behavior definitions of session
docs/general/session.md Outdated Show resolved Hide resolved
@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
Member Author

bryce-b commented Aug 29, 2023

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

docs/general/session.md Outdated Show resolved Hide resolved
@breedx-splk
Copy link
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
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
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
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
Member

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

@joaopgrassi joaopgrassi merged commit a89f573 into open-telemetry:main Sep 22, 2023
8 checks passed
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.