Datadog-Windows Services Integration

Windows Service Event

Overview

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

Setup

Installation

The Windows Service check is packaged with the Agent, so simply install the Agent on your Windows hosts.

Configuration

Create a file windows_service.yaml in the Agent’s conf.d directory. See the sample windwos_service.yaml for all available configuration options:

init_config:

instances:
  - host: . # dot means localhost
#   username: <REMOTESERVER>\<REMOTEUSER> # if 'host' is a remote host
#   password: <PASSWORD>

# list at least one service to monitor
    services:
#     - wmiApSrv

You must provide service names as they appear in services.msc’s properties field (e.g. wmiApSrv), NOT the display name (e.g. WMI Performance Adapter).

Restart the Agent to start monitoring the services and sending service checks to Datadog.

Validation

Run the Agent’s info subcommand and look for windows_service under the Checks section:

  Checks
  ======
    [...]

    windows_service
    -------
      - instance #0 [OK]
      - Collected 0 metrics, 0 events & 1 service check

    [...]

Compatibility

The Windows Service check is compatible with all Windows platforms.

Data Collected

Metrics

The Windows Service check does not include any metrics at this time.

Events

The Windows Service check does not include any event at this time.

Service Checks

windows_service.state:

The Agent submits this service check for each Windows service configured in services, tagging the service check with ‘service:’. The service check takes on the following statuses depending on Windows status:

Windows statuswindows_service.state
StoppedCRITICAL
Start PendingWARNING
Stop PendingWARNING
RunningOK
Continue PendingWARNING
Pause PendingWARNING
PausedWARNING
UnknownUNKNOWN

Troubleshooting

Need help? Contact Datadog Support.

Further Reading