Uso básico del Agent para Windows

Información general

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.
  1. Descarga el instalador del Datadog Agent para instalar la última versión del Agent.
  2. Ejecuta el instalador abriendo datadog-agent-7-latest.amd64.msi. Cuando se te solicite, introduce tus credenciales de administrador.
  3. Sigue las instrucciones, acepta el acuerdo de licencia e introduce tu clave de API de Datadog.

Cuando termine la instalación, tendrás la opción de iniciar el Datadog Agent Manager.

Instalar con la línea de comandos

  1. Abre PowerShell con privilegios de Administrador.
  2. Ejecuta el siguiente comando para instalar el Datadog Agent:
    Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-agent-7-latest.amd64.msi APIKEY="<YOUR_DATADOG_API_KEY>"'
    

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.

Requisitos previos

Nota: Para una comprensión completa de la configuración de gMSAs, consulta Información general de Group Managed Service Accounts de Microsoft.

Crear y configurar una gMSA

  1. Cree un grupo de seguridad:

    1. Abre **Active Directory Users and Computers (ADUC) (Usuarios y equipos de Active Directory (ADUC)).
    2. Navega hasta la Organizational Unit (OU) (Unidad Organizativa (UO)) apropiada.
    3. Haz clic con el botón derecho y selecciona New > Group (Nuevo > Grupo).
    4. Asigna un nombre al grupo. Por ejemplo, DatadogAgentsGroup.
    5. Establece el contexto del grupo correcto para tu organización. Por ejemplo, Dominio local.
    6. Establece el tipo en Security (Seguridad).
  2. Crear la gMSA:

    1. Abre PowerShell con privilegios de Administrador.
    2. Ejecuta el siguiente comando para crear la gMSA, sustituyendo <YOUR_DOMAIN_NAME> por tu nombre de dominio:
      New-ADServiceAccount -Name DatadogGMSA -DNSHostName <YOUR_DOMAIN_NAME> -PrincipalsAllowedToRetrieveManagedPassword DatadogAgentsGroup
      
  3. Verifica que la gMSA se puede utilizar en la máquina de destino:

    1. Asegúrate de que la máquina de destino forma parte de DatadogAgentsGroup.
    2. 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.
  1. Descarga el instalador del Datadog Agent para instalar la última versión del Agent.
  2. Ejecuta el instalador abriendo datadog-agent-7-latest.amd64.msi. Cuando se te solicite, introduce tus credenciales de administrador.
  3. Sigue las indicaciones, acepta el acuerdo de licencia e introduce tu clave de API de Datadog.
  4. 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 usuariode 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

  1. Abre PowerShell con privilegios de Administrador.
  2. 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 $..

Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-agent-7-latest.amd64.msi APIKEY="<YOUR_DATADOG_API_KEY>" DDAGENTUSER_NAME="<YOUR_DOMAIN_NAME>\DatadogGMSA$'

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.

VariableTipoDescripción
APIKEYCadenaAñade la clave de API de Datadog al archivo de configuración.
SITECadenaConfigura el sitio de ingesta de Datadog. Ejemplo: SITE=
TAGSCadenaLista 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"
HOSTNAMECadenaConfigura el nombre de host que el Agent envía a Datadog (anula cualquier nombre de host determinado durante el tiempo de ejecución).
DDAGENTUSER_NAMECadenaAnula el nombre de usuario ddagentuser predeterminado que se utilizó durante la instalación del Agent (v6.11.0 y posteriores). Más información sobre el usuario del Datadog Windows Agent
DDAGENTUSER_PASSWORDCadenaAnula 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
APPLICATIONDATADIRECTORYRutaAnula 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)
PROJECTLOCATIONRutaAnula 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.

VariableTipoDescripción
LOGS_ENABLEDCadenaHabilita ("true") o deshabilita ("false") la recopilación de logs del archivo de configuración. Los logs se encuentran deshabilitados de manera predeterminada.
APM_ENABLEDCadenaHabilita ("true") o deshabilita ("false") el Agent de APM en el archivo de configuración. El APM se encuentra habilitado de manera predeterminada.
PROCESS_ENABLEDCadenaHabilita ("true") o deshabilita ("false") el Process Agent del archivo de configuración. El Process Agent se encuentra deshabilitado de manera predeterminada.
HOSTNAME_FQDN_ENABLEDCadenaHabilita ("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_PORTNúmeroNú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í.
PROXY_HOSTCadena(Si utilizas un proxy) establece tu host de proxy. Más información sobre el uso de proxy con el Datadog Agent.
PROXY_PORTNúmero(Si utilizas un proxy) establece tu puerto de proxy. Más información sobre el uso de proxy con el Datadog Agent.
PROXY_USERCadena(Si utilizas un proxy) establece tu usuario de proxy. Más información sobre el uso de proxy con el Datadog Agent.
PROXY_PASSWORDCadena(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_DETECTIONBooleanoUtiliza el ID de instancia EC2 para los hosts de Windows en EC2. (v7.28.0 y posteriores)
(OBSOLETO) ADDLOCALCadenaHabilita 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.

Validación

Para verificar tu instalación, sigue las instrucciones que aparecen en la sección Estado e información del Agent.

Comandos del Agent

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:
ComandoDescripción
checkEjecuta el check especificado.
diagnoseEjecuta un diagnóstico de la conectividad de tu sistema.
flareRecopila un flare y lo envía a Datadog.
helpEncuentra ayuda sobre cualquier comando.
hostnameMuestra el nombre de host que utiliza el Agent.
importImporta y convierte archivos de configuración de versiones anteriores del Agent.
launch-guiInicia el Datadog Agent Manager.
restart-serviceReinicia el Agent en el administrador de control de servicios.
runInicia el Agent.
startInicia el Agent. (Obsoleto, pero aceptado. Utiliza run como alternativa).
start-serviceInicia el Agent en el administrador de control de servicios.
statusMuestra en qué estado se encuentra el Agent en el momento de ejecutar el comando.
stopserviceDetiene el Agent en el administrador de control de servicios.
versionMuestra información acerca 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
      
    • Símbolo del sistema (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
      

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

  1. Pulsa CTRL y Esc o utiliza la tecla de Windows para ejecutar Windows Search.
  2. Busca add y haz clic en Add or remove programs (Añadir o eliminar programas).
  3. 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:

$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')

Solucionar problemas

Estado e información del Agent

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).

El comando status se puede usar en PowerShell:

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

También en cmd.exe:

"%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.

Enviar un flare

  • Navega hasta http://127.0.0.1:5002 para visualizar el Datadog Agent Manager.

  • Selecciona la pestaña Flare.

  • Introduce tu número de tique (si tienes alguno).

  • Introduce la dirección de correo electrónico que utilizas para iniciar sesión en Datadog.

  • Pulsa Submit (Enviar).

El comando flare se puede usar en PowerShell:

& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID>

También en cmd.exe:

"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID>
Flare en Windows con el Agent 6

Casos de uso

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:

DHCP

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.

Servicio DHCP en Windows

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.

Monitorización de procesos de Windows

Puedes monitorizar procesos de Windows con Live Process Monitoring. Para habilitar esta función en Windows, modifica el archivo de configuración principal del Agent dándole al siguiente parámetro el valor “true”:

datadog.yaml:

process_config:
  enabled: "true"

Una vez que se haya completado la configuración, reinicia el Agent.

Referencias adicionales