Skip to content

Commit

Permalink
Introducing Application Telemetry Schema in OpenTelemetry - Vision an…
Browse files Browse the repository at this point in the history
…d Roadmap (open-telemetry#243)

[Easy to read version with images:
[https://github.com/lquerel/oteps/blob/app-telemetry-schema-vision-roadmap/text/0243-app-telemetry-schema-vision-roadmap.md](https://github.com/lquerel/oteps/blob/app-telemetry-schema-vision-roadmap/text/0243-app-telemetry-schema-vision-roadmap.md)]

Unlike the traditional data ecosystem (OLTP and OLAP), the world of
telemetry generally does not rely on the concept of a schema.
Instrumentation is deeply embedded in the code of applications and
libraries, making it difficult to discover all the possible telemetry
signals an application can emit. This gap prevents or limits the
development of CI/CD tools for checking, reporting, documenting, and
generating artifacts from telemetry signals specific to an application.
This document presents a long-term vision aimed at enabling the
OpenTelemetry project to address this issue and extend its impact to a
broader ecosystem. It proposes extending the initiatives of Telemetry
Schema and Semantic Conventions to include concepts of Application
Telemetry Schema and Resolved Telemetry Schema. A series of OTEPs and
Tools will be proposed in this overarching document to detail each
aspect of this vision.

Similar (but proprietary) initiative from Facebook: [Positional Paper:
Schema-First Application
Telemetry](https://research.facebook.com/publications/positional-paper-schema-first-application-telemetry/)

**EDIT 1: The OTel Weaver project (a PoC implementation of this OTEP and
some of the others mentioned in the roadmap) is now available
[here](https://github.com/f5/otel-weaver).**

**EDIT 2: The Slack channel
[#otel-weaver](https://cloud-native.slack.com/archives/C0697EXNTL3) is
dedicated to this OTEP and the associated OTel Weaver project.**

---------

Co-authored-by: Yuri Shkuro <[email protected]>
Co-authored-by: Reiley Yang <[email protected]>
Co-authored-by: Tigran Najaryan <[email protected]>
  • Loading branch information
4 people authored and carlosalberto committed Feb 7, 2024
1 parent f43bf4c commit ad306bd
Show file tree
Hide file tree
Showing 9 changed files with 394 additions and 0 deletions.
386 changes: 386 additions & 0 deletions text/0243-app-telemetry-schema-vision-roadmap.md

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-component-schema.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-concepts.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-dev-strategies.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-hierarchy.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-overview.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-resolved-schema.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-responsibilities-properties.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions text/img/0243-otel-weaver-use-cases.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit ad306bd

Please sign in to comment.