docs: align HTTP client READMEs with stable semantic conventions (#1683)

Document stable HTTP span attributes after verifying exported spans from a
sample app. OkHttp3 and HttpUrlConnection instrumentations use the standard
HTTP client extractors from OpenTelemetry Instrumentation.

Fixes #1393

Contributed by @ashishvz on behalf of Vunet Systems (https://vunetsystems.com/).

Made-with: Cursor

Author: ashishvz

instrumentation/httpurlconnection/README.md

@@ -34,14 +34,15 @@ the following occurs: the response stream is fully read, the stream is closed,
 - Name: Determined by the HTTP span name extractor (typically `HTTP {method}` or derived from the URL)
 - Description: Client-side HTTP request
 - Attributes (following OpenTelemetry [HTTP semantic conventions](https://opentelemetry.io/docs/specs/semconv/http/http-spans/)):
-  - `http.method` — request method (GET, POST, etc.)
-  - `http.url` — full URL
-  - `http.target`, `http.host`, `http.scheme` — parts of the request URL when available
-  - `http.status_code` — response status code
-  - `http.flavor` — protocol (e.g. `1.1`)
-  - `net.peer.name` — server host
-  - `net.peer.port` — server port
-  - Request and response headers captured according to configuration: `http.request.header.*` / `http.response.header.*`
+  - `http.request.method` — request method (GET, POST, etc.)
+  - `url.full` — full request URL
+  - `url.scheme`, `url.path`, `url.query` — parts of the request URL when available
+  - `http.response.status_code` — response status code
+  - `network.protocol.version` — protocol version (e.g. `1.1`, `2` for HTTP/2)
+  - `server.address` — logical server host
+  - `server.port` — logical server port
+  - `network.peer.address` / `network.peer.port` — connection endpoint, when available
+  - Request and response headers captured according to configuration: `http.request.header.<name>` / `http.response.header.<name>`
 
 If the request throws an IOException, the span is ended and the exception is recorded.
 

instrumentation/okhttp3/README.md

@@ -18,13 +18,14 @@ are provided by the OkHttp attributes getter.
 * Name: Determined by the HTTP span name extractor (typically `HTTP {method}` or derived from the URL)
 * Description: Client-side HTTP request
 * Common attributes (following OpenTelemetry HTTP semantic conventions):
-  * `http.method` — request method (GET, POST, etc.)
-  * `http.url` — full URL
-  * `http.status_code` — response status code
-  * `http.flavor` — protocol (e.g. `1.1`)
-  * `net.peer.name` — server host
-  * `net.peer.port` — server port
-  * Captured request/response headers per configuration
+  * `http.request.method` — request method (GET, POST, etc.)
+  * `url.full` — full request URL
+  * `http.response.status_code` — response status code
+  * `network.protocol.version` — protocol version (e.g. `1.1`, `2` for HTTP/2)
+  * `server.address` — logical server host
+  * `server.port` — logical server port
+  * `network.peer.address` / `network.peer.port` — connection endpoint, when available
+  * Captured request/response headers per configuration (`http.request.header.<name>` / `http.response.header.<name>`)
 
 If a request fails, the span is ended and the error is recorded.