feat(asyncpg): add capture_connection_cleanup option to silence pool cleanup spans

[RiyaChaturvedi37]

Closes #4264

Description

Adds a new exclude_queries option to AsyncPGInstrumentor to allow
silencing specific queries from being traced.

When using a connection pool, asyncpg executes cleanup statements after
each invocation:

• SELECT pg_advisory_unlock_all()
• CLOSE ALL
• UNLISTEN *
• RESET ALL

These can pollute traces. Users can now exclude them:

AsyncPGInstrumentor(exclude_queries=AsyncPGInstrumentor._CLEANUP_QUERIES).instrument()

The option accepts any set of queries, making it flexible for other use cases too.

Type of change

• New feature (non-breaking change which adds functionality)

[tammy-baylis-swi]

Thank you for this @RiyaChaturvedi37 ! I have added some comments

[RiyaChaturvedi37]

Note: The large diff (+2440/-2389) is due to Windows line ending (CRLF) differences in the existing file on my local machine. The actual code changes are minimal — only 3 files with the new feature, tests, and changelog entry. I apologize for the noise!

[tammy-baylis-swi]

Thank you for fixes, lgtm! Just suggested a small docs update. The Maintainers will also have to review this.

[RiyaChaturvedi37]

Thank you for fixes, lgtm! Just suggested a small docs update. The Maintainers will also have to review this.

Done! Added the clarifying comment as suggested.

[github-actions]

This PR has been automatically marked as stale because it has not had any activity for 14 days. It will be closed if no further activity occurs within 14 days of this comment.
If you're still working on this, please add a comment or push new commits.

[RiyaChaturvedi37]

Still actively working on this! Will resolve the CHANGELOG conflict shortly.

[RiyaChaturvedi37]

Still actively working on this! Just resolved the CHANGELOG conflict and all checks are passing.

Also updated the implementation based on @xrmx's feedback — replaced capture_connection_cleanup with the more flexible exclude_queries parameter:

AsyncPGInstrumentor(exclude_queries=AsyncPGInstrumentor._CLEANUP_QUERIES).instrument()

This allows users to exclude any custom set of queries, not just the cleanup ones.

[emdneto]

Thanks for the PR!

Just a heads-up: we no longer update CHANGELOG.md directly. The changelog is now generated from changelog fragments using Towncrier.

Please add the appropriate changelog fragment for this change instead of editing CHANGELOG.md manually. You can find the instructions and expected format in CONTRIBUTING.md.

[github-actions]

This PR has been automatically marked as stale because it has not had any activity for 14 days. It will be closed if no further activity occurs within 14 days of this comment.
If you're still working on this, please add a comment or push new commits.