Add status metric for Windows services and update tests (#25290)

* Add status metric for Windows services and update tests

* add changelog file

* rephrase metadata description

* Sort windows_service metadata.csv

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Update description for windows_service.status metric to clarify status values

---------

Co-authored-by: Ian Bucad <ian.bucad@datadoghq.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Author: 3 people

windows_service/changelog.d/25290.added

@@ -0,0 +1 @@
+Adding `windows_service.status` metric for service state representation.

windows_service/datadog_checks/windows_service/windows_service.py

@@ -416,6 +416,7 @@ def check(self, instance):
                 tags.append('service:{}'.format(reported_name))
 
             self.service_check(self.SERVICE_CHECK_NAME, status, tags=tags)
+            self.gauge('windows_service.status', status, tags=tags)
             self.log.debug('service state for %s %s', service_name, status)
             self.gauge('windows_service.uptime', service_uptime, tags=tags)
             # Send 1 for windows_service.state so the user can sum by the windows_service_state tag
@@ -443,6 +444,7 @@ def check(self, instance):
                     tags.append('service:{}'.format(service))
 
                 self.service_check(self.SERVICE_CHECK_NAME, status, tags=tags)
+                self.gauge('windows_service.status', status, tags=tags)
                 self.log.debug('service state for %s %s', service, status)
                 self.gauge('windows_service.uptime', 0, tags=tags)
                 self.gauge('windows_service.state', 1, tags=tags)

windows_service/metadata.csv

@@ -1,4 +1,5 @@
 metric_name,metric_type,interval,unit_name,per_unit_name,description,orientation,integration,short_name,curated_metric,sample_tags
 windows_service.restarts,count,,event,,The number of restarts of the host process of the Windows service,0,windows_service,restarts,,
 windows_service.state,gauge,,service,,Sum by state to count the number of services in each state,0,windows_service,state,,
+windows_service.status,gauge,,,,"The status of the Windows service: 0 = running, 1 = pending or paused, 2 = stopped, 3 = unknown or not found. Uses the same values as the windows_service.state service check.",0,windows_service,status,,
 windows_service.uptime,gauge,,second,,The uptime (in seconds) of the host process of the Windows service,0,windows_service,uptime,,

windows_service/tests/test_windows_service.py

@@ -31,6 +31,12 @@ def assert_service_check_and_metrics(aggregator, services):
             tags=service.tags,
             count=service.count,
         )
+        aggregator.assert_metric(
+            'windows_service.status',
+            tags=service.tags,
+            value=service.check_status,
+            count=service.count,
+        )
         aggregator.assert_metric(
             'windows_service.uptime',
             tags=service.tags,