En esta página se describen las funciones básicas de Datadog Agent para Windows. Si aún no has instalado el Agent, consulta las instrucciones de instalación que aparecen a continuación o sigue las instrucciones de la aplicación.
Consulta las plataformas compatibles para ver la lista completa de distribuciones y versiones de Linux compatibles.
La localización de instalación predeterminada para el Agent es %ProgramFiles%Datadog\Datadog Agent. Si decides utilizar una localización de instalación personalizada, asegúrate de especificar un subdirectorio de Datadog para los archivos de Datadog.
Ejecuta el instalador abriendo datadog-agent-7-latest.amd64.msi. Cuando se te solicite, introduce tus credenciales de administrador.
Sigue las instrucciones, acepta el acuerdo de licencia e introduce tu clave de API Datadog.
Cuando termines la instalación, tendrás 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 añadir como propiedad a la línea de comandos al instalar el Agent en Windows. Si lo necesitas, puedes consultar más opciones de configuración del Agent.
Variable
Tipo
Descripción
APIKEY
Cadena
Añade la clave de API de Datadog al archivo de configuración.
SITE
Cadena
Configura el sitio de admisión en Datadog, por ejemplo: SITE=datadoghq.com.
TAGS
Cadena
Lista de etiquetas (tags) que asignar en el archivo de configuración. Los valores están separados por comas. Ejemplo: TAGS="key_1:val_1,key_2:val_2"
HOSTNAME
Cadena
Configura el nombre de host que el Agent envía a Datadog (anula cualquier nombre de host determinado durante el tiempo de ejecución).
Anula la contraseña con protección criptográfica que se generó para el usuario ddagentuser durante la instalación del Agent (v6.11.0 y posteriores). Se debe proporcionar para instalaciones en servidores de dominios. Más información sobre el usuario del Datadog Windows Agent
APPLICATIONDATADIRECTORY
Ruta
Anula el directorio que se va a utilizar para el árbol de directorios de archivos de configuración. Solo se puede proporcionar en la primera instalación; no es válido para actualizaciones. Valor predeterminado: C:\ProgramData\Datadog. (v6.11.0 y posteriores)
PROJECTLOCATION
Ruta
Anula el directorio a utilizar para el árbol de directorios de archivos binarios. Sólo puede proporcionarse en la instalación inicial; no es válido para actualizaciones. Por defecto: %ProgramFiles%\Datadog\Datadog Agent. (v6.11.0+)_
Si decides anular el directorio predeterminado, asegúrate de especificar un subdirectorio Datadog para los archivos de Datadog.
Notas
La opción /qn ejecuta una instalación silenciosa. Elimínala para ver las indicaciones de la GUI.
Algunas versiones del Agent pueden provocar un reinicio forzado. Para evitarlo, añade el siguiente parámetro: REBOOT=ReallySuppress.
Algunos componentes del Agent requieren un controlador de kernel para recopilar datos. Para saber si tu componente lo necesita, consulta la página donde se encuentra su documentación o busca 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 añadir como 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
Habilita ("true") o deshabilita ("false") la recopilación de logs del archivo de configuración. Los logs se encuentran deshabilitados de manera predeterminada.
APM_ENABLED
Cadena
Habilita ("true") o deshabilita ("false") el Agent de APM en el archivo de configuración. El APM se encuentra habilitado de manera predeterminada.
PROCESS_ENABLED
Cadena
Habilita ("true") o deshabilita ("false") el Process Agent del archivo de configuración. El Process Agent se encuentra deshabilitado de manera predeterminada.
HOSTNAME_FQDN_ENABLED
Cadena
Habilita ("true") o deshabilita ("false") el uso de FQDN para el nombre de host del Agent. Esto equivale a establecer hostname_fqdn en el archivo de configuración del Agent. El uso de FQDN para el nombre de host del Agent se encuentra deshabilitado de manera predeterminada. (v6.20.0 y posteriores)
CMD_PORT
Número
Número de puerto válido entre 0 y 65534. El Datadog Agent muestra una API de comandos en el puerto 5001. Si ya hay otro programa utilizando ese puerto, se puede anular el valor predeterminado aquí.
(Si utilizas un proxy) establece tu contraseña de proxy. Para Agent de proceso/contenedor, esta variable se requiere para pasar una contraseña de autenticación y no puede ser renombrada. Más información sobre el uso de proxy con Datadog Agent.
EC2_USE_WINDOWS_PREFIX_DETECTION
Booleano
Utiliza el ID de instancia EC2 para los hosts de Windows en EC2. (v7.28.0 y posteriores)
Archivos de log de la instalación
Define la opción /log <FILENAME> msiexec para configurar un archivo de log de instalación. Si no se define esta opción, msiexec escribe el log en %TEMP%\MSI*.LOG por defecto.
Configuración
El archivo de configuración principal del Agent se encuentra en
C:\ProgramData\Datadog\datadog.yaml. Este archivo se utiliza para las configuraciones en todo el host, como la clave de API, el sitio Datadog seleccionado, los parámetros proxy, las etiquetas de host y el nivel de log.
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. Es útil como referencia y para copiar configuraciones específicas.
Los archivos de configuración de las integraciones están en:
C:\ProgramData\Datadog\conf.d\ También puede haber una ubicación legacy alternativa: C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\.
Cada integración tiene un subdirectorio <INTEGRATION>.d\ que contiene:
conf.yaml: Parámetros activos de la integración
conf.yaml.example: Archivo de ejemplo que muestra las claves de configuración compatibles
Cuando realices cambios en la configuración, asegúrate de reiniciar el Agent para que los cambios surtan efecto.
La GUI del Datadog Agent Manager puede utilizarse para activar, desactivar y configurar checks. Debes reiniciar Agent para que los cambios surtan efecto.
Nota: ProgramData es una carpeta oculta.
Comandos del Agent
El administrador de control de servicios de Windows controla la ejecución del Agent.
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) utilizando la sintaxis <PATH_TO_AGENT.EXE> <COMMAND>.
Estas son las opciones de línea de comandos:
Comando
Descripción
check
Ejecuta el check especificado.
diagnose
Ejecuta un diagnóstico de la conectividad de tu sistema.
flare
Recopila un flare y lo envía a Datadog.
help
Encuentra ayuda sobre cualquier comando.
hostname
Muestra el nombre de host que utiliza 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 en el administrador de control de servicios.
run
Inicia el Agent.
start
Inicia el Agent. (Obsoleto, pero aceptado. Utiliza run como alternativa).
start-service
Inicia el Agent en el administrador de control de servicios.
status
Muestra en qué estado se encuentra el Agent en el momento de ejecutar el comando.
stopservice
Detiene el Agent en el administrador de control de servicios.
"%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 Agent
Existen dos métodos diferentes para desinstalar el Agent en Windows. Ambos borran el Agent, pero no eliminan la carpeta de configuración C:\ProgramData\Datadog del host.
Añadir o eliminar programas
Pulsa CTRL y Esc o utiliza la tecla de Windows para ejecutar Windows Search.
Busca add y haz clic en Add or remove programs (Añadir o eliminar programas).
Busca Datadog Agent y haz clic en Uninstall (Desinstalar).
PowerShell
Nota: Habilita WinRM para utilizar los comandos que se muestran a continuación.
Utiliza el siguiente comando de PowerShell para desinstalar el Agent sin tener que reiniciar:
Para verificar que el Agent se esté ejecutando, comprueba si, en el panel Services (Servicios), el servicio DatadogAgent aparece como Started (Iniciado). También debería aparecer un proceso llamado Datadog Metrics Agent (agent.exe) en el Administrador de tareas.
Para obtener más información sobre el estado del Agent, inicia el Datadog Agent Manager de una de estas dos maneras:
Haz clic con el botón derecho del ratón en el icono de la bandeja del sistema del Datadog Agent y selecciona Configure (Configurar).
Ejecuta el comando launch-gui desde una línea de comando con privilegios superiores (ejecutada como administrador)
PowerShell: & "<PATH_TO_AGENT.EXE>" launch-gui
cmd: "<PATH_TO_AGENT.EXE>" launch-gui
Luego, ve a Status -> General (Estado -> General) para abrir la página de estado.
Tienes más información sobre la ejecución de checks en Status -> Collector (Estado -> Recopilador) y Checks -> Summary (Checks -> Resumen).
"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status
Localización de logs
Los logs del Agent se encuentran en C:\ProgramData\Datadog\logs\agent.log.
Nota: ProgramData es una carpeta oculta.
Casos prácticos
Monitorización de un servicio de Windows
En tu host de destino, inicia el Datadog Agent Manager y selecciona la integración “Windows Service” (Servicio de Windows) en la lista. Aunque ya viene un ejemplo predefinido, en este ejemplo se utiliza DHCP.
Para saber el nombre del servicio, abre services.msc y localiza tu servicio de destino. Si utilizas DHCP como destino, podrás ver el nombre del servicio en la parte superior de la ventana de propiedades del servicio:
Cuando añadas tus propios servicios, asegúrate de respetar el formato tal y como te lo mostramos. La integración fallará si el formato no es correcto. Nota: Si quieres usar caracteres especiales en el nombre de un servicio, debes utilizar una secuencia de escape. Por ejemplo, para añadir MSSQL$BILLING, se debe escribir MSSQL\$BILLING.
Además, cuando modificas una integración, debes reiniciar el servicio de Datadog. Puedes hacerlo con services.msc o desde la barra lateral de la interfaz de usuario.
En el caso de los servicios, Datadog no rastrea las métricas, solo su disponibilidad (para las métricas, utiliza la integración de Process o WMI). Para configurar un monitor, selecciona el tipo de monitor de la integración y, luego, busca Windows Service (Servicio de Windows). En Integration Status -> Pick Monitor Scope (Estado de la integración -> Seleccionar alcance del monitor), elige el servicio que te gustaría monitorizar.
Monitorización de la carga del sistema en Windows
El Datadog Agent recopila un gran número de métricas del sistema de forma predeterminada. Las métricas del sistema que más se utilizan son system.load.*, pero son específicas de Unix.
Si bien Windows no proporciona las métricas de system.load.*, hay una opción equivalente disponible de manera predeterminada: system.proc.queue.length. Esta métrica muestra el número de subprocesos que aparecen con retraso en la cola de procesos listos para su ejecución.
