apache / apache/flagon

feat(otel): propose browser behavioral analytics semantic conventions

Open
#145 0 comments 0 reactions 0 assignees View on GitHub
Discuss enhancement
Dominant language
Jupyter Notebook
Stars
30
Forks
15
PR merge metrics
No merged PRs in 30d

Description

## Summary

Propose OTel semantic conventions for browser behavioral analytics to the OpenTelemetry specification.

## Proposed Conventions

| Attribute | Type | Description |
|---|---|---|
| `browser.dom.target` | string | CSS selector of interaction target |
| `browser.dom.path` | string[] | DOM path from target to root |
| `browser.event.type` | string | DOM event type (click, keydown, etc.) |
| `browser.session.id` | string | Behavioral session identifier |
| `browser.viewport.width` | int | Viewport width in pixels |
| `browser.viewport.height` | int | Viewport height in pixels |
| `browser.pointer.x` | double | Pointer X coordinate |
| `browser.pointer.y` | double | Pointer Y coordinate |

## Process

1. Validate mapping via Flagon's OTLP exporter (#140)
2. Draft OTEP (OpenTelemetry Enhancement Proposal)
3. Submit to opentelemetry-specification repo
4. Iterate based on SIG feedback

## Depends On

- #140 (OTLP exporter — proves mapping works in practice)
- Community validation via demo (#141)

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing #140 for the OTLP exporter mapping and #141 for the demo's community validation. Use those results to draft the OTEP and submit it to the opentelemetry-specification repository; done means the proposal has been submitted and iterated based on SIG feedback.

Written by the indexing model from the issue text.

Assessment

Domain
documentation, observability
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.