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.
Instalar el Datadog Agent
Requisitos
Versión de Windows: Windows Server 2016 o posterior, o Windows 10 o posterior. Consulta la documentación de Plataformas compatibles del Agent para conocer las versiones de sistema operativo compatibles.
** Cuenta de Datadog**: asegúrate de tener acceso a una cuenta de Datadog y de disponer de tu clave de API de Datadog.
Privilegios de administrador: se requiere acceso de administrador en la máquina de Windows.
El núcleo y los componentes de APM/Traza de Windows Agent se ejecutan en la cuenta ddagentuser. El componente de Live Processes, si está activado, se ejecuta en la cuenta LOCAL_SYSTEM. Más información sobre el Datadog Windows Agent User.
Instalar con la GUI
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.
Al desplegar el Datadog Agent en un entorno de Active Directory, Datadog recomienda utilizar una Group Managed Service Account (gMSA).
El uso de gMSA puede mejorar la seguridad y simplificar la gestión. Algunas de las ventajas son:
Despliegue en varios servidores: a diferencia de las Managed Service Accounts (MSAs) tradicionales o de las Managed Service Accounts (sMSAs) independientes, las gMSAs pueden desplegarse en varios servidores.
Gestión automatizada de contraseñas: las contraseñas de las gMSAs se gestionan a nivel de sistema operativo y se rotan periódicamente sin necesidad de intervención manual.
Cuando se ejecuta con una gMSA, los componentes centrales y APM/traza del Windows Agent se ejecutan bajo la cuenta configurada. El componente Live Processes, si está habilitado, se ejecuta bajo la cuenta LOCAL_SYSTEM. Más información sobre el Datadog Windows Agent User.
Verifica que la gMSA se puede utilizar en la máquina de destino:
Asegúrate de que la máquina de destino forma parte de DatadogAgentsGroup.
En el equipo de destino, abre PowerShell y ejecútalo:
Install-ADServiceAccount -Identity DatadogGMSA
Asegúrate de que el comando se ejecuta sin errores.
Instalación del Agent
Sigue las siguientes instrucciones para instalar la última versión del Datadog Agent. Si necesitas instalar una versión específica del Agent, consulta la lista de instalador.
Instalación a través de la GUI
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 indicaciones, acepta el acuerdo de licencia e introduce tu clave de API de Datadog.
Cuando se te solicite la “Cuenta de usuario de Datadog Agent”, introduce el nombre de usuario de la gMSA. Por ejemplo, `<YOUR_DOMAIN_NAME>\DatadogGMSA. Cuando se te solicite la “Cuenta de usuario de Datadog Agent”, introduce el nombre de usuario de la gMSA. Por ejemplo, y sin contraseña.
Cuando termines la instalación, tendrás la opción de iniciar el Datadog Agent Manager.
Instalar con la línea de comandos
Abre PowerShell con privilegios de Administrador.
Ejecuta el siguiente comando para instalar el Datadog Agent:
Nota: Sustituye DatadogGMSA$ por el nombre de usuario de tu gMSA. El nombre de usuario debe terminar con el símbolo $..
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 ingesta de Datadog. Ejemplo: SITE=
TAGS
Cadena
Lista de etiquetas 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)
[OBSOLETO] ADDLOCAL
Cadena
Habilita el componente de Agent adicional. Si se selecciona "MainApplication,NPM", se instalará el componente del controlador para Network Performance Monitoring. (Versión 7.44.0 y anteriores)
Nota:
Agent 7 sólo es compatible con Python 3. Antes de actualizar, confirma que tus checks personalizados son compatibles con Python 3. Consulta la guía de Migración de check personalizado de Python 3 para más información. Si no estás utilizando checks personalizados o ya has confirmado su compatibilidad, actualiza normalmente.
Si estás actualizando desde una versión del Datadog Agent < 5.12.0, primero actualiza a una versión más reciente del Agent 5 (>= 5.12.0, pero < 6.0.0) con el instalador EXE y después actualiza al Datadog Agent versión >= 6.
Archivos de log de la instalación
Puedes encontrar los archivos de log de la instalación del Agent en %TEMP%\MSI*.LOG.
El administrador de control de servicios de Windows controla la ejecución del Agent.
El nombre del archivo ejecutable principal es agent.exe. En función de la versión del Agent, su localización es la siguiente:
Versiones del Agent <= 6.11: "C:\Program Files\Datadog\Datadog Agent\embedded\agent.exe"
Versiones del Agent >= 6.12: "C:\Program Files\Datadog\Datadog Agent\bin\agent.exe"
La GUI de configuración es una aplicación de configuración basada en navegador (solo para Windows de 64 bits).
Se pueden ejecutar comandos desde una línea de comandos con privilegios superiores (ejecutada como administrador) (PowerShell o Símbolo del sistema) con 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
Configuración
Utiliza el Datadog Agent Manager para habilitar, deshabilitar y configurar checks. Reinicia el Agent para aplicar los cambios.
El archivo principal de configuración del Agent se encuentra en:
C:\ProgramData\Datadog\datadog.yaml
Los archivos de configuración para las integraciones se encuentran en:
C:\ProgramData\Datadog\conf.d\ O
C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\
Nota: ProgramData es una carpeta oculta.
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).
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.
