Windows Services

Supported OS Windows



This check monitors the state of any Windows Service and submits a service check to Datadog.



The Windows Service check is included in the Datadog Agent package, so you don’t need to install anything else on your Windows hosts.


  1. Edit the windows_service.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample windows_service.d/conf.yaml for all available configuration options.

  2. Provide service names as they appear in the services.msc properties field, NOT the display names. For names with spaces, enclose the whole name in double quotation marks, for example: "Windows Service". Note: Spaces are replaced by underscores in Datadog.

  • If your service name includes a special character (for example: MSSQL$CRMAWS) you must escape the special character with a \. The service name should look like MSSQL\$CRMAWS in the configuration.
  1. Restart the Agent.

Metrics collection

The Windows Service check can potentially emit custom metrics, which may impact your billing.


Run the Agent’s status subcommand and look for windows_service under the Checks section.

Data Collected


The Windows Service check does not include any metrics.


The Windows Service check does not include any events.

Service Checks

Returns OK if the windows service is in Running state, CRITICAL if it is Stopped, UNKNOWN if it is Unknown, and WARNING for the other service states.
Statuses: ok, warning, critical, unknown


Need help? Contact Datadog support.

Further Reading