Skip to content

Add list of exporters that are recommended for SDK#284

Merged
bogdandrutu merged 2 commits intoopen-telemetry:masterfrom
tigrannajaryan:feature/tigran/standardexporters
Oct 5, 2019
Merged

Add list of exporters that are recommended for SDK#284
bogdandrutu merged 2 commits intoopen-telemetry:masterfrom
tigrannajaryan:feature/tigran/standardexporters

Conversation

@tigrannajaryan
Copy link
Copy Markdown
Member

@tigrannajaryan tigrannajaryan commented Oct 3, 2019

Based on previous discussion [1] this PR adds a recommendation to include
exporters for several open-source protocols in language libraries.

Fixes #6

[1] - #277 (comment)

Based on previous discussion [1] this PR adds a recommendation to include
exporters for several open-source protocols in language libraries.

Addresses issue open-telemetry#6

[1] - open-telemetry#277 (comment)
Comment thread specification/library-guidelines.md Outdated
Copy link
Copy Markdown
Member

@SergeyKanzhelev SergeyKanzhelev left a comment

Choose a reason for hiding this comment

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

With the suggestion

Comment thread specification/library-guidelines.md Outdated
5. Language library implementation should include an exporter for OpenTelemetry Protocol (when the protocol is specified and approved) and may include an exporter that writes to standard output (to use for debugging and testing). Vendor-specific exporters (exporters that implement vendor protocols) should not be included in language libraries and should be placed elsewhere (the exact approach for storing and maintaining vendor-specific exporters will be defined in the future).
5. Language library implementation should include the following exporters:
- Jaeger.
- Zipkin.
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.

  1. Jaeger and Zipkin backends support multiple encodings and transports, e.g. thrift, json, proto, udp, http, grpc. Which makes this recommendation pretty broad. Is the SDK in each language expected to implement all of those? Or at minimum one of those?
  2. This recommendation only applies to OTel SDKs, not to any implementation of OTel API. Perhaps this file should be renamed and scoped differently, e.g. sdk-guidelines.md

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

@yurishkuro I added a note that exact list of protocol is to be defined and also replaced "language library" by "SDK" in a few relevant places.
I think we should keep the name of the file since it is not only about SDK but touches the API package as well.

Copy link
Copy Markdown
Contributor

@tedsuo tedsuo left a comment

Choose a reason for hiding this comment

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

I recommend that we merge this for now, then follow up later to discuss the clarifications that @yurishkuro suggests.

@tigrannajaryan tigrannajaryan force-pushed the feature/tigran/standardexporters branch 2 times, most recently from eefc47d to 10e99f8 Compare October 4, 2019 12:44
@tigrannajaryan
Copy link
Copy Markdown
Member Author

tigrannajaryan commented Oct 4, 2019

Admins: for some reason I cannot merge PRs in this spec. I guess I should be able as an approver? If so please give the merge permission.

@carlosalberto
Copy link
Copy Markdown
Contributor

I recommend that after merging we also include an In Memory exporter option, as this will help users write tests (we had something like this in OT, called MockTracer, and was super helpful).

@yurishkuro
Copy link
Copy Markdown
Member

@tigrannajaryan do you want to add "in memory" next to "Standard output (or logging)"?

@tigrannajaryan
Copy link
Copy Markdown
Member Author

@yurishkuro @carlosalberto sure, let me add in-memory to the list.

@tigrannajaryan tigrannajaryan force-pushed the feature/tigran/standardexporters branch from 10e99f8 to 1807572 Compare October 4, 2019 20:06
@tigrannajaryan
Copy link
Copy Markdown
Member Author

@yurishkuro @carlosalberto "in-memory" exported added.

@bogdandrutu bogdandrutu merged commit 203f8d9 into open-telemetry:master Oct 5, 2019
@tigrannajaryan tigrannajaryan deleted the feature/tigran/standardexporters branch October 22, 2019 21:35
SergeyKanzhelev pushed a commit to SergeyKanzhelev/opentelemetry-specification that referenced this pull request Feb 18, 2020
* Add list of exporters that are recommended for SDK

Based on previous discussion [1] this PR adds a recommendation to include
exporters for several open-source protocols in language libraries.

Addresses issue open-telemetry#6

[1] - open-telemetry#277 (comment)

* PR fixes
TuckTuckFloof pushed a commit to TuckTuckFloof/opentelemetry-specification that referenced this pull request Oct 15, 2020
carlosalberto pushed a commit to carlosalberto/opentelemetry-specification that referenced this pull request Oct 31, 2024
* Add list of exporters that are recommended for SDK

Based on previous discussion [1] this PR adds a recommendation to include
exporters for several open-source protocols in language libraries.

Addresses issue open-telemetry#6

[1] - open-telemetry#277 (comment)

* PR fixes
schmikei pushed a commit to schmikei/opentelemetry-specification that referenced this pull request Apr 17, 2025
…ing to OTEP 220 (open-telemetry#284)

Co-authored-by: Liudmila Molkova <limolkova@microsoft.com>
Co-authored-by: Joao Grassi <joao.grassi@dynatrace.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define the list of standard exporters that SDK should support

8 participants