From 8ecd2af5199d1575c1ac58f705769834a95fc036 Mon Sep 17 00:00:00 2001 From: Erica Pisani Date: Fri, 26 Jun 2026 14:54:09 -0400 Subject: [PATCH 1/5] docs(sdk): add database query params to data-collection spec Within the Python SDK, the existing `send_default_pii` gates the inclusion of database parameters in spans and events for integrations such as `pymongo`, `redis`, and `clickhouse_driver`. There were previously no parameters within the spec that allowed for control over the inclusion or filtering of these values, so introducing these changes to close that gap. --- .../sdk/foundations/client/data-collection/index.mdx | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/develop-docs/sdk/foundations/client/data-collection/index.mdx b/develop-docs/sdk/foundations/client/data-collection/index.mdx index beb762de7be45..bf3c0a11743ea 100644 --- a/develop-docs/sdk/foundations/client/data-collection/index.mdx +++ b/develop-docs/sdk/foundations/client/data-collection/index.mdx @@ -8,6 +8,9 @@ spec_depends_on: - id: sdk/foundations/client version: ">=1.0.0" spec_changelog: + - version: 0.5.0 + date: 2026-06-26 + summary: Include configuration for database queries. - version: 0.4.0 date: 2026-06-12 summary: Added documentation requirements for default behavior and setup snippet opt-out comment with link to full dataCollection docs. @@ -70,7 +73,7 @@ Personally Identifiable Information (PII) or user-linked data. Examples include, - Contact (email, phone number, address) - IP address - Cookies and headers that identify the user or session -- HTTP request data (TBD) +- HTTP request data or database query parameters (TBD) For context types that may carry PII fields (e.g. `device_unique_identifier` in [Device Context](/sdk/foundations/transport/event-payloads/contexts/#device-context), or fields in the [User Interface](/sdk/foundations/transport/event-payloads/user/)), see the linked specs. @@ -530,6 +533,9 @@ init({ inputs?: boolean // default: true outputs?: boolean // default: true }, + database?: { + queryParams?: boolean // default: true + }, stackFrameVariables?: boolean, // default: true frameContextLines?: integer, // default: 5 (see boolean fallback below) }, @@ -544,6 +550,7 @@ init({ | `httpBodies` | `string[]` (body types) | all valid body types | 0.1.0 | List of body types to collect. Omitted = all body types valid for the platform; empty array (`[]`) = off. Valid values: `"incomingRequest"`, `"outgoingRequest"`, `"incomingResponse"`, `"outgoingResponse"`. Default changed from `[]` (off) to all valid body types in 0.2.0. | | `queryParams` | Key-value collection | `{ mode: "denyList" }` | 0.1.0 | Collect URL query parameters. All key names are always included; the SDK scrubs values for keys matching the sensitive denylist or custom allow/deny terms. | | `genAI` | `{ inputs?, outputs? }` | Both `true` | 0.1.0 | For `inputs`: Include the content of generative AI inputs (e.g. prompt text, tool call arguments).

For `outputs`: Include the content of generative AI outputs (e.g. completion text, tool call results). Metadata such as model name and token counts is always collected regardless of these settings. | +| `database` | `{ queryParams? }` | `true` | 0.5.0 | Include parameters/arguments passed to database queries. Setting this to false will either omit the value altogether, or replace the value with '[Filtered]' | | `stackFrameVariables` | Boolean | `true` | 0.1.0 | Include local variable values captured within stack frames. | | `frameContextLines` | Integer (`Boolean` fallback) | `5` (`true`) | 0.1.0 | Number of source code lines to include above and below each stack frame.
**`Boolean` fallback:** Not all platforms support integer configuration values. SDKs **MAY** accept a boolean, where `true` is equivalent to the platform default (typically `5`) and `false` is equivalent to `0` (no context lines). SDKs **SHOULD** prefer accepting an integer when their platform supports it. | From 107636147280cd1eb5166e9611751b6baf1c9698 Mon Sep 17 00:00:00 2001 From: Erica Pisani Date: Fri, 26 Jun 2026 15:07:07 -0400 Subject: [PATCH 2/5] cleanup --- develop-docs/sdk/foundations/client/data-collection/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/develop-docs/sdk/foundations/client/data-collection/index.mdx b/develop-docs/sdk/foundations/client/data-collection/index.mdx index bf3c0a11743ea..3fbd4c84159c4 100644 --- a/develop-docs/sdk/foundations/client/data-collection/index.mdx +++ b/develop-docs/sdk/foundations/client/data-collection/index.mdx @@ -116,7 +116,7 @@ SDK documentation **MUST** document the default value and behavior of each `data - + ### Setup Snippet Opt-Out Comment @@ -550,7 +550,7 @@ init({ | `httpBodies` | `string[]` (body types) | all valid body types | 0.1.0 | List of body types to collect. Omitted = all body types valid for the platform; empty array (`[]`) = off. Valid values: `"incomingRequest"`, `"outgoingRequest"`, `"incomingResponse"`, `"outgoingResponse"`. Default changed from `[]` (off) to all valid body types in 0.2.0. | | `queryParams` | Key-value collection | `{ mode: "denyList" }` | 0.1.0 | Collect URL query parameters. All key names are always included; the SDK scrubs values for keys matching the sensitive denylist or custom allow/deny terms. | | `genAI` | `{ inputs?, outputs? }` | Both `true` | 0.1.0 | For `inputs`: Include the content of generative AI inputs (e.g. prompt text, tool call arguments).

For `outputs`: Include the content of generative AI outputs (e.g. completion text, tool call results). Metadata such as model name and token counts is always collected regardless of these settings. | -| `database` | `{ queryParams? }` | `true` | 0.5.0 | Include parameters/arguments passed to database queries. Setting this to false will either omit the value altogether, or replace the value with '[Filtered]' | +| `database` | `{ queryParams? }` | `true` | 0.5.0 | Include parameters/arguments passed to database queries. Setting this to false will either omit the value altogether, or replace the value with '[Filtered]'. | | `stackFrameVariables` | Boolean | `true` | 0.1.0 | Include local variable values captured within stack frames. | | `frameContextLines` | Integer (`Boolean` fallback) | `5` (`true`) | 0.1.0 | Number of source code lines to include above and below each stack frame.
**`Boolean` fallback:** Not all platforms support integer configuration values. SDKs **MAY** accept a boolean, where `true` is equivalent to the platform default (typically `5`) and `false` is equivalent to `0` (no context lines). SDKs **SHOULD** prefer accepting an integer when their platform supports it. | From 7437ed5f061b4e182f951750fe96139d952f6f6f Mon Sep 17 00:00:00 2001 From: Erica Pisani Date: Fri, 26 Jun 2026 15:10:37 -0400 Subject: [PATCH 3/5] changed the wrong tag --- develop-docs/sdk/foundations/client/data-collection/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/develop-docs/sdk/foundations/client/data-collection/index.mdx b/develop-docs/sdk/foundations/client/data-collection/index.mdx index 3fbd4c84159c4..32717000bb34a 100644 --- a/develop-docs/sdk/foundations/client/data-collection/index.mdx +++ b/develop-docs/sdk/foundations/client/data-collection/index.mdx @@ -2,7 +2,7 @@ title: Data Collection description: Configuration for what data SDKs collect by default, including technical context, PII, and sensitive data. spec_id: sdk/foundations/client/data-collection -spec_version: 0.4.0 +spec_version: 0.5.0 spec_status: candidate spec_depends_on: - id: sdk/foundations/client @@ -116,7 +116,7 @@ SDK documentation **MUST** document the default value and behavior of each `data - + ### Setup Snippet Opt-Out Comment From 99b50890649e637666c10cfe3d6764bd514aecf0 Mon Sep 17 00:00:00 2001 From: Erica Pisani Date: Fri, 26 Jun 2026 15:24:05 -0400 Subject: [PATCH 4/5] update the migration sample config --- develop-docs/sdk/foundations/client/data-collection/index.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/develop-docs/sdk/foundations/client/data-collection/index.mdx b/develop-docs/sdk/foundations/client/data-collection/index.mdx index 32717000bb34a..6599a59668214 100644 --- a/develop-docs/sdk/foundations/client/data-collection/index.mdx +++ b/develop-docs/sdk/foundations/client/data-collection/index.mdx @@ -650,6 +650,9 @@ init({ inputs: false, outputs: false, }, + database: { + queryParams: false, + }, httpHeaders: { deny: ["forwarded", "-ip", "remote-", "via", "-user"] }, cookies: { deny: ["forwarded", "-ip", "remote-", "via", "-user"] }, queryParams: { deny: ["forwarded", "-ip", "remote-", "via", "-user"] }, From a87575d6bd04ebdb5bde21abc65c9673b9ad0e1c Mon Sep 17 00:00:00 2001 From: Erica Pisani Date: Mon, 29 Jun 2026 11:57:18 -0400 Subject: [PATCH 5/5] update date --- develop-docs/sdk/foundations/client/data-collection/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop-docs/sdk/foundations/client/data-collection/index.mdx b/develop-docs/sdk/foundations/client/data-collection/index.mdx index 943bd508d0982..5dc999ee85b90 100644 --- a/develop-docs/sdk/foundations/client/data-collection/index.mdx +++ b/develop-docs/sdk/foundations/client/data-collection/index.mdx @@ -9,7 +9,7 @@ spec_depends_on: version: ">=1.0.0" spec_changelog: - version: 0.6.0 - date: 2026-06-26 + date: 2026-06-29 summary: Include configuration for database queries. - version: 0.5.0 date: 2026-06-26