Skip to content

Add profiles data format#4965

Open
christos68k wants to merge 22 commits into
open-telemetry:mainfrom
christos68k:ck/profiles-data-model
Open

Add profiles data format#4965
christos68k wants to merge 22 commits into
open-telemetry:mainfrom
christos68k:ck/profiles-data-model

Conversation

@christos68k

@christos68k christos68k commented Mar 19, 2026

Copy link
Copy Markdown
Member

Changes

Adds a data format description for OpenTelemetry profiles.

I took some content from the old OTEP but decided to leave all of the historical information out, both for clarity/focus and to improve readability (a technical specification doesn't read very well by nature).

We could add additional references and expand on design decisions in a future data-format-appendix.md document.

Also see: #4932 (This PR is a follow-up)

CC: @theletterf @tigrannajaryan @open-telemetry/profiling-maintainers @open-telemetry/profiling-approvers

For non-trivial changes, follow the change proposal process.

  • Related issues: #7874
  • CHANGELOG.md file updated for non-trivial changes
    • For trivial changes, include [chore] in the PR title to skip the changelog check

Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-model.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-model.md Outdated
Comment thread specification/profiles/data-model.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated

@aalexand aalexand left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This looks great, thanks for this work!

Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Co-authored-by: Alexey Alexandrov <aalexand@users.noreply.github.com>
@christos68k

Copy link
Copy Markdown
Member Author

@tigrannajaryan Can you please take another look? It'd be great to have this (and the parent PR here) merged before or close to the Alpha announcement.

@tigrannajaryan tigrannajaryan left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

None of my comments are blocking.

Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md Outdated
christos68k and others added 2 commits March 24, 2026 14:57
Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>
@christos68k christos68k requested a review from jsuereth March 24, 2026 19:06
@christos68k

Copy link
Copy Markdown
Member Author

@christos68k can you update PR title/description to use "data format" instead of "data model".

Done

@tigrannajaryan

Copy link
Copy Markdown
Member

@jsuereth please take a look.

@tigrannajaryan

Copy link
Copy Markdown
Member

@open-telemetry/specs-approvers PTAL

Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md Outdated
Comment thread specification/profiles/data-format.md
Comment thread specification/profiles/data-format.md Outdated
christos68k and others added 6 commits April 16, 2026 16:25
Co-authored-by: Florian Lehner <florianl@users.noreply.github.com>
Co-authored-by: Florian Lehner <florianl@users.noreply.github.com>
Co-authored-by: Florian Lehner <florianl@users.noreply.github.com>
@github-actions

github-actions Bot commented May 1, 2026

Copy link
Copy Markdown

This PR was marked stale. It will be closed in 14 days without additional activity.

@github-actions github-actions Bot added the Stale label May 1, 2026
@tigrannajaryan

Copy link
Copy Markdown
Member

@open-telemetry/spec-sponsors @open-telemetry/specs-approvers please review.

@github-actions

Copy link
Copy Markdown

This PR was marked stale. It will be closed in 14 days without additional activity.

@github-actions github-actions Bot added the Stale label May 26, 2026
pull Bot pushed a commit to CodeWeaver13/opentelemetry-specification that referenced this pull request May 27, 2026
…4932)

## Changes

This update takes into account the [recent
introduction](https://github.com/open-telemetry/opentelemetry.io/pull/9339/changes)
of a profiles signal concepts
[page](https://opentelemetry.io/docs/concepts/signals/profiles/),
removes duplicate information and adds more relevant documentation.

There is a follow-up PR
[here](open-telemetry#4965)
that adds the current data format page.

CC: @theletterf @open-telemetry/profiling-maintainers
@open-telemetry/profiling-approvers

* [X] Related issues:
[#7874](open-telemetry/opentelemetry.io#7874)
* [X]
[`CHANGELOG.md`](https://github.com/open-telemetry/opentelemetry-specification/blob/main/CHANGELOG.md)
file updated for non-trivial changes
* For trivial changes, include `[chore]` in the PR title to skip the
changelog check

---------

Co-authored-by: Felix Geisendörfer <felix@felixge.de>
hilmarf pushed a commit to apeirora/opentelemetry-specification that referenced this pull request Jun 1, 2026
…4932)

## Changes

This update takes into account the [recent
introduction](https://github.com/open-telemetry/opentelemetry.io/pull/9339/changes)
of a profiles signal concepts
[page](https://opentelemetry.io/docs/concepts/signals/profiles/),
removes duplicate information and adds more relevant documentation.

There is a follow-up PR
[here](open-telemetry#4965)
that adds the current data format page.

CC: @theletterf @open-telemetry/profiling-maintainers
@open-telemetry/profiling-approvers

* [X] Related issues:
[#7874](open-telemetry/opentelemetry.io#7874)
* [X]
[`CHANGELOG.md`](https://github.com/open-telemetry/opentelemetry-specification/blob/main/CHANGELOG.md)
file updated for non-trivial changes
* For trivial changes, include `[chore]` in the PR title to skip the
changelog check

---------

Co-authored-by: Felix Geisendörfer <felix@felixge.de>
@arminru arminru linked an issue Jun 2, 2026 that may be closed by this pull request
@tigrannajaryan

Copy link
Copy Markdown
Member

@christos68k please resolve the conflicts.

@github-actions github-actions Bot removed the Stale label Jun 3, 2026
@github-actions

Copy link
Copy Markdown

This PR was marked stale. It will be closed in 14 days without additional activity.

@github-actions github-actions Bot added the Stale label Jun 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Broken link: specification/profiles/data-format.md does not exist

6 participants