Skip to content

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

Merged
LikeTheSalad merged 1 commit intoopen-telemetry:mainfrom
ashishvz:docs/readme-stable-http-semconv
Apr 15, 2026
Merged

docs: align HTTP client READMEs with stable semantic conventions#1683
LikeTheSalad merged 1 commit intoopen-telemetry:mainfrom
ashishvz:docs/readme-stable-http-semconv

Conversation

@ashishvz
Copy link
Copy Markdown
Contributor

@ashishvz ashishvz commented Apr 13, 2026

Summary

We debugged and tested client HTTP spans from a sample app and confirmed the instrumentation stack already emits the latest stable HTTP semantic conventions (for example http.response.status_code, http.request.method, and url.full). No code changes were required.

This PR only updates READMEs so the documented attribute names match what we saw at runtime:

  • instrumentation/okhttp3/README.md
  • instrumentation/httpurlconnection/README.md

Fixes #1393

Verification

See screenshot below: client span attributes from a real request (e.g. HTTPS GET) showing stable keys including http.response.status_code and related HTTP / network fields.

Screenshot 2026-04-13 at 4 34 49 PM

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 open-telemetry#1393

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

Made-with: Cursor
@ashishvz ashishvz requested a review from a team as a code owner April 13, 2026 11:56
@linux-foundation-easycla
Copy link
Copy Markdown

linux-foundation-easycla bot commented Apr 13, 2026

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: ashishvz / name: ashishvz (ce16de9)

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 13, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 62.00%. Comparing base (4473998) to head (ce16de9).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1683      +/-   ##
==========================================
- Coverage   62.09%   62.00%   -0.09%     
==========================================
  Files         159      159              
  Lines        3411     3411              
  Branches      345      345              
==========================================
- Hits         2118     2115       -3     
- Misses       1199     1201       +2     
- Partials       94       95       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Copy Markdown
Member

@fractalwrench fractalwrench left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - thanks for investigating this.

@LikeTheSalad LikeTheSalad merged commit b808561 into open-telemetry:main Apr 15, 2026
7 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

For android network instrumentation spans we should use http.response.status_code for status code

3 participants