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
Merged
Show file tree
Hide file tree
Changes from 20 commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
3073cad
first pass at client sessions semconv
bryce-b Jul 26, 2023
6fd49af
Update docs/client/README.md
bryce-b Jul 27, 2023
bbdbaa4
Update docs/client/session.md
bryce-b Jul 27, 2023
5d031e8
Update docs/client/README.md
bryce-b Jul 27, 2023
45be3f2
added session model and PR feedback changes
bryce-b Aug 1, 2023
f99f97d
fixed lint errors
bryce-b Aug 1, 2023
2574f89
fixing lint errors
bryce-b Aug 1, 2023
1434ecf
added doc status to session.md
bryce-b Aug 1, 2023
7f6291f
added doc status to session.md
bryce-b Aug 1, 2023
034db4a
updated session definitions per feedback
bryce-b Aug 7, 2023
51b4a60
applied changes per conversation with Santosh
bryce-b Aug 16, 2023
7ee3642
regenerated session-id table
bryce-b Aug 17, 2023
cbbe82e
changed guid to uuid
bryce-b Aug 22, 2023
64599e2
Merge branch 'main' into client-sessions
bryce-b Aug 22, 2023
1b04df6
updated session id description
bryce-b Aug 22, 2023
f32f8d2
cleaning up lint issues
bryce-b Aug 22, 2023
9d975e1
removed newline
bryce-b Aug 22, 2023
739b0be
removed whitespace
bryce-b Aug 22, 2023
98ad47d
new line on yaml file
bryce-b Aug 22, 2023
9da5dcb
Merge branch 'main' into client-sessions
bryce-b Aug 22, 2023
751dff4
Update session.yaml
bryce-b Aug 30, 2023
a7329ca
Update session.yaml
bryce-b Aug 30, 2023
d1b4bc2
regenerated table
bryce-b Aug 30, 2023
36b4a68
Merge branch 'main' into client-sessions
bryce-b Aug 31, 2023
c34edb8
Merge branch 'main' into client-sessions
bryce-b Sep 7, 2023
c10c6d4
Merge branch 'main' into client-sessions
bryce-b Sep 12, 2023
070a10f
updated changelog.md
bryce-b Sep 18, 2023
49e8728
removed trailing space
bryce-b Sep 18, 2023
2cbfda9
Merge branch 'main' into client-sessions
bryce-b Sep 19, 2023
c7c417d
Merge branch 'main' into client-sessions
AlexanderWert Sep 22, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions docs/general/session.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Semantic conventions for session

**Status**: [Experimental][DocumentStatus]

This document defines semantic conventions to apply to client-side applications when tracking sessions.

Session is defined as the period of time encompassing all activities performed by the application and the actions
bryce-b marked this conversation as resolved.
Show resolved Hide resolved
executed by the end user.

Consequently, a Session is represented as a collection of Logs, Events, and Spans emitted by the Client Application
throughout the Session's duration. Each Session is assigned a unique identifier, which is included as an attribute in
the Logs, Events, and Spans generated during the Session's lifecycle.

## Attributes

<!-- semconv session-id -->
| Attribute | Type | Description | Examples | Requirement Level |
|---|---|---|---|---|
| `session.id` | string | A UUID to identify the current session. This value should be generated by the SDK and not supplied by the client. | `00112233-4455-6677-8899-aabbccddeeff` | Opt-In |
bryce-b marked this conversation as resolved.
Show resolved Hide resolved
<!-- endsemconv -->

[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.22.0/specification/document-status.md
17 changes: 17 additions & 0 deletions model/session.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
groups:
- id: session-id
prefix: session
type: attribute_group
brief: >
Session is defined as the period of time encompassing all activities performed by the application and the actions
executed by the end user.

Consequently, a Session is represented as a collection of Logs, Events, and Spans emitted by the Client Application
throughout the Session's duration. Each Session is assigned a unique identifier, which is included as an attribute in
the Logs, Events, and Spans generated during the Session's lifecycle.
attributes:
- id: id
type: string
brief: "A UUID to identify the current session. This value should be generated by the SDK and not supplied by the client."
examples: "00112233-4455-6677-8899-aabbccddeeff"
requirement_level: opt_in
Loading