Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(perf): Requests module SDK instrumentation documentation #9963

Merged
merged 9 commits into from
May 9, 2024

Conversation

gggritso
Copy link
Member

@gggritso gggritso commented May 8, 2024

I'm following the template set up for the Caches documentation! Adding manual instrumentation docs for JavaScript and Python, and linking to the snippets from the module documentation. Very similar to #9926

Copy link

vercel bot commented May 8, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
sentry-docs 🛑 Canceled (Inspect) May 9, 2024 4:05pm

@gggritso gggritso marked this pull request as ready for review May 8, 2024 17:16
@gggritso gggritso requested review from bcoe and lizokm May 8, 2024 17:16
Copy link

codecov bot commented May 8, 2024

Bundle Report

Changes will increase total bundle size by 527 bytes ⬆️

Bundle name Size Change
sentry-docs-server 7.43MB 534 bytes ⬆️
sentry-docs-edge-server 456.19kB 3 bytes ⬇️
sentry-docs-client 6.16MB 4 bytes ⬇️

Copy link
Member

@bcoe bcoe left a comment

Choose a reason for hiding this comment

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

A couple small optional suggestions.

:shipit:

span?.setAttribute('server.address', parsedURL.hostname);
span?.setAttribute('server.port', parsedURL.port || undefined);

span?.setAttribute('http.response.status_code', response.status);
Copy link
Member

Choose a reason for hiding this comment

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

I like the use of optional chaining 👍 makes me question why I used an if statement in my docs.

@@ -21,24 +21,15 @@ On the [**Requests** page](#requests-page), you get an overview of the domains t
></iframe>
</div>

## Prerequisites
## Prerequisites and Limitations

<Note>
Network requests using non-HTTP protocols (FTP, WebSocket, etc.) are not supported at this time.
</Note>

Availability of HTTP request monitoring depends on the SDK your application uses. In most cases, Sentry's SDKs automatically enable HTTP request tracking. You can check your SDK's <PlatformLink to="/performance/instrumentation/automatic-instrumentation">automatic instrumentation documentation</PlatformLink> to see if it includes tracking HTTP requests.

Copy link
Member

Choose a reason for hiding this comment

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

NIt, I might add a heading "Custom Instrumentation" to draw people's attention to this option.

Also, worth a discussion about whether we should suggest setting network.protoco.name, network.protocol.version, if people try to instrument an HTTP/2 connection?

Copy link
Member Author

Choose a reason for hiding this comment

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

🤔 I can add this to our span data conventions!

Copy link
Contributor

@lizokm lizokm 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 adding.

gggritso and others added 6 commits May 9, 2024 11:33
Co-authored-by: Liza Mock <liza.mock@sentry.io>
Co-authored-by: Liza Mock <liza.mock@sentry.io>
Co-authored-by: Liza Mock <liza.mock@sentry.io>
Co-authored-by: Liza Mock <liza.mock@sentry.io>
Co-authored-by: Liza Mock <liza.mock@sentry.io>
@gggritso gggritso merged commit 8c5f6f9 into master May 9, 2024
6 checks passed
@gggritso gggritso deleted the feat/perf/requests-module-sdk-documentation branch May 9, 2024 16:19
antonpirker pushed a commit that referenced this pull request May 14, 2024
* Link to custom instrumentation docs
* Add JavaScript platform docs
* Add Python platform docs

---------

Co-authored-by: Liza Mock <liza.mock@sentry.io>
@github-actions github-actions bot locked and limited conversation to collaborators May 25, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants