Add warning about db.statement cardinality

tammy-baylis-swi · tammy-baylis-swi · commit 5a5b9bf1249a · 2025-10-17T19:54:04.000-07:00
diff --git a/instrumentation/opentelemetry-instrumentation-psycopg/src/opentelemetry/instrumentation/psycopg/__init__.py b/instrumentation/opentelemetry-instrumentation-psycopg/src/opentelemetry/instrumentation/psycopg/__init__.py
@@ -134,6 +134,9 @@
         enable_attribute_commenter=True,
     )
 
+Warning:
+    Capture of sqlcomment in ``db.statement`` may have high cardinality without platform normalization. See `Semantic Conventions for database spans <https://opentelemetry.io/docs/specs/semconv/database/database-spans/#generating-a-summary-of-the-query-text>`_ for more information.
+
 API
 ---
 """
diff --git a/instrumentation/opentelemetry-instrumentation-psycopg2/src/opentelemetry/instrumentation/psycopg2/__init__.py b/instrumentation/opentelemetry-instrumentation-psycopg2/src/opentelemetry/instrumentation/psycopg2/__init__.py
@@ -133,6 +133,8 @@
         enable_attribute_commenter=True,
     )
 
+Warning:
+    Capture of sqlcomment in ``db.statement`` may have high cardinality without platform normalization. See `Semantic Conventions for database spans <https://opentelemetry.io/docs/specs/semconv/database/database-spans/#generating-a-summary-of-the-query-text>`_ for more information.
 
 API
 ---

Original file line number	Diff line number	Diff line change
`@@ -134,6 +134,9 @@`
`134`	`134`	`enable_attribute_commenter=True,`
`135`	`135`	`)`
`136`	`136`
	`137`	`+Warning:`
	`138`	+ Capture of sqlcomment in ``db.statement`` may have high cardinality without platform normalization. See `Semantic Conventions for database spans <https://opentelemetry.io/docs/specs/semconv/database/database-spans/#generating-a-summary-of-the-query-text>`_ for more information.
	`139`	`+`
`137`	`140`	`API`
`138`	`141`	`---`
`139`	`142`	`"""`
Original file line number	Diff line number	Diff line change
`@@ -133,6 +133,8 @@`
`133`	`133`	`enable_attribute_commenter=True,`
`134`	`134`	`)`
`135`	`135`
	`136`	`+Warning:`
	`137`	+ Capture of sqlcomment in ``db.statement`` may have high cardinality without platform normalization. See `Semantic Conventions for database spans <https://opentelemetry.io/docs/specs/semconv/database/database-spans/#generating-a-summary-of-the-query-text>`_ for more information.
`136`	`138`
`137`	`139`	`API`
`138`	`140`	`---`