Skip to content

docs(sdk): Add queue arguments configuration to data collection spec#18637

Open
ericapisani wants to merge 2 commits into
masterfrom
py-2577-queue-args-datacollection
Open

docs(sdk): Add queue arguments configuration to data collection spec#18637
ericapisani wants to merge 2 commits into
masterfrom
py-2577-queue-args-datacollection

Conversation

@ericapisani

@ericapisani ericapisani commented Jul 3, 2026

Copy link
Copy Markdown
Member

Adds documentation for the queues.taskArguments configuration option, which controls whether arguments passed to tasks within queues are collected. Bumps the data collection spec to version 0.7.0.

  • Add queues.taskArguments option to client options table and init snippets
  • Note task queue arguments as a PII-adjacent data type
  • Bump spec_version to 0.7.0 with changelog entry

Fixes PY-2577
Fixes getsentry/sentry-python#6737

Document the `queues.taskArguments` option for controlling collection
of arguments passed to tasks within queues. Bump spec_version to 0.7.0
and update the changelog accordingly.
@linear-code

linear-code Bot commented Jul 3, 2026

Copy link
Copy Markdown

PY-2577

@vercel

vercel Bot commented Jul 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Jul 3, 2026 1:56pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored Preview Jul 3, 2026 1:56pm

Request Review

@github-actions github-actions Bot added the sdk-develop-docs PRs touching develop-docs/sdk label Jul 3, 2026
@ericapisani ericapisani marked this pull request as ready for review July 3, 2026 13:45
Comment thread develop-docs/sdk/foundations/client/data-collection/index.mdx Outdated
queryParams?: boolean // default: true
},
queues?: {
taskArguments?: boolean // default: true

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Putting this in a dict may be overkill - can we foresee any other data collection controls we may want to add in the context of queues? If it's just task arguments I can update this to just be a boolean

@ericapisani ericapisani requested a review from cleptric July 3, 2026 13:49
| `graphql` | `{ document?, variables? }` | Both `true` | 0.5.0 | For `document`: Collect the GraphQL document. <br /><br /> For `variables`: Collect the variables that are passed to GraphQL operations. |
| `genAI` | `{ inputs?, outputs? }` | Both `true` | 0.1.0 | For `inputs`: Include the content of generative AI inputs (e.g. prompt text, tool call arguments). <br /><br /> 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.6.0 | Include parameters/arguments passed to database queries. Setting this to false will either omit the value altogether, or replace the value with '[Filtered]'. |
| `queues` | `{ taskArguments? }` | `true` | 0.7.0 | Include arguments passed to tasks within queues. Setting this to false will replace the value with '[Filtered]'. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: The documentation for queues.taskArguments describes a different behavior for disabling data collection compared to the similar database.queryParams option, which could lead to inconsistent SDK implementations.
Severity: MEDIUM

Suggested Fix

Align the behavior description for queues.taskArguments with database.queryParams. Either allow both omitting the value and replacing it with '[Filtered]', or explicitly justify in the documentation why the behavior for queues is intentionally more restrictive.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: develop-docs/sdk/foundations/client/data-collection/index.mdx#L569

Potential issue: The documentation for the new `queues.taskArguments` option states that
setting it to `false` will "replace the value with '[Filtered]'", which is inconsistent
with the existing `database.queryParams` option. The description for
`database.queryParams` says that setting it to `false` will "either omit the value
altogether, or replace the value with '[Filtered]'”. This inconsistency in the
specification for similar features risks different implementations across SDKs, leading
to a confusing and inconsistent experience for developers using different Sentry SDKs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

sdk-develop-docs PRs touching develop-docs/sdk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update data collection spec to support queue args

1 participant