Collect prism central version metadata (DataDog#23071)

* collect prism central version metadata

* changelog

Author: NouemanKHAL

nutanix/changelog.d/23071.added

@@ -0,0 +1 @@
+Collect prism central version metadata

nutanix/datadog_checks/nutanix/infrastructure_monitor.py

@@ -140,6 +140,7 @@ def collect_cluster_metrics(self) -> None:
 
             if self._is_prism_central_cluster(cluster):
                 self.check.log.info("[%s] Skipping Prism Central cluster: %s", pc_label, cluster_name)
+                self._collect_pc_version_metadata(cluster)
                 skipped += 1
                 continue
 
@@ -191,6 +192,18 @@ def _is_prism_central_cluster(self, cluster: dict) -> bool:
         cluster_function = get_nested(cluster, "config/clusterFunction") or []
         return "PRISM_CENTRAL" in cluster_function
 
+    def _collect_pc_version_metadata(self, pc_cluster: dict) -> None:
+        """Collect and report version metadata from the Prism Central cluster."""
+        version = get_nested(pc_cluster, "config/buildInfo/version")
+        if version:
+            self.check.set_metadata(
+                'version',
+                version,
+                scheme='regex',
+                pattern=r'(?P<major>\d+)\.(?P<minor>\d+)',
+                final_scheme='semver',
+            )
+
     def _process_cluster(self, cluster: dict, pc_label: str) -> None:
         """Process and report metrics for a single cluster."""
         cluster_id = cluster.get("extId", "unknown")

nutanix/tests/test_metadata.py

@@ -39,6 +39,46 @@
 OPTIONAL_METRICS = CLUSTER_STATS_METRICS_OPTIONAL + HOST_STATS_METRICS_OPTIONAL + VM_STATS_METRICS_OPTIONAL
 
 
+@pytest.mark.unit
+def test_version_metadata(dd_run_check, mock_instance, mock_http_get, datadog_agent):
+    check = NutanixCheck('nutanix', {}, [mock_instance])
+    check.check_id = 'test:123'
+    dd_run_check(check)
+
+    datadog_agent.assert_metadata(
+        'test:123',
+        {'version.scheme': 'semver', 'version.major': '7', 'version.minor': '3', 'version.raw': '7.3'},
+    )
+
+
+@pytest.mark.unit
+@pytest.mark.parametrize(
+    'version, expected_major, expected_minor',
+    [
+        ('7.3', '7', '3'),
+        ('pc.7.3', '7', '3'),
+        ('pc.7.5', '7', '5'),
+        ('pc.2024.3', '2024', '3'),
+    ],
+)
+def test_version_metadata_formats(mock_instance, datadog_agent, version, expected_major, expected_minor):
+    check = NutanixCheck('nutanix', {}, [mock_instance])
+    check.check_id = 'test:123'
+
+    pc_cluster = {'config': {'buildInfo': {'version': version}, 'clusterFunction': ['PRISM_CENTRAL']}}
+    check.infrastructure_monitor._collect_pc_version_metadata(pc_cluster)
+
+    datadog_agent.assert_metadata(
+        'test:123',
+        {
+            'version.scheme': 'semver',
+            'version.major': expected_major,
+            'version.minor': expected_minor,
+            'version.raw': version,
+        },
+    )
+
+
 @pytest.mark.unit
 def test_all_metrics(dd_run_check, aggregator, mock_instance, mock_http_get):
     check = NutanixCheck('nutanix', {}, [mock_instance])