diff --git a/develop-docs/sdk/telemetry/traces/index.mdx b/develop-docs/sdk/telemetry/traces/index.mdx index c69f5111c4319..b937c00c30a09 100644 --- a/develop-docs/sdk/telemetry/traces/index.mdx +++ b/develop-docs/sdk/telemetry/traces/index.mdx @@ -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 Sentry's Span Convention Documentation. + +- 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 Sentry's Span Convention Documentation. + +- 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`