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.
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.
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.
Variable
Tipo
Descripción
APIKEY
Cadena
Agrega la CLAVE DE API de Datadog al archivo de configuración.
SITE
Cadena
Establece el sitio de ingesta de Datadog, por ejemplo: SITE=datadoghq.com
TAGS
Cadena
Lista de etiquetas separadas por comas para asignar en el archivo de configuración. Ejemplo: TAGS="key_1:val_1,key_2:val_2"
HOSTNAME
Cadena
Configura el nombre de host reportado por el Agent a Datadog (anula cualquier nombre de host calculado en tiempo de ejecución).
Anula 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.
APPLICATIONDATADIRECTORY
Ruta
Anula 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+)
PROJECTLOCATION
Ruta
Anula 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.
Variable
Tipo
Descripción
LOGS_ENABLED
Cadena
Habilite ("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_ENABLED
Cadena
Habilite ("true") o deshabilite ("false") el APM Agent en el archivo de configuración. APM está habilitado de forma predeterminada.
PROCESS_ENABLED
Cadena
Habilite ("true") o deshabilite ("false") el Process Agent en el archivo de configuración. El Process Agent está deshabilitado de forma predeterminada.
HOSTNAME_FQDN_ENABLED
Cadena
Habilite ("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_PORT
Número
Un 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í.
Use 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:
Comando
Descripción
check
Ejecuta la verificación especificada.
diagnose
Ejecuta un diagnóstico de conectividad en su sistema.
flare
Recopila un flare y lo envía a Datadog.
help
Obtiene ayuda sobre cualquier comando.
hostname
Imprime el nombre de host utilizado por el Agent.
import
Importa y convierte archivos de configuración de versiones anteriores del Agent.
launch-gui
Inicia el Datadog Agent Manager.
restart-service
Reinicia el Agent dentro del administrador de control de servicios.
run
Inicia el Agent.
start
Inicia el Agent. (Está en desuso, pero se acepta. Utilice run como alternativa.)
start-service
Inicia el Agent dentro del Windows Service Control Manager.
status
Imprime el estado actual.
stopservice
Detiene el Agent dentro del Windows Service Control Manager.
"%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
Presione CTRL y Esc o use la tecla de Windows para ejecutar la Búsqueda de Windows.
Busque add y haga clic en Add or remove programs.
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:
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:
"%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:
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.
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.