getsentry / sentry-docs

Sentry's documentation (and tools to build it)
https://docs.sentry.io
Other
341 stars 1.48k forks source link

SDK dev docs for User Feedback v2 #11635

Open bruno-garcia opened 1 month ago

bruno-garcia commented 1 month ago

Which section?

SDK -> Expected Feature -> User Feedback

Page URL

https://develop.sentry.dev/sdk/expected-features/#user-feedback

Description

Copying from the old repo, which got archived:

The current User Feedback SDK is documented here: https://develop.sentry.dev/sdk/features/#user-feedback

With the new feedback product allowing for capture of feedback outside errors. With the ability to include attachments (e.g: screenshots), tags, and other user context. The protocol has been expanded.

A new API is also being done on JS. Aligning on a new function captureFeedback. The previous captureUserFeedback can be deprecated in favor of the new.

The eventId that we took before is now optional. And the plan is to rename it to something else since the feedback itself will have an id, and eventId is ambiguous.

Document the new envelope format too. Mark the old one as deprecated.

This will unblock in particular the Mobile SDKs

Relates to:

Suggested Solution

Clarify the new API and guidelines

aliu39 commented 1 month ago

The linked PR truncates messages to 4096 characters on Sentry backend, and doesn't error. It is not aware of bytes/encodings, since this is way after envelope processing. This is meant as a temporary measure before we add limits in the envelope schema, and dropped outcomes in Relay.

Until we have updates on the schema, I'd recommend documenting "4096 characters max per message".

getsantry[bot] commented 3 weeks ago

Routing to @getsentry/product-owners-user-feedback for triage ⏲️