Descripción general

Esta página describe las características básicas del Datadog Agent para Windows. Si aún no ha instalado el Agent, consulte las instrucciones de instalación a continuación o siga las instrucciones en la aplicación.

Consulte Plataformas compatibles para obtener la lista completa de versiones de Windows compatibles.

Instalación

Para instalar el Datadog Agent en sus hosts de Windows, siga el flujo guiado en la aplicación dentro de Fleet Automation, luego copie y ejecute el comando de instalación. Los Datadog Agents se ejecutan bajo el ddagentuser. Consulte la documentación de Datadog Windows Agent User para obtener más información.

Pasos de instalación en la aplicación para el Datadog Agent en un host de Windows.

Métodos de instalación alternativos

Instalar con la GUI del Agent Manager

La ubicación de instalación predeterminada para el Agent es %ProgramFiles%\Datadog\Datadog Agent. Si elige utilizar una ubicación de instalación personalizada, asegúrese de especificar un Datadog subdirectorio para los archivos de Datadog.
  1. Descargue el instalador del Datadog Agent para instalar la versión más reciente del Agent.
  2. Ejecute el instalador abriendo datadog-agent-7-latest.amd64.msi. Cuando se le solicite, ingrese sus credenciales de administrador.
  3. Siga las instrucciones, acepte el acuerdo de licencia e ingrese su clave de API de Datadog.

Cuando finalice la instalación, se le dará la opción de iniciar el Datadog Agent Manager.

Opciones de configuración de instalación

Cada una de las siguientes opciones de configuración se puede agregar como una propiedad a la línea de comandos al instalar el Agent en Windows. Para obtener opciones de configuración adicionales del Agent, consulte más opciones de configuración del Agent.

VariableTipoDescripción
APIKEYCadenaAgrega la CLAVE DE API de Datadog al archivo de configuración.
SITECadenaEstablece el sitio de ingesta de Datadog, por ejemplo: SITE=datadoghq.com
TAGSCadenaLista de etiquetas separadas por comas para asignar en el archivo de configuración. Ejemplo: TAGS="key_1:val_1,key_2:val_2"
HOSTNAMECadenaConfigura el nombre de host reportado por el Agent a Datadog (anula cualquier nombre de host calculado en tiempo de ejecución).
DDAGENTUSER_NAMECadenaAnula el nombre de usuario ddagentuser predeterminado utilizado durante la instalación del Agent (v6.11.0+). Obtenga más información sobre el Datadog Windows Agent User.
DDAGENTUSER_PASSWORDCadenaAnula la contraseña criptográficamente segura generada para el usuario ddagentuser durante la instalación del Agent (v6.11.0+). Debe proporcionarse para instalaciones en servidores de dominio. Obtenga más información sobre el Datadog Windows Agent User.
APPLICATIONDATADIRECTORYRutaAnula el directorio que se utilizará para el árbol de directorios del archivo de configuración. Solo puede proporcionarse en la instalación inicial; no es válido para actualizaciones. Predeterminado: C:\ProgramData\Datadog. (v6.11.0+)
PROJECTLOCATIONRutaAnula el directorio que se utilizará para el árbol de directorios del archivo binario. Solo puede proporcionarse en la instalación inicial; no es válido para actualizaciones. Predeterminado: %ProgramFiles%\Datadog\Datadog Agent. (v6.11.0+)

Si decide anular el directorio predeterminado, asegúrese de especificar un subdirectorio Datadog para los archivos de Datadog.

Notas

  • La opción /qn ejecuta una instalación silenciosa. Para ver las indicaciones de la GUI, elimínela.
  • Algunas versiones del Agent pueden causar un reinicio forzado. Para evitar esto, agregue el parámetro: REBOOT=ReallySuppress.
  • Algunos componentes del Agent requieren un controlador de kernel para recopilar datos. Para saber si se requiere un controlador de kernel para su componente, consulte su página de documentación o busque kernel driver en los archivos de configuración del Agent asociados.
  • Si se encuentra un datadog.yaml válido, ese archivo tiene prioridad sobre todas las opciones de línea de comandos especificadas.

Más opciones de configuración del Agent

Cada una de las siguientes opciones de configuración se puede agregar como una propiedad a la línea de comandos al instalar el Agent en Windows.

Nota: Si se encuentra un datadog.yaml válido, ese archivo tiene prioridad sobre todas las opciones de línea de comandos especificadas.

VariableTipoDescripción
LOGS_ENABLEDCadenaHabilite ("true") o deshabilite ("false") la función de recopilación de registro en el archivo de configuración. Los registros están deshabilitados de forma predeterminada.
APM_ENABLEDCadenaHabilite ("true") o deshabilite ("false") el APM Agent en el archivo de configuración. APM está habilitado de forma predeterminada.
PROCESS_ENABLEDCadenaHabilite ("true") o deshabilite ("false") el Process Agent en el archivo de configuración. El Process Agent está deshabilitado de forma predeterminada.
HOSTNAME_FQDN_ENABLEDCadenaHabilite ("true") o deshabilite ("false") el uso de FQDN para el nombre de host del Agent. Es equivalente a establecer hostname_fqdn en el archivo de configuración del Agent. El uso de FQDN para el nombre de host está deshabilitado de forma predeterminada. (v6.20.0+)
CMD_PORTNúmeroUn número de puerto válido entre 0 y 65534. El Datadog Agent expone una API de comandos en el puerto 5001. Si ese puerto ya está en uso por otro programa, el valor predeterminado puede anularse aquí.
PROXY_HOSTCadena(Si usa un proxy) establece su servidor proxy. Obtenga más información sobre el uso de un proxy con el Datadog Agent.
PROXY_PORTNúmero(Si usa un proxy) establece su puerto de proxy. Obtenga más información sobre el uso de un proxy con el Datadog Agent.
PROXY_USERCadena(Si usa un proxy) establece su usuario de proxy. Obtenga más información sobre el uso de un proxy con el Datadog Agent.
PROXY_PASSWORDCadena(Si usa un proxy) establece su contraseña de proxy. Para el Agente de procesos/contenedores, esta variable es necesaria para ingresar una contraseña de autenticación y no se puede cambiar de nombre. Obtenga más información sobre el uso de un proxy con el Datadog Agent.
EC2_USE_WINDOWS_PREFIX_DETECTIONBooleanoUse el ID de instancia de EC2 para hosts de Windows en EC2. (v7.28.0+)

Archivos de registro de instalación

Establezca la opción /log <FILENAME> de msiexec para configurar un archivo de registro de instalación. Si esta opción no está establecida, msiexec escribe el registro en %TEMP%\MSI*.LOG de forma predeterminada.

Configuración

El archivo de configuración principal del Agent se encuentra en C:\ProgramData\Datadog\datadog.yaml. Este archivo se utiliza para configuraciones a nivel de host, como la clave de API, el sitio de Datadog seleccionado, los parámetros de proxy, las etiquetas del host y el nivel de registro.

También hay un archivo datadog.yaml.example en el mismo directorio, que es una referencia completamente comentada con todas las opciones de configuración disponibles, útil para consultar y copiar configuraciones específicas. Alternativamente, consulte el archivo de configuración de ejemplo del Agent para Windows en GitHub.

Los archivos de configuración para las integraciones se encuentran en: C:\ProgramData\Datadog\conf.d\ También puede haber una ubicación heredada alternativa: C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\.

Cada integración tiene un subdirectorio <INTEGRATION>.d\ que contiene:

  • conf.yaml: La configuración activa para la integración
  • conf.yaml.example: Un archivo de muestra que muestra qué claves de configuración son compatibles

Al realizar cambios en la configuración, asegúrese de reiniciar el Agent para garantizar que los cambios surtan efecto.

La GUI del Administrador del Datadog Agent se puede utilizar para habilitar, deshabilitar y configurar comprobaciones. Debe reiniciar el Agent para que los cambios surtan efecto.

Nota: ProgramData es una carpeta oculta.

Comandos del Agent

La ejecución del Agent es controlada por el Windows Service Control Manager.

  • El nombre del ejecutable principal es agent.exe.
  • La GUI de configuración es una aplicación de configuración basada en navegador (solo para Windows de 64 bits).
  • Los comandos se pueden ejecutar desde la línea de comandos elevada (ejecutar como administrador) (PowerShell o Símbolo del sistema) usando la sintaxis <PATH_TO_AGENT.EXE> <COMMAND>.
  • Las opciones de la línea de comandos se muestran a continuación:
ComandoDescripción
checkEjecuta la verificación especificada.
diagnoseEjecuta un diagnóstico de conectividad en su sistema.
flareRecopila un flare y lo envía a Datadog.
helpObtiene ayuda sobre cualquier comando.
hostnameImprime el nombre de host utilizado por el Agent.
importImporta y convierte archivos de configuración de versiones anteriores del Agent.
launch-guiInicia el Datadog Agent Manager.
restart-serviceReinicia el Agent dentro del administrador de control de servicios.
runInicia el Agent.
startInicia el Agent. (Está en desuso, pero se acepta. Utilice run como alternativa.)
start-serviceInicia el Agent dentro del Windows Service Control Manager.
statusImprime el estado actual.
stopserviceDetiene el Agent dentro del Windows Service Control Manager.
versionImprime la información de la versión.

Ejemplos:

  • PowerShell (powershell.exe)

    & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" status
    & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" launch-gui
    & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare
    
  • Command Prompt (cmd.exe)

    "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status
    "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" launch-gui
    "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" flare
    

Desinstale el Agent

Existen dos métodos diferentes para desinstalar el Agent en Windows. Ambos métodos eliminan el Agent, pero no eliminan la carpeta de configuración C:\ProgramData\Datadog en el servidor.

Agregar o quitar programas

  1. Presione CTRL y Esc o use la tecla de Windows para ejecutar la Búsqueda de Windows.
  2. Busque add y haga clic en Add or remove programs.
  3. Busque Datadog Agent y haga clic en Uninstall.

PowerShell

Nota: Habilite WinRM para usar los comandos a continuación.

Utilice el siguiente comando de PowerShell para desinstalar el Agent sin reiniciar:

$productCode = (@(Get-ChildItem -Path "HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" -Recurse) | Where {$_.GetValue("DisplayName") -like "Datadog Agent" }).PSChildName
start-process msiexec -Wait -ArgumentList ('/log', 'C:\uninst.log', '/q', '/x', "$productCode", 'REBOOT=ReallySuppress')

Solución de problemas

Para conocer los pasos de solución de problemas, consulte la documentación de solución de problemas del Agent .

Estado e información del Agent

Para verificar que el Agent se esté ejecutando, compruebe si el servicio DatadogAgent en el panel de Servicios aparece como Iniciado. Un proceso llamado Datadog Metrics Agent (agent.exe) también debería existir en el Administrador de tareas.

Para recibir más información sobre el estado del Agent, inicie el Datadog Agent Manager:

  • Haga clic derecho en el icono de la bandeja del sistema del Datadog Agent > Configure, o
  • Ejecute el comando launch-gui desde una línea de comandos elevada (ejecutar como administrador)
    • PowerShell: & "<PATH_TO_AGENT.EXE>" launch-gui
    • cmd: "<PATH_TO_AGENT.EXE>" launch-gui

Luego, abra la página de estado yendo a Status > General. Obtenga más información sobre cómo ejecutar verificaciones en Status > Collector y Checks > Summary.

El comando de estado está disponible para PowerShell:

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

o cmd.exe:

"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status

Ubicación de los registros

Los registros del Agent se encuentran en C:\ProgramData\Datadog\logs\agent.log.

Nota: ProgramData es una carpeta oculta.

Casos de uso

Seguimiento de un servicio de Windows

En su host de destino, inicie el Datadog Agent Manager y seleccione la integración Windows Service de la lista. Existe un ejemplo predeterminado; sin embargo, este ejemplo utiliza DHCP.

Para obtener el nombre del servicio, abra services.msc y localice su servicio de destino. Usando DHCP como destino, puede ver el nombre del servicio en la parte superior de la ventana de propiedades del servicio:

DHCP

Al agregar sus propios servicios, asegúrese de seguir el formato exactamente como se muestra. Si el formato no es correcto, la integración fallará. Nota: Los caracteres especiales en un nombre de servicio deben escaparse. Por ejemplo, el nombre MSSQL$BILLING puede agregarse con MSSQL\$BILLING.

Servicio DHCP de Windows

Además, siempre que modifique una integración, es necesario reiniciar el servicio de Datadog. Puede hacer esto desde services.msc o desde la barra lateral de la interfaz de usuario.

Para los servicios, Datadog no rastrea las métricas, solo su disponibilidad. (Para métricas, use la integración Process o WMI). Para configurar un Monitor, seleccione el Integration monitor type y luego busque Windows Service. Desde Integration Status > Pick Monitor Scope, elija el servicio al que desea hacer un seguimiento.

Seguimiento de la carga del sistema para Windows

El Datadog Agent recopila una gran cantidad de métricas del sistema de forma predeterminada. Las métricas del sistema más utilizadas son system.load.*, pero estas métricas son específicas de Unix.

Aunque Windows no ofrece las métricas system.load.*, una opción equivalente disponible de forma predeterminada es system.proc.queue.length. Esta métrica muestra la cantidad de subprocesos observados como retrasados en la cola de preparación del procesador que están esperando ser ejecutados.

Seguimiento de procesos de Windows

Puede hacer un seguimiento de los procesos de Windows con Live Process Monitoring. Para habilitar esto en Windows, edite el archivo de configuración principal del Agent estableciendo el siguiente parámetro en true:

datadog.yaml:

process_config:
  enabled: "true"

Una vez completada la configuración, reinicie el Agente.

Lecturas adicionales