-
Task
-
Resolution: Done
-
Major
-
None
-
None
-
2
-
False
-
-
False
-
-
The SQL Server schema history documentation was not updated to show the revised MBean format, which includes a reference the same `task` attribute that is used in the snapshot and streaming metrics MBeans.
As with the other MBean names, the name should be referenced as an `include` directive from a new entry in the shared file /partials/frag-common-mbean-name.adoc
UPDATE: The source for the schema history metrics MBean name in the SQL Server doc is the shared file ref-connector-monitoring-schema-history-metrics.adoc.
This file is imported via an include directive on L3605.
This file is also used by all of the other relational DB connectors that support schema histories. It provides the table of schema history metrics.
The complicating factor for this issue is that the file also provides the schema-history MBean name.
To correct the MBean name, rather than having the different connector docs import the file wholesale, we can take the approach of extracting the MBean name separately from the rest of the file. This can be done in one of the following ways:
- Remove the MBean name from the shared file ref-connector-monitoring-schema-history-metrics.adoc and list it at the beginning of the Schema history metrics topic of the hosting connector file. This mirrors the approach currently used to provide the Customized MBean names topic. This approach has the advantage of keeping the content close to where it's used, simplifying the structure.
- Remove the MBean name from the shared file.
** Add entries for the common and SQL Server-specific schema history MBean names to the fragment file /partials/frag-common-mbean-name.adoc. This would facilitate global changes should they be necessary.
** In the Schema history metrics topic in each connector file (Db2, MariaDB, MySQL, Oracle, SQL Server), precede the current include directive that imports the metrics table with a new directive that uses a tagged region to import the name from the fragment file. All connectors except SQL Server use the common schema history MBean name (common-schema-history) - Retain the MBean name definition in its current shared file location, and define the following three separate tagged regions in the file:
- The common schema history MBean name (used by the other relational connectors
- The SQL Server schema history MBean name.
- The shared metrics table content
This approach would then require replacing the existing single include directive in each connector file with two separate include directives (for the MBean name and the metrics table content).
- relates to
-
DBZ-8137 Error registering JMX signal and notification for multi task SQLServer
-
- Closed
-