Skip to content

Commit 10e99f8

Browse files
author
Tigran Najaryan
committed
PR fixes
1 parent 78c35b8 commit 10e99f8

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

specification/library-guidelines.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,15 +16,17 @@ _Note to Language Library Authors:_ OpenTelemetry specification, API and SDK imp
1616

1717
3. The developers of the final application normally decide how to configure OpenTelemetry SDK and what extensions to use. They should be also free to choose to not use any OpenTelemetry implementation at all, even though the application and/or its libraries are already instrumented. The rationale is that third-party libraries and frameworks which are instrumented with OpenTelemetry must still be fully usable in the applications which do not want to use OpenTelemetry (so this removes the need for framework developers to have "instrumented" and "non-instrumented" versions of their framework).
1818

19-
4. Language library implementation must be clearly separated into wire protocol-independent parts that implement common logic (e.g. batching, tag enrichment by process information, etc.) and protocol-dependent telemetry exporters. Telemetry exporters must contain minimal functionality, thus enabling vendors to easily add support for their specific protocol.
19+
4. The SDK must be clearly separated into wire protocol-independent parts that implement common logic (e.g. batching, tag enrichment by process information, etc.) and protocol-dependent telemetry exporters. Telemetry exporters must contain minimal functionality, thus enabling vendors to easily add support for their specific protocol.
2020

21-
5. Language library implementation should include the following exporters:
21+
5. The SDK implementation should include the following exporters:
2222
- Jaeger.
2323
- Zipkin.
2424
- OpenCensus.
2525
- Prometheus.
2626
- OpenTelemetry Protocol (when the protocol is specified and approved).
27-
- Standard output to use for debugging and testing.
27+
- Standard output (or logging) to use for debugging and testing as well as an input for the various log proxy tools.
28+
29+
Note: some of these support multiple protocols (e.g. gRPC, Thrift, etc). The exact list of protocols to implement in the exporters is TBD.
2830

2931
Other 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).
3032

0 commit comments

Comments
 (0)