Skip to content

Conversation

tammy-baylis-swi
Copy link
Contributor

@tammy-baylis-swi tammy-baylis-swi commented Aug 29, 2025

Description

Updates the DB-API instrumentor readthedocs with sqlcommenter information. Adds encouragement to use concrete db client framework/ORM instrumentors instead, if they exist (e.g. psycopg2, mysqlclient, etc).

Changes and suggestions here will be the "foundation" for fixing the readthedocs of those concrete instrumentors later in another PR.

Partially fixes #3162

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

  1. Virtualenv in Python 3.11
  2. tox -e docs
  3. Check local build in docs/_build/html/instrumentation/dbapi/dbapi.html

Does This PR Require a Core Repo Change?

  • Yes. - Link to PR:
  • No.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

  • Followed the style guidelines of this project
  • Changelogs have been updated
  • Unit tests have been added
  • Documentation has been updated

@tammy-baylis-swi tammy-baylis-swi changed the title Update DB-API instrumentor docs Update DB-API instrumentor readthedocs with sqlcommenter guide Aug 29, 2025


# Opts into sqlcomment for MySQL trace integration.
wrap_connect(
Copy link
Contributor Author

@tammy-baylis-swi tammy-baylis-swi Aug 29, 2025

Choose a reason for hiding this comment

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

We only describe wrap_connect here onwards instead of trace_integration, as the latter does not support commenter_options. I'll create and link a new issue for a code change:

#3726

@tammy-baylis-swi tammy-baylis-swi moved this to Easy to review / merge / close in @xrmx's Python PR digest Sep 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Easy to review / merge / close
Development

Successfully merging this pull request may close these issues.

Improve documentation of instrumentation's sqlcommenter feature
2 participants