Esta página describe las características básicas del Agente de Datadog para Windows. Si aún no has instalado el Agente, consulta las instrucciones de instalación a continuación o sigue las instrucciones en la aplicación.
Consulta Plataformas Soportadas para la lista completa de versiones de Windows soportadas.
La ubicación de instalación predeterminada para el Agente es %ProgramFiles%\Datadog\Datadog Agent. Si eliges usar una ubicación de instalación personalizada, asegúrate de especificar un Datadog subdirectorio para los archivos de Datadog.
Ejecuta el instalador abriendo datadog-agent-7-latest.amd64.msi. Cuando se te solicite, ingresa tus credenciales de Administrador.
Sigue las instrucciones, acepta el acuerdo de licencia e ingresa tu clave de API de Datadog.
Cuando la instalación finalice, se te dará la opción de iniciar el Administrador del Agente de Datadog.
Opciones de configuración de instalación
Cada una de las siguientes opciones de configuración puede ser añadida como una propiedad a la línea de comandos al instalar el Agente en Windows. Para opciones adicionales de configuración del Agente, consulta más opciones de configuración del Agente.
Variable
Tipo
Descripción
APIKEY
Cadena
Agrega la clave de API de Datadog al archivo de configuración.
SITE
Cadena
Establece el sitio de recepción 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 Agente a Datadog (anula cualquier nombre de host calculado en tiempo de ejecución).
Sobrescribir la contraseña criptográficamente segura generada para el ddagentuser usuario durante la instalación del Agente (v6.11.0+). Debe ser proporcionado para instalaciones en servidores de dominio. Aprende más sobre el usuario del Agente de Datadog para Windows.
APPLICATIONDATADIRECTORY
Ruta
Sobrescribir el directorio a utilizar para el árbol de directorios del archivo de configuración. Solo puede ser proporcionado en la instalación inicial; no es válido para actualizaciones. Predeterminado: C:\ProgramData\Datadog. (v6.11.0+)
PROJECTLOCATION
Ruta
Sobrescribir el directorio a utilizar para el árbol de directorios del archivo binario. Solo puede ser proporcionado en la instalación inicial; no es válido para actualizaciones. Predeterminado: %ProgramFiles%\Datadog\Datadog Agent. (v6.11.0+)
Si decides sobrescribir el directorio predeterminado, asegúrate de especificar un Datadog subdirectorio para los archivos de Datadog.
Notas
La /qn opción ejecuta una instalación silenciosa. Para ver los mensajes de la GUI, elimínalo.
Algunas versiones del Agente pueden causar un reinicio forzado. Para prevenir esto, agrega el parámetro: REBOOT=ReallySuppress.
Algunos componentes del Agente 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 Agente 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 Agente
Cada una de las siguientes opciones de configuración puede ser añadida como una propiedad a la línea de comandos al instalar el Agente 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
Habilitar ("true") o deshabilitar ("false") la función de recopilación de registros en el archivo de configuración. Los registros están deshabilitados por defecto.
APM_ENABLED
Cadena
Habilitar ("true") o deshabilitar ("false") el APM Agent en el archivo de configuración. APM está habilitado por defecto.
PROCESS_ENABLED
Cadena
Habilitar ("true") o deshabilitar ("false") el Agente de Procesos en el archivo de configuración. El Agente de Procesos está deshabilitado por defecto.
HOSTNAME_FQDN_ENABLED
Cadena
Habilitar ("true") o deshabilitar ("false") el uso de FQDN para el nombre de host del Agente. Es equivalente a establecer hostname_fqdn en el archivo de configuración del Agente. El uso de FQDN para el nombre de host está deshabilitado por defecto. (v6.20.0+)
CMD_PORT
Número
Un número de puerto válido entre 0 y 65534. El Agente de Datadog expone una API de comandos en el puerto 5001. Si ese puerto ya está en uso por otro programa, el valor predeterminado puede ser sobrescrito aquí.
(Si utiliza un proxy) establece su contraseña de proxy. Para el Agente de procesos y contenedores, esta variable es necesaria para proporcionar una contraseña de autenticación y no puede ser renombrada. Aprende más sobre el uso de un proxy con el Agente de Datadog.
EC2_USE_WINDOWS_PREFIX_DETECTION
Booleano
Utilizar 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> msiexec para configurar un archivo de registro de instalación. Si esta opción no se establece, msiexec escribe el registro en %TEMP%\MSI*.LOG por defecto.
Configuración
El archivo de configuración principal del Agente se encuentra en
C:\ProgramData\Datadog\datadog.yaml. Este archivo se utiliza para configuraciones a nivel de servidor, como la clave de API, el sitio de Datadog seleccionado, parámetros de proxy, etiquetas de host y 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 referencia y copia de configuraciones específicas.
Los archivos de configuración para integraciones se encuentran en:
C:\ProgramData\Datadog\conf.d\ También puede haber una ubicación alternativa heredada: 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 Agente para garantizar que los cambios surtan efecto.
"%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
Desinstalar el Agente
Existen dos métodos diferentes para desinstalar el Agente en Windows. Ambos métodos eliminan el Agente, 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 Agente sin reiniciar:
Para verificar que el Agente esté en ejecución, verifique si el servicio DatadogAgent en el panel de Servicios está listado 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 Agente, inicie el Administrador del Agente de Datadog:
Haga clic derecho en el ícono del sistema del Agente de Datadog > Configure, o
Run launch-gui el comando 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 la ejecución de checks en Status > Collector y Checks > Summary.
El comando status está disponible para PowerShell:
"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status
Ubicación de los registros
Los registros del Agente se encuentran en C:\ProgramData\Datadog\logs\agent.log.
Nota: ProgramData es una carpeta oculta.
Casos de uso
Monitoreo de un servicio de Windows
En su servidor objetivo, inicie el Administrador del Agente de Datadog y seleccione la integración Windows Service de la lista. Hay un ejemplo listo para usar; sin embargo, este ejemplo utiliza DHCP.
Para obtener el nombre del servicio, abra services.msc y localice su servicio objetivo. Usando DHCP como objetivo, 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 falla. Nota: Los caracteres especiales en un nombre de servicio deben ser escapados. Por ejemplo, el nombre MSSQL$BILLING se puede agregar con MSSQL\$BILLING.
Además, cada vez que modifique una integración, el servicio de Datadog necesita ser reiniciado. 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 Process o WMI). Para configurar un Monitor, seleccione el tipo de monitor de integración y luego busque Windows Service. Desde Integration Status > Pick Monitor Scope, elija el servicio que desea monitorear.
Monitoreo de carga del sistema para Windows
El Agente de Datadog recopila un gran número de métricas del sistema por defecto. Las métricas del sistema más comúnmente 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 que está disponible por defecto es system.proc.queue.length. Esta métrica muestra el número de hilos observados como retrasados en la cola de listos del procesador que están esperando ser ejecutados.
