diff --git a/CHANGELOG.md b/CHANGELOG.md index a63a74d990..345cdff881 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -94,3 +94,5 @@ release. ([#17](https://github.com/open-telemetry/opentelemetry-specification/pull/17)) - Mark service.version as stable. ([#106](https://github.com/open-telemetry/semantic-conventions/pull/106)) +- Mark initial set of HTTP semantic conventions as frozen + ([#105](https://github.com/open-telemetry/semantic-conventions/pull/105)) diff --git a/specification/metrics/semantic_conventions/http-metrics.md b/specification/metrics/semantic_conventions/http-metrics.md index 7d2e2065c6..6cee733125 100644 --- a/specification/metrics/semantic_conventions/http-metrics.md +++ b/specification/metrics/semantic_conventions/http-metrics.md @@ -4,7 +4,7 @@ linkTitle: HTTP # Semantic Conventions for HTTP Metrics -**Status**: [Experimental][DocumentStatus] +**Status**: [Experimental, partial feature-freeze][DocumentStatus] The conventions described in this section are HTTP specific. When HTTP operations occur, metric events about those operations will be generated and reported to provide insight into the @@ -55,6 +55,8 @@ operations. By adding HTTP attributes to metric events it allows for finely tune ### Metric: `http.server.duration` +**Status**: [Experimental, Feature-freeze][DocumentStatus] + This metric is required. When this metric is reported alongside an HTTP server span, the metric value SHOULD be the same as the HTTP server span duration. @@ -137,6 +139,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi ### Metric: `http.server.active_requests` +**Status**: [Experimental][DocumentStatus] + This metric is optional. @@ -204,6 +208,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi ### Metric: `http.server.request.size` +**Status**: [Experimental][DocumentStatus] + This metric is optional. @@ -280,6 +286,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi ### Metric: `http.server.response.size` +**Status**: [Experimental][DocumentStatus] + This metric is optional. @@ -358,6 +366,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi ### Metric: `http.client.duration` +**Status**: [Experimental, Feature-freeze][DocumentStatus] + This metric is required. When this metric is reported alongside an HTTP client span, the metric value SHOULD be the same as the HTTP client span duration. @@ -431,6 +441,8 @@ SHOULD NOT be set if capturing it would require an extra DNS lookup. ### Metric: `http.client.request.size` +**Status**: [Experimental][DocumentStatus] + This metric is optional. @@ -498,6 +510,8 @@ SHOULD NOT be set if capturing it would require an extra DNS lookup. ### Metric: `http.client.response.size` +**Status**: [Experimental][DocumentStatus] + This metric is optional. diff --git a/specification/trace/semantic_conventions/http.md b/specification/trace/semantic_conventions/http.md index 4b25d6650c..64e57ca3cb 100644 --- a/specification/trace/semantic_conventions/http.md +++ b/specification/trace/semantic_conventions/http.md @@ -1,6 +1,6 @@ # Semantic conventions for HTTP spans -**Status**: [Experimental][DocumentStatus] +**Status**: [Experimental, Feature-freeze][DocumentStatus] This document defines semantic conventions for HTTP client and server Spans. They can be used for http and https schemes