Servicios de Windows

Supported OS Windows

Versión de la integración4.9.1

Información general

Este check monitoriza el estado de cualquier Servicio de Windows y envía un check del servicio a Datadog.

Configuración

Instalación

El check del Servicio de Windows está incluido en el paquete del Datadog Agent, por lo que no necesitas instalar nada más en tus nodos de Windows.

Configuración

La configuración se encuentra en el archivo windows_service.d/conf.yaml en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent. Consulta el windows_service.d/conf.yaml de ejemplo para todas las opciones de configuración disponibles. Cuando termines de editar el archivo de configuración, reinicia el Agent para cargar la nueva configuración.

El check puede monitorizar todos los servicios en el sistema o monitorizar de forma selectiva unos pocos servicios por nombre. A partir del Agent v7.41, el check puede seleccionar qué servicios monitorizar en función de su tipo de inicio.

Este ejemplo de configuración sólo monitoriza los servicios Dnscache y wmiApSrv:

instances:
  - services:
    - dnscache
    - wmiapsrv

Este ejemplo utiliza la palabra clave ALL para monitorizar todo los servicios en el host. Si se utiliza la palabra clave ALL, se ignoran los demás patrones de la instancia.

instances:
  - services:
    - ALL

El check utiliza expresiones regulares Python que no distinguen entre mayúsculas y minúsculas para emparejar nombres de servicios. Si un nombre de servicio incluye caracteres especiales, debes escapar los caracteres especiales con un \. Por ejemplo, MSSQL$CRMAWS se convierte en MSSQL\$CRMAWS y Web Server (prod) se convierte en Web Server \(prod\). El patrón de nombres de servicios coincide con todos los nombres de servicios que empiezan con el patrón. Para obtener una coincidencia exacta, utiliza la expresión regular ^service$.

Indica los nombres de los servicios tal y como aparecen en el campo del nombre del servicio, NO en el campo del nombre que se va a mostrar. Por ejemplo, configura el nombre del servicio datadogagent NO el nombre que se va a mostrar Datadog Agent.

Datadog Agent service properties

A partir del Agent v7.41, el check puede seleccionar qué servicios monitorizar en función de su tipo de inicio. Por ejemplo, para monitorizar sólo los servicios que tienen un tipo de inicio automatic o automatic_delayed_start.

instances:
  - services:
    - startup_type: automatic
    - startup_type: automatic_delayed_start

Los valores posibles para startup_type son:

  • disabled
  • manual
  • automatic
  • automatic_delayed_start

A partir del Agent v7.50, el check puede seleccionar qué servicios monitorizar en función de si tienen un activador de servicio asignado. A continuación se muestran algunos ejemplos de posibles configuraciones.

# Empareja todos los servicios que no tienen un activador
services:
  - trigger_start: false

# Empareja todos los servicios que tienen un tipo de inicio automático y excluye los servicios que tienen servicios activadores:
  - startup_type: automatic
    trigger_start: false

# Sólo empareja el servicio EventLog cuando tiene un tipo de inicio automático y tiene servicios
activadores:
  - name: EventLog
    startup_type: automatic
    trigger_start: true

Etiquetas (Tags)

El check etiqueta automáticamente cada check de servicio con el nombre del servicio de Windows en la etiqueta windows_service:<SERVICE>. El nombre <SERVICE> en la etiqueta utiliza minúsculas y los caracteres especiales se sustituyen por guiones bajos. Para obtener más información, consulta Empezando con etiquetas.

NOTA: El check también etiqueta automáticamente cada check de servicio con el nombre del servicio de Windows en la etiqueta service:<SERVICE>. Este comportamiento está obsoleto. En una futura versión del Agent, el check dejará de asignar automáticamente esta etiqueta. Para que el check deje de asignar automáticamente esta etiqueta y desactivar el aviso de obsolescencia asociado, activa la opción disable_legacy_service_tag. Para obtener información sobre cómo asignar la etiqueta service a un servicio, consulta Asignación de etiquetas.

A partir del Agent v7.40, el check puede añadir una etiqueta windows_service_startup_type:<STARTUP_TYPE> a cada check de servicio para indicar el tipo de inicio de servicio. Configura la opción windows_service_startup_type_tag para incluir esta etiqueta con cada check de servicio.

A partir del Agent v7.55, el check puede añadir una etiqueta display_name:<DISPLAY_NAME> a cada check de servicio para indicar el nombre de servicio que se va a mostrar. Configura la opción collect_display_name_as_tag como true para incluir esta etiqueta con cada check de servicio.

Validación

Ejecuta el subcomando de estado del Agent y busca windows_service en la sección Checks.

Datos recopilados

Métricas

El check del Servicio de Windows no incluye métricas.

Eventos

El check del Servicio de Windows no incluye eventos.

Checks de servicios

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

Solucionar problemas

¿Necesitas ayuda? Contacta con el equipo de asistencia de Datadog.

Permisos de servicio

Si un servicio está presente y coincide con la configuración, pero el Datadog Agent no informa un check de servicio del servicio, el Datadog Agent podría tener permisos insuficientes. Por ejemplo, por defecto el Datadog Agent no tiene acceso al servicio NTDS Active Directory Domain Services. Para comprobarlo, ejecuta el check desde un shell PowerShell elevado (ejecutado como administrador).

& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" check windows_service

Si el servicio está presente en el resultado, el problema son los permisos. Para conceder el permiso al Datadog Agent, concede acceso Read en el servicio al usuario del Datadog Agent. Recomendamos conceder Read acceso con la Política de grupo para asegurarte de que los permisos se conserven a través de las actualizaciones de Windows.

Referencias adicionales