Add note about required obfuscator option for APM linking in DBM inte…

…grations (#19191)

* Add note about required option for APM linking

* Update review feedback

* Split link to a new line

mysql/assets/configuration/spec.yaml

@@ -665,6 +665,8 @@ files:
                 description: |
                   Set to `false` to disable the collection of comments in your SQL statements.
                   Requires `collect_metadata: true`.
+                  Note: This option must be `true` in order to correlate Database Monitoring samples and APM traces.
+                  See https://docs.datadoghq.com/database_monitoring/connect_dbm_and_apm
                 value:
                   type: boolean
                   example: true

mysql/datadog_checks/mysql/data/conf.yaml.example

@@ -609,6 +609,8 @@ instances:
         ## @param collect_comments - boolean - optional - default: true
         ## Set to `false` to disable the collection of comments in your SQL statements.
         ## Requires `collect_metadata: true`.
+        ## Note: This option must be `true` in order to correlate Database Monitoring samples and APM traces.
+        ## See https://docs.datadoghq.com/database_monitoring/connect_dbm_and_apm
         #
         # collect_comments: true
 

postgres/assets/configuration/spec.yaml

@@ -888,6 +888,8 @@ files:
           description: |
             Set to `false` to disable the collection of comments in your SQL statements.
             Requires `collect_metadata: true`.
+            Note: This option must be `true` in order to correlate Database Monitoring samples and APM traces.
+            See https://docs.datadoghq.com/database_monitoring/connect_dbm_and_apm
           value:
             type: boolean
             example: true

postgres/datadog_checks/postgres/data/conf.yaml.example

@@ -778,6 +778,8 @@ instances:
         ## @param collect_comments - boolean - optional - default: true
         ## Set to `false` to disable the collection of comments in your SQL statements.
         ## Requires `collect_metadata: true`.
+        ## Note: This option must be `true` in order to correlate Database Monitoring samples and APM traces.
+        ## See https://docs.datadoghq.com/database_monitoring/connect_dbm_and_apm
         #
         # collect_comments: true
 

sqlserver/assets/configuration/spec.yaml

@@ -744,6 +744,8 @@ files:
           description: |
             Set to `false` to disable the collection of comments in your SQL statements.
             Requires `collect_metadata: true`.
+            Note: This option must be `true` in order to correlate Database Monitoring samples and APM traces.
+            See https://docs.datadoghq.com/database_monitoring/connect_dbm_and_apm
           value:
             type: boolean
             example: true

sqlserver/datadog_checks/sqlserver/data/conf.yaml.example

@@ -544,6 +544,8 @@ instances:
         ## @param collect_comments - boolean - optional - default: true
         ## Set to `false` to disable the collection of comments in your SQL statements.
         ## Requires `collect_metadata: true`.
+        ## Note: This option must be `true` in order to correlate Database Monitoring samples and APM traces.
+        ## See https://docs.datadoghq.com/database_monitoring/connect_dbm_and_apm
         #
         # collect_comments: true