Skip to content

docs(js): Add docs on passing headers to server action instrumentation #16351

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.

Sign up for GitHub

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

Merged
chargome merged 2 commits into from
Feb 11, 2026
Merged

docs(js): Add docs on passing headers to server action instrumentation #16351

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d88bf76
add headers docs
chargome Feb 11, 2026
6bbd974
update why manual
chargome Feb 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/platforms/javascript/guides/nextjs/manual-setup/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -286,11 +286,14 @@ Wrap your Server Actions with `Sentry.withServerActionInstrumentation()`.
```typescript {filename:app/actions.ts}
"use server";
import * as Sentry from "@sentry/nextjs";
import { headers } from "next/headers";

export async function submitForm(formData: FormData) {
return Sentry.withServerActionInstrumentation(
"submitForm", // Action name for Sentry
{
headers: await headers(), // Connect client and server traces
formData, // Attach form data to events
recordResponse: true, // Include response data
},
async () => {
Expand Down
13 changes: 9 additions & 4 deletions docs/platforms/javascript/guides/nextjs/tracing/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,8 @@ Server Actions are **not** automatically instrumented. Without wrapping, they ap
Use `withServerActionInstrumentation` to:
- Create named spans for each action
- Capture timing and errors
- Connect client and server traces
- Connect client and server traces via `headers`
- Attach form data to Sentry events via `formData`

</SplitSectionText>
<SplitSectionCode>
Expand Down Expand Up @@ -148,9 +149,9 @@ export async function createOrder(formData: FormData) {
<SplitSection>
<SplitSectionText>

### With Headers
### With Headers and Form Data

Pass headers to connect client-side traces with server-side spans. This enables full distributed tracing across the browser-to-server boundary.
Pass `headers` to connect client-side traces with server-side spans for full distributed tracing across the browser-to-server boundary. Pass `formData` to attach submitted form data to Sentry events for easier debugging.

</SplitSectionText>
<SplitSectionCode>
Expand All @@ -164,7 +165,11 @@ import { headers } from "next/headers";
export async function submitForm(formData: FormData) {
return Sentry.withServerActionInstrumentation(
"submitForm",
{ headers: await headers() },
{
headers: await headers(), // Connect client and server traces
formData, // Attach form data to events
recordResponse: true, // Include response data
},
async () => {
// Action logic with full trace context
}
Expand Down