Información general

La gestión remota de Agents simplifica el proceso de actualización de tu flota de Agents, ya que reduce la necesidad de coordinar varias herramientas de despliegue o gestión de la configuración. La gestión remota de Agents te ofrece lo siguiente:

• Gestión centralizada: actualiza los Agents en todos los entornos con una sola herramienta, lo que garantiza la coherencia con las últimas características y parches de seguridad.
• Visibilidad y monitorización: haz un seguimiento del estado de las actualizaciones en tiempo real, lo que permite verificar rápidamente el éxito del despliegue.
• Eficiencia operativa: agiliza el proceso de actualización, lo que elimina la coordinación entre equipos y unifica el despliegue en distintas plataformas.

Configuración

Para activar la gestión remota de Agents:

1. Si todavía no activaste la configuración remota en el Agent, sigue las instrucciones de configuración para activarla.

2. Ve a la página de instalación del Datadog Agent de tu plataforma o herramienta de gestión de configuración.

3. Activa Remote Agent Management (Gestión remota de Agents). La activación de la gestión remota de Agents añade la variable de entorno DD_REMOTE_UPDATES al comando de instalación del Agent generado.

4. Utiliza el comando de instalación del Agent generado para actualizar tu Agent.

   Nota: Debes ejecutar el comando de instalación generado con DD_REMOTE_UPDATES establecido en true para obtener acceso a la gestión remota de Agents. La activación de la gestión remota de Agents sin ejecutar el comando de instalación no concede acceso a la característica.

Actualizar Agents de forma remota

Plataformas compatibles

• Máquinas virtuales Linux instaladas mediante el script de instalación o el rol de Ansible para Datadog
• Máquinas virtuales Windows que utilizan el método de instalación predeterminado (gMSA o cuenta ddagentuser predeterminada)

Requisitos previos

• Permisos de usuario: los usuarios deben tener el permiso Agent Upgrade dentro de Fleet Automation (Automatización de flotas). El permiso está activado de forma predeterminada en el rol Datadog Admin.
• Espacio en disco: Datadog sugiere tener al menos 2 GB para la instalación inicial del Agent y 2 GB adicionales para actualizar el Agent desde Fleet Automation (Automatización de flotas). En concreto, la actualización requiere 1,3 GB en el directorio /opt/datadog-packages en Linux, o C:\ProgramData\Datadog Installer\packages en Windows. El espacio adicional garantiza que haya espacio suficiente para mantener temporalmente dos instalaciones de Agent durante la actualización proceso en caso de que sea necesaria una reversión.

Actualizar los Agents

Para actualizar tus Agents:

1. Activa la gestión remota de Agents.

2. Desde la pestaña Upgrade Agents (Actualizar Agents), haz clic en Start Agents Upgrade (Iniciar actualización de Agents).

3. Selecciona los Agents que deseas actualizar. Puedes filtrar por información de host o etiquetas (tags) para dirigirte a un grupo de Agents.

4. Haz clic en Upgrade Agents (Actualizar Agents) para iniciar la actualización.

5. Utiliza el dashboard Deployments (Despliegues) para hacer un seguimiento del proceso de actualización. Al hacer clic en un Agent en la tabla de despliegues, obtendrás más información sobre la actualización, incluido la duración, el progreso y el usuario que inició la actualización.

Proceso de actualización

Al igual que en una actualización manual, se espera un caída del sistema de 5 a 30 segundos mientras se reinicia el Agent. El proceso de actualización completo tarda aproximadamente 5 minutos. Alrededor de 2 minutos de este tiempo se utilizan para el proceso de actualización. El resto del tiempo se dedica a la monitorización de la actualización para garantizar la estabilidad y determinar si es necesaria una reversión. Si la actualización falla y se requiere una reversión, el Agent vuelve automáticamente a su versión anterior.

El proceso de actualización añade principalmente archivos a los siguientes directorios:

Linux:

• /opt/datadog-packages
• /etc/datadog-agent
• /etc/systemd/system

Windows:

• C:\ProgramData\Datadog Installer\packages
• C:\Program Files\Datadog\Datadog Agent

El Agent garantiza que se establezcan los permisos adecuados para estos archivos. No se altera ningún archivo de configuración durante el proceso de instalación.

Prioridad de las actualizaciones

Para disfrutar de una experiencia de actualización más coherente, Datadog recomienda gestionar las actualizaciones de una fuente a la vez. Utiliza la actualización de flotas o una herramienta de gestión de configuración. Si ejecutas una herramienta de gestión de configuración en un Agent que ya se ha actualizado mediante la actualización de flotas, la actualización revierte el Agent a la DD_AGENT_MINOR_VERSION especificada en tu configuración. Si no se establece una DD_AGENT_MINOR_VERSION, el Agent se actualiza a la última versión disponible.

Duplicaciones y proxies

Puede utilizar la gestión remota de Agents junto con un proxy o repositorios duplicados.

Para obtener instrucciones sobre cómo configurar tu Agent para utilizar un proxy, consulta Configuración del proxy del Agent. Una vez configurado el proxy, reinicia el Agent para aplicar los parámetros.

Para obtener instrucciones sobre el uso de repositorios duplicados o con air-gap, consulta las siguientes páginas:

• Sincroniza las imágenes de Datadog con un registro de contenedores privado.
• Instalar el Agent en un servidor con conectividad limitada a Internet

Cambio a versiones anteriores de Agents

Si necesitas cambiar un Agent a una versión anterior, sigue los pasos de Actualizar los Agents y especifica la versión a la que deseas cambiar. Datadog recomienda utilizar la última versión del Agent y actualizarlo con regularidad para asegurarse de tener acceso a las últimas características.

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Automatización de flotasDOCUMENTACIÓN Configuración remotaDOCUMENTACIÓN