Skip to content

Conversation

@Karlie-777
Copy link
Contributor

Fixes #

Changes

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

Copy link
Contributor

@breedx-splk breedx-splk left a comment

Choose a reason for hiding this comment

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

I think this is good, especially as a first pass "development" event, thanks! I left some comments and think there is room for improvement and possibly sharing/broadening, but I don't want those to block. Thanks for making this bite-sized!

@breedx-splk breedx-splk mentioned this pull request Mar 4, 2025
3 tasks
@lmolkova lmolkova moved this from Untriaged to Awaiting SIG approval in Semantic Conventions Triage Mar 17, 2025
- id: keyboard.enter
value: "keyboard.enter"
stability: development
brief: An element is entered via keyboard by a user.

Choose a reason for hiding this comment

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

This description is not clear to me. is that similar to keyboard.space below? so we track when user hits enter while an element (probably an input) has the focus?

If so I wonder why we want to differentiate between these two keys.

value: "keyboard.space"
stability: development
brief: A space is entered via keyboard by a user.
- id: other

Choose a reason for hiding this comment

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

another interesting event IMHO is input

Comment on lines +126 to +139
- id: page.x
type: int
stability: development
brief: Click x(horizontal) coordinates(in pixels) relative to the entire document.
requirement_level: recommended
examples:
- 10
- id: page.y
type: int
stability: development
brief: Click y(vertical) coordinates(in pixels) relative to the entire document.
requirement_level: recommended
examples:
- 10
Copy link
Contributor

Choose a reason for hiding this comment

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

Could we use the app.screen.coordinate.* namespace ?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

#1941 (comment) and #2070 should already cover the app click events

Comment on lines +140 to +146
- id: tags
type: string[]
stability: development
brief: Grab data from data-otel-* attributes in tree.
requirement_level: recommended
examples:
- ["id", "name"]
Copy link
Contributor

Choose a reason for hiding this comment

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

Attributes should be set as attributes on the event and don't think that these need to be defined here.

Comment on lines +81 to +125
- id: type
type: enum
members:
- id: click.left
value: "click.left"
stability: development
brief: An element is left clicked by a user.
- id: click.right
value: "click.right"
stability: development
brief: An element is right clicked by a user.
- id: click.middle
value: "click.middle"
stability: development
brief: An element is middle clicked by a user.
- id: scroll
value: "scroll"
stability: development
brief: An element is scrolled by a user.
- id: zoom
value: "zoom"
stability: development
brief: An element is zoomed by a user.
- id: resize
value: "resize"
stability: development
brief: An element is resized by a user.
- id: keyboard.enter
value: "keyboard.enter"
stability: development
brief: An element is entered via keyboard by a user.
- id: keyboard.space
value: "keyboard.space"
stability: development
brief: A space is entered via keyboard by a user.
- id: other
value: "other"
stability: development
brief: User actions that are not listed above.
stability: development
brief: >
Type of interaction.
See enum [here](https://github.com/microsoft/ApplicationInsights-JS/blob/main/extensions/applicationinsights-clickanalytics-js/src/Enums.ts) for potential values we could add support for.
requirement_level: required
examples: ["click.right"]
Copy link
Contributor

Choose a reason for hiding this comment

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

Feel that these should be attributes.

Comment on lines +67 to +72
- id: tag_name
type: string
stability: development
brief: Target element tag name and it is obtained via `event.target.tagName`.
requirement_level: recommended
examples: ["BUTTON"]
Copy link
Contributor

Choose a reason for hiding this comment

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

Feel that this should be an attribute

brief: A unique ID representing this particular metric instance.
requirement_level: required
examples: ["v3-1677874579383-6381583661209"]
- id: event.browser.user_action
Copy link
Contributor

Choose a reason for hiding this comment

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

Would like to see the id/name be related to the group they come from with the list defined at: https://www.w3schools.com/jsref/obj_events.asp that way we can have a more tailored body/attributes.

@github-project-automation github-project-automation bot moved this from Needs More Approval to Blocked in Semantic Conventions Triage Jun 24, 2025
@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 10, 2025
@tedsuo tedsuo moved this to In Progress in Browser: Phase 1 Jul 10, 2025
@lmolkova
Copy link
Member

What's the status of this PR, is this ready for the general SemConv review?

@joaquin-diaz
Copy link

Since @Karlie-777 is not actively working on this I am continuing her work here #2992 (I couldn't push to the same branch unfortunately). I am already working on the instrumentation side and we want to keep things moving

@thompson-tomo Could you take another look there? For starters I moved all the body fields to attributes, could you replicate any other comments you have here there so we can continue the conversation?

@david-luna I see you also have a pending comment, I replaced the keyboard.space and keyboard.enter for input as it wasn't very clear to me what was the intention for those either. Input should cover them and the rest of the keys

@MSNev and @breedx-splk You both approved this PR, could you please take another look at the new PR?

Thanks everyone!

@tedsuo
Copy link

tedsuo commented Oct 30, 2025

Closing this in favor of #2992

@tedsuo tedsuo closed this Oct 30, 2025
@github-project-automation github-project-automation bot moved this from In Progress to Done in Browser: Phase 1 Oct 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Done
Archived in project

Development

Successfully merging this pull request may close these issues.

10 participants