Skip to content

Commit d23ec96

Browse files
authored
Remove obsolete http.status_text from semantic conventions (open-telemetry#972)
1 parent 8116d7b commit d23ec96

File tree

4 files changed

+3
-9
lines changed

4 files changed

+3
-9
lines changed

Diff for: CHANGELOG.md

+2
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,8 @@ Updates:
6464
([#911](https://github.com/open-telemetry/opentelemetry-specification/pull/911))
6565
- Explicitly specify the SpanContext APIs IsValid and IsRemote as required
6666
([#914](https://github.com/open-telemetry/opentelemetry-specification/pull/914))
67+
- Remove obsolete `http.status_text` from semantic conventions
68+
([#972](https://github.com/open-telemetry/opentelemetry-specification/pull/972))
6769
- SDK: Rename the `Decision` values for `SamplingResult`s to `DROP`, `RECORD_ONLY`
6870
and `RECORD_AND_SAMPLE` for consistency
6971
([#938](https://github.com/open-telemetry/opentelemetry-specification/pull/938),

Diff for: semantic_conventions/trace/http.yaml

-4
Original file line numberDiff line numberDiff line change
@@ -37,10 +37,6 @@ groups:
3737
conditional: If and only if one was received/sent.
3838
brief: '[HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6).'
3939
examples: [200]
40-
- id: status_text
41-
type: string
42-
brief: '[HTTP reason phrase](https://tools.ietf.org/html/rfc7230#section-3.1.2).'
43-
examples: ['OK']
4440
- id: flavor
4541
type:
4642
# Default value: `true`. If false, it helps the code gen tool to

Diff for: specification/metrics/semantic_conventions/http-metrics.md

-1
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,6 @@ and whether they should be on server, client, or both types of HTTP metric event
3838
| `http.host` | `client` & `server` | see [label alternatives](#label-alternatives) | The value of the [HTTP host header][]. When the header is empty or not present, this label should be the same. |
3939
| `http.scheme` | `client` & `server` | see [label alternatives](#label-alternatives) | The URI scheme identifying the used protocol in lowercase: `"http"` or `"https"` |
4040
| `http.status_code` | `client` & `server` | Optional | [HTTP response status code][]. E.g. `200` (String) |
41-
| `http.status_text` | `client` & `server` | Optional | [HTTP reason phrase][]. E.g. `"OK"` |
4241
| `http.flavor` | `client` & `server` | Optional | Kind of HTTP protocol used: `"1.0"`, `"1.1"`, `"2"`, `"SPDY"` or `"QUIC"`. |
4342
| `net.peer.name` | `client` | see [1] in [label alternatives](#label-alternatives) | See [general network connection attributes](../../trace/semantic_conventions/span-general.md#general-network-connection-attributes) |
4443
| `net.peer.port` | `client` | see [1] in [label alternatives](#label-alternatives) | See [general network connection attributes](../../trace/semantic_conventions/span-general.md#general-network-connection-attributes) |

Diff for: specification/trace/semantic_conventions/http.md

+1-4
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ In the case of an HTTP redirect, the request should normally be considered succe
4444
unless the client aborts following redirects due to hitting some limit (redirect loop).
4545
If following a (chain of) redirect(s) successfully, the status should be set according to the result of the final HTTP request.
4646

47-
Don't set the span status description if the reason can be inferred from `http.status_code` and `http.status_text`.
47+
Don't set the span status description if the reason can be inferred from `http.status_code`.
4848

4949
| HTTP code | Span status code |
5050
|-------------------------|-----------------------|
@@ -79,7 +79,6 @@ Note that the items marked with [1] are different from the mapping defined in th
7979
| `http.host` | string | The value of the [HTTP host header](https://tools.ietf.org/html/rfc7230#section-5.4). When the header is empty or not present, this attribute should be the same. | `www.example.org` | No |
8080
| `http.scheme` | string | The URI scheme identifying the used protocol. | `http`<br>`https` | No |
8181
| `http.status_code` | number | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditional<br>If and only if one was received/sent. |
82-
| `http.status_text` | string | [HTTP reason phrase](https://tools.ietf.org/html/rfc7230#section-3.1.2). | `OK` | No |
8382
| `http.flavor` | string | Kind of HTTP protocol used [1] | `1.0` | No |
8483
| `http.user_agent` | string | Value of the [HTTP User-Agent](https://tools.ietf.org/html/rfc7231#section-5.5.3) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3` | No |
8584
| `http.request_content_length` | number | The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://tools.ietf.org/html/rfc7230#section-3.3.2) header. For requests using transport encoding, this should be the compressed size. | `3495` | No |
@@ -240,7 +239,6 @@ Span name: `/webshop/articles/4` (NOTE: This is subject to change, see [open-tel
240239
| `http.url` | `"https://example.com:8080/webshop/articles/4?s=1"` |
241240
| `net.peer.ip` | `"192.0.2.5"` |
242241
| `http.status_code` | `200` |
243-
| `http.status_text` | `"OK"` |
244242

245243
The corresponding server Span may look like this:
246244

@@ -257,7 +255,6 @@ Span name: `/webshop/articles/:article_id`.
257255
| `http.scheme` | `"https"` |
258256
| `http.route` | `"/webshop/articles/:article_id"` |
259257
| `http.status_code` | `200` |
260-
| `http.status_text` | `"OK"` |
261258
| `http.client_ip` | `"192.0.2.4"` |
262259
| `net.peer.ip` | `"192.0.2.5"` (the client goes through a proxy) |
263260
| `http.user_agent` | `"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:72.0) Gecko/20100101 Firefox/72.0"` |

0 commit comments

Comments
 (0)