Make client.address and client.port sampling relevant on HTTP server …

…spans
open-telemetry · Oct 29, 2023 · 7459467 · 7459467
1 parent a3bec5e
commit 7459467
Show file tree

Hide file tree

Showing 3 changed files with 8 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -32,6 +32,10 @@ release.
   ([#409](https://github.com/open-telemetry/semantic-conventions/pull/409))
 - Remove `url.path` default value.
   ([#462](https://github.com/open-telemetry/semantic-conventions/pull/462))
+- Remove `url.path` default value.
+  ([#462](https://github.com/open-telemetry/semantic-conventions/pull/462))
+- Make `client.address` and `client.port` sampling relevant on HTTP server spans.
+  ([#999](https://github.com/open-telemetry/semantic-conventions/pull/999))
 
 ### Features
 

diff --git a/docs/http/http-spans.md b/docs/http/http-spans.md
@@ -374,6 +374,8 @@ SHOULD include the [application root](/docs/http/http-spans.md#http-server-defin
 
 Following attributes MUST be provided **at span creation time** (when provided at all), so they can be considered for sampling decisions:
 
+* [`client.address`](../general/attributes.md)
+* [`client.port`](../general/attributes.md)
 * [`server.address`](../general/attributes.md)
 * [`server.port`](../general/attributes.md)
 * [`url.path`](../attributes-registry/url.md)

diff --git a/model/trace/http.yaml b/model/trace/http.yaml
@@ -67,13 +67,15 @@ groups:
         requirement_level: opt_in
         brief: Local socket port. Useful in case of a multi-port host.
       - ref: client.address
+        sampling_relevant: true
         note: >
             The IP address of the original client behind all proxies, if
             known (e.g. from [Forwarded](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded),
             [X-Forwarded-For](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-For), or a similar header).
             Otherwise, the immediate client peer address.
         examples: ['83.164.160.102']
       - ref: client.port
+        sampling_relevant: true
         brief: >
             The port of the original client behind all proxies, if
             known (e.g. from [Forwarded](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded) or a similar header).