Windows Services

Supported OS Windows

Integrationv4.2.1

Overview

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

Setup

Installation

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

Configuration

  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.

Validation

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

Data Collected

Metrics

The Windows Service check does not include any metrics.

Events

The Windows Service check does not include any events.

Service Checks

windows_service.state
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

Troubleshooting

Need help? Contact Datadog support.

Further Reading