Skip to content
Open
Changes from all commits
Commits
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
47 changes: 47 additions & 0 deletions develop-docs/sdk/telemetry/traces/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -156,6 +156,53 @@ Examples:
`[403, 404]`: don't sample transactions corresponding to requests with status code 403 or 404
`[[300, 399], [401, 404]]`: don't sample transactions corresponding to requests with status codes between 300 and 399 (inclusive) or between 401 and 404 (inclusive)

### `enableDbQuerySource`

This MUST be a boolean value that defaults to `true`.

The option controls if attributes with code source information are set on database query spans when the query duration exceeds a given threshold.

The following attributes, or a subset thereof, SHOULD be set on database query spans if the threshold is exceeded.
Values for some of the attributes below may be unavailable in some situations for the SDK, and in these cases a subset MAY be provided.

The attributes are described in <Link to="https://getsentry.github.io/sentry-conventions/generated/attributes/code.html">Sentry's Span Convention Documentation</Link>.

- code.file.path
- code.function.name
- code.line.number

### `dbQuerySourceThresholdMs`

A threshold duration, which MUST be a floating point or integer value.
The value specifies, in milliseconds, the duration of a database query before code source information is added.

The default value is platform-dependent and SHOULD balance the overhead of adding the information with its utility for queries that exceed the threshold duration for users of the SDK.
In Python and PHP Laravel, the default threshold is 100 milliseconds.

### `enableHttpRequestSource`

This MUST be a boolean value that defaults to `true`.

The option controls if attributes with code source information are set on outgoing HTTP requests.
When enabled, the attributes SHOULD be attached only when the time to receive the response from sending the request exceeds a given threshold.

The following attributes, or a subset thereof, SHOULD be set if the threshold is exceeded.
Values for some of the attributes below may be unavailable in some situations for the SDK, and in these cases a subset MAY be provided.

The attributes are described in <Link to="https://getsentry.github.io/sentry-conventions/generated/attributes/code.html">Sentry's Span Convention Documentation</Link>.

- code.file.path
- code.function.name
- code.line.number

### `httpRequestSourceThresholdMs`

A threshold duration, which MUST be a floating point or integer value.
The value specifies, in milliseconds, the time between sending an HTTP request and receiving its response, after which code source information is added.

The default value is platform-dependent and SHOULD balance the overhead of adding the information with its utility for request-response cycles that exceed the threshold duration for users of the SDK.


## `Event` Changes

As of writing, transactions are implemented as an extension of the `Event`
Expand Down
Loading