From 72600f5574b14a879b091da402c2bc39032cc2cf Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Thu, 4 Feb 2021 16:56:38 +0100 Subject: [PATCH 1/6] Tiny clarification on OTLP/HTTP Formats status. --- specification/protocol/otlp.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/specification/protocol/otlp.md b/specification/protocol/otlp.md index 8ed0497bc4a..4805828692a 100644 --- a/specification/protocol/otlp.md +++ b/specification/protocol/otlp.md @@ -301,7 +301,8 @@ The default network port for OTLP/gRPC is 4317. ### OTLP/HTTP -**Status**: [Experimental](../document-status.md) +**Binary Format Status**: [Stable](../document-status.md) +**JSON Format Status**: [Experimental]((../document-status.md)) OTLP/HTTP uses Protobuf payloads encoded either in binary format or in JSON format. The Protobuf schema of the messages is the same for OTLP/HTTP and From 98c4a697e934f1669f3de11c3ed7d54e602d3aa4 Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Thu, 4 Feb 2021 17:26:26 +0100 Subject: [PATCH 2/6] Details about different signals stability. --- specification/protocol/otlp.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/specification/protocol/otlp.md b/specification/protocol/otlp.md index 4805828692a..3c38951ca97 100644 --- a/specification/protocol/otlp.md +++ b/specification/protocol/otlp.md @@ -11,6 +11,7 @@ nodes such as collectors and telemetry backends. Table of Contents +- [Signal Status](#signal-status) - [Protocol Details](#protocol-details) * [OTLP/gRPC](#otlpgrpc) + [OTLP/gRPC Concurrent Requests](#otlpgrpc-concurrent-requests) @@ -44,6 +45,16 @@ Table of Contents OTLP is a general-purpose telemetry data delivery protocol designed in the scope of OpenTelemetry project. +## Signal Status + +Each signal has different support and stability in OTLP, described through its +own status, which in turn applies to **all** the OTLP Transports listed below, +e.g. OTLP/gRPC. + +* Tracing: [Stable](../document-status.md) +* Metrics: [Experimental](../document-status.md) +* Logs: [Experimental](../document-status.md) + ## Protocol Details OTLP defines the encoding of telemetry data and the protocol used to exchange From 8ecfb523e87a2b7a41c6612df18455d9882e221d Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Thu, 4 Feb 2021 17:40:02 +0100 Subject: [PATCH 3/6] Fix format. --- specification/protocol/otlp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/protocol/otlp.md b/specification/protocol/otlp.md index 3c38951ca97..1e800a50f03 100644 --- a/specification/protocol/otlp.md +++ b/specification/protocol/otlp.md @@ -313,7 +313,7 @@ The default network port for OTLP/gRPC is 4317. ### OTLP/HTTP **Binary Format Status**: [Stable](../document-status.md) -**JSON Format Status**: [Experimental]((../document-status.md)) +**JSON Format Status**: [Experimental](../document-status.md) OTLP/HTTP uses Protobuf payloads encoded either in binary format or in JSON format. The Protobuf schema of the messages is the same for OTLP/HTTP and From 7f5a31b042bde861f6c334bc8b933445d26f7070 Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Thu, 4 Feb 2021 20:20:19 +0100 Subject: [PATCH 4/6] Improve. --- specification/protocol/otlp.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/specification/protocol/otlp.md b/specification/protocol/otlp.md index 1e800a50f03..5254be78925 100644 --- a/specification/protocol/otlp.md +++ b/specification/protocol/otlp.md @@ -11,7 +11,7 @@ nodes such as collectors and telemetry backends. Table of Contents -- [Signal Status](#signal-status) +- [Signals Maturity Level](#signals-maturity-level) - [Protocol Details](#protocol-details) * [OTLP/gRPC](#otlpgrpc) + [OTLP/gRPC Concurrent Requests](#otlpgrpc-concurrent-requests) @@ -45,15 +45,17 @@ Table of Contents OTLP is a general-purpose telemetry data delivery protocol designed in the scope of OpenTelemetry project. -## Signal Status +## Signals Maturity Level Each signal has different support and stability in OTLP, described through its -own status, which in turn applies to **all** the OTLP Transports listed below, +own maturity level, which in turn applies to **all** the OTLP Transports listed below, e.g. OTLP/gRPC. -* Tracing: [Stable](../document-status.md) -* Metrics: [Experimental](../document-status.md) -* Logs: [Experimental](../document-status.md) +* Tracing: **Stable** +* Metrics: **Beta** +* Logs: **Alpha** + +See [OTLP Maturity Level](https://github.com/open-telemetry/opentelemetry-proto#maturity-level). ## Protocol Details From 2a144cf8fa6b9e9c3a6d130d6093185f47a4594e Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Fri, 5 Feb 2021 14:06:53 +0100 Subject: [PATCH 5/6] Remove unnecesary mention of the gRPC transport. --- specification/protocol/otlp.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/specification/protocol/otlp.md b/specification/protocol/otlp.md index 5254be78925..0bbac03c6c0 100644 --- a/specification/protocol/otlp.md +++ b/specification/protocol/otlp.md @@ -48,8 +48,7 @@ of OpenTelemetry project. ## Signals Maturity Level Each signal has different support and stability in OTLP, described through its -own maturity level, which in turn applies to **all** the OTLP Transports listed below, -e.g. OTLP/gRPC. +own maturity level, which in turn applies to **all** the OTLP Transports listed below. * Tracing: **Stable** * Metrics: **Beta** From 47c56fd03bf27d971a43b42d14159d2934a01686 Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Fri, 5 Feb 2021 19:46:46 +0100 Subject: [PATCH 6/6] Update CHANGELOG. --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index b2af7fee9d4..6107d89fcd9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -60,6 +60,8 @@ Updates: - Modify OTLP/Zipkin Exporter format variables for 1.0 (allowing further specification post 1.0) ([#1358](https://github.com/open-telemetry/opentelemetry-specification/pull/1358)) - Add `k8s.node` semantic conventions ([#1390](https://github.com/open-telemetry/opentelemetry-specification/pull/1390)) +- Clarify stability for both OTLP/HTTP and signals in OTLP. + ([#1400](https://github.com/open-telemetry/opentelemetry-specification/pull/1400/files)) ## v0.7.0 (11-18-2020)