Administración y mantenimiento del agente de Log Analytics para Windows y Linux

  • Artículo

Después de la implementación inicial del agente de Windows o Linux para Log Analytics en Azure Monitor, debe volver a configurar el agente, actualizarlo o quitarlo del equipo si alcanzó la fase de retirada de su ciclo de vida. Puede administrar fácilmente estas tareas de mantenimiento rutinarias manualmente o de manera automática, lo que reduce los errores de funcionamiento y los gastos.

Importante

El agente de Log Analyticsheredado quedará en desuso en agosto de 2024. Después de esta fecha, Microsoft ya no proporcionará soporte técnico para el agente de Log Analytics. Migre al agente de Azure Monitor antes de agosto de 2024 para continuar con la ingesta de datos.

Actualización del agente

Actualice a la versión más reciente del agente de Log Analytics para Windows y Linux de forma manual o automática en función del escenario de implementación y del entorno en el que se ejecute la máquina virtual.

Entorno Método de instalación Método de actualización
Azure VM Extensión de VM del agente de Log Analytics para Windows o Linux El agente se actualiza automáticamente después de que cambie el modelo de VM, a menos que configure la plantilla de Azure Resource Manager para no participar mediante el establecimiento de la propiedad autoUpgradeMinorVersion en false. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. Solo el agente de Linux admite la actualización automática después de la implementación con la propiedad enableAutomaticUpgrade (consulte Habilitación de la actualización automática para el agente de Linux). La actualización de la versión principal siempre es manual (consulte la propiedad VirtualMachineExtensionInner.AutoUpgradeMinorVersion Property).
Imágenes personalizadas de VM de Azure Instalación manual del agente de Log Analytics para Windows o Linux La actualización de las VM a la versión más reciente del agente debe realizarse desde la línea de comandos que ejecuta el paquete del instalador de Windows o el paquete de scripts de shell instalable y autoextraíble de Linux.
VM ajenas a Azure Instalación manual del agente de Log Analytics para Windows o Linux La actualización de las VM a la versión más reciente del agente debe realizarse desde la línea de comandos que ejecuta el paquete del instalador de Windows o el paquete de scripts de shell instalable y autoextraíble de Linux.

Actualización del agente de Windows

Para actualizar el agente en una VM de Windows a la última versión que no se instaló con la extensión de VM de Log Analytics, puede realizar el proceso desde el símbolo del sistema, el script u otra solución de automatización, o mediante el Asistente para instalación MMASetup-<platform>.msi.

Para descargar la versión más reciente del agente de Windows desde el área de trabajo de Log Analytics:

  1. Inicie sesión en Azure Portal.

  2. En Azure Portal, seleccione Todos los servicios. En la lista de recursos, escriba Log Analytics. Cuando comience a escribir, la lista se filtrará en función de la entrada. Seleccione Áreas de trabajo de Log Analytics.

  3. En la lista de áreas de trabajo de Log Analytics, seleccione un área de trabajo.

  4. En el área de trabajo de Log Analytics, seleccione el icono Agentes y, posteriormente, Servidores de Windows.

  5. En la pantalla Servidores Windows, seleccione en Descargar el agente de Windows la versión para descargar según la arquitectura del procesador del sistema operativo Windows.

Nota

Durante la actualización del agente de Log Analytics para Windows, no se admitirá la configuración o volver a configurar un área de trabajo para notificaciones. Para configurar el agente, siga uno de los métodos admitidos que se enumeran en Agregar o quitar un área de trabajo.

Actualización mediante el Asistente para instalación

  1. Inicie sesión en el equipo con una cuenta con derechos administrativos.

  2. Ejecute MMASetup-<platform>.exe para iniciar el Asistente para instalación.

  3. En la primera página del Asistente para instalación, haga clic en Siguiente.

  4. En el cuadro de diálogo Configuración de Microsoft Monitoring Agent, seleccione Aceptar para aceptar el contrato de licencia.

  5. En el cuadro de diálogo Configuración de Microsoft Monitoring Agent, seleccione Actualizar. La página de estado muestra el progreso de la actualización.

  6. Cuando aparezca la página Se completó correctamente la configuración de Microsoft Monitoring Agent, seleccione Finalizar.

Actualización desde la línea de comandos

  1. Inicie sesión en el equipo con una cuenta con derechos administrativos.

  2. Para extraer los archivos de instalación del agente, ejecute MMASetup-<platform>.exe /c desde un símbolo del sistema con privilegios elevados y se le solicitará la ruta en la que extraer los archivos. Como alternativa, puede especificar la ruta de acceso pasando los argumentos MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Ejecute el siguiente comando, donde D:\ es la ubicación del archivo de registro de actualización:

    setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1

Actualización del agente de Linux

Es posible actualizar desde versiones anteriores (>1.0.0-47). Si realizas la instalación con el comando --upgrade, se actualizarán todos los componentes del agente a la versión más reciente.

Para actualizar al agente, ejecute el siguiente comando:

sudo sh ./omsagent-*.universal.x64.sh --upgrade

Habilitación de la actualización automática para el agente de Linux

Se recomienda habilitar la actualización automática de extensiones mediante estos comandos para actualizar el agente automáticamente.

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  -EnableAutomaticUpgrade $true

Agregar o quitar un área de trabajo

Agregue o quite un área de trabajo mediante el agente de Windows o el agente de Linux.

Agente de Windows

Los pasos descritos en esta sección son necesarios no solo cuando quiere reconfigurar el agente de Windows para informar a un área de trabajo diferente o eliminar un área de trabajo de su configuración, sino también cuando quiere configurar el agente para que informe a más de un área de trabajo. (Esta práctica se conoce normalmente como hospedaje múltiple). La configuración del agente de Windows para informar a varias áreas de trabajo solo se puede realizar después de la configuración inicial del agente y mediante los métodos descritos en esta sección.

Actualizar la configuración del Panel de control

  1. Inicie sesión en el equipo con una cuenta con derechos administrativos.

  2. Abra el Panel de control.

  3. Seleccione Microsoft Monitoring Agent y luego seleccione la pestaña Azure Log Analytics.

  4. Si quiere eliminar un área de trabajo, selecciónela y, después, haga clic en Quitar. Repita este paso para cualquier otra área de trabajo de la que quiera que el agente deje de informar.

  5. Si va a agregar un área de trabajo, seleccione Agregar. En el cuadro de diálogo Agregar un área de trabajo de Log Analytics, pegue el identificador del área de trabajo y la clave del área de trabajo (clave principal). Si el equipo tiene que notificar a un área de trabajo de Log Analytics en Azure Government Cloud, seleccione Azure Gobierno de EE.UU. en la lista desplegable Azure Cloud.

  6. Seleccione Aceptar para guardar los cambios.

Quitar un área de trabajo con PowerShell

$workspaceId = "<Your workspace Id>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.RemoveCloudWorkspace($workspaceId)
$mma.ReloadConfiguration()

Agregar un área de trabajo en Azure Commercial con PowerShell

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey)
$mma.ReloadConfiguration()

Agregar un área de trabajo en Azure for US Government con PowerShell

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey, 1)
$mma.ReloadConfiguration()

Nota

Si ha usado la línea de comandos o el script anteriormente para instalar o configurar el agente, EnableAzureOperationalInsights se ha reemplazado por AddCloudWorkspace y RemoveCloudWorkspace.

Agente Linux

En los pasos siguientes se muestra cómo volver a configurar el agente de Linux si decide registrarlo en un área de trabajo diferente o si quiere quitar un área de trabajo de la configuración.

  1. Para comprobar que el agente está registrado en un área de trabajo, ejecute el siguiente comando:

    /opt/microsoft/omsagent/bin/omsadmin.sh -l

    Debe devolver un estado similar al del ejemplo siguiente:

    Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

    Es importante que el estado también muestre que el agente se está ejecutando. De lo contrario, los pasos siguientes para volver a configurar el agente no finalizarán correctamente.

  2. Si el agente ya está registrado en un área de trabajo, quite el área de trabajo registrada mediante al ejecución del siguiente comando. En caso contrario, si no está registrado, continúe con el paso siguiente.

    /opt/microsoft/omsagent/bin/omsadmin.sh -X

  3. Para registrarse con otra área de trabajo, ejecute el comando siguiente:

    /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

  4. Para comprobar que los cambios surten efecto, ejecute el siguiente comando:

    /opt/microsoft/omsagent/bin/omsadmin.sh -l

    Debe devolver un estado similar al del ejemplo siguiente:

    Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

El servicio del agente no tiene que reiniciarse para que los cambios surtan efecto.

Actualizar la configuración de proxy

El agente de Log Analytics (MMA) no usa la configuración de proxy del sistema. Como resultado, debe pasar la configuración de proxy mientras instala MMA. Esta configuración se almacenará en la configuración de MMA (registro) en la máquina virtual. Si quiere configurar el agente para comunicarse con el servicio a través de un servidor proxy o la puerta de enlace de Log Analytics después de la implementación, use uno de los métodos siguientes para completar esta tarea.

Agente de Windows

Use un agente de Windows.

Actualizar la configuración con Panel de control

  1. Inicie sesión en el equipo con una cuenta con derechos administrativos.

  2. Abra el Panel de control.

  3. Seleccione Microsoft Monitoring Agent y luego seleccione la pestaña Configuración de proxy.

  4. Seleccione Usar un servidor proxy y especifique la dirección URL y el número de puerto del servidor proxy o puerta de enlace. Si el servidor proxy o la puerta de enlace de Log Analytics requiere autenticación, escriba el nombre de usuario y la contraseña para autenticarse y luego seleccione Aceptar.

Actualizar la configuración con PowerShell

Copie el código de PowerShell de ejemplo siguiente, actualícelo con información específica de su entorno y guárdelo con una extensión de nombre de archivo PS1. Ejecute el script en cada uno de los equipos que se conecta directamente con el área de trabajo de Log Analytics en Azure Monitor.

param($ProxyDomainName="https://proxy.contoso.com:30443", $cred=(Get-Credential))

# First we get the Health Service configuration object. We need to determine if we
#have the right update rollup with the API we need. If not, no need to run the rest of the script.
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'

$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'

if (!$proxyMethod)
{
    Write-Output 'Health Service proxy API not present, will not update settings.'
    return
}

Write-Output "Clearing proxy settings."
$healthServiceSettings.SetProxyInfo('', '', '')

$ProxyUserName = $cred.username

Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)

Agente Linux

Siga estos pasos si los equipos Linux necesitan comunicarse a través de un servidor proxy o la puerta de enlace de Log Analytics. El valor de configuración del servidor proxy tiene la siguiente sintaxis: [protocol://][user:password@]proxyhost[:port]. La propiedad proxyhost acepta un nombre de dominio completo o la dirección IP del servidor proxy.

  1. Edite el archivo /etc/opt/microsoft/omsagent/proxy.conf. Para ello, ejecute los comandos siguientes y cambie los valores según su configuración específica:

    proxyconf="https://proxyuser:proxypassword@proxyserver01:30443"
sudo echo $proxyconf >>/etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf

  2. Ejecute el comando siguiente para reiniciar el agente:

    sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

    Si ve cURL failed to perform on this base url en el registro, puede intentar eliminar '\n' en proxy.conf EOF para resolver el error:

    od -c /etc/opt/microsoft/omsagent/proxy.conf
cat /etc/opt/microsoft/omsagent/proxy.conf | tr -d '\n' > /etc/opt/microsoft/omsagent/proxy2.conf
rm /etc/opt/microsoft/omsagent/proxy.conf
mv /etc/opt/microsoft/omsagent/proxy2.conf /etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf
sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

Desinstalar agente

Use uno de los procedimientos siguientes para desinstalar al agente de Windows o Linux mediante el Asistente para instalación o la línea de comandos.

Agente de Windows

Use el agente de Windows.

Desinstalar desde el Panel de control

  1. Inicie sesión en el equipo con una cuenta con derechos administrativos.

  2. En Panel de control, seleccione Programas y características.

  3. En Programas y características, seleccione Microsoft Monitoring Agent>Desinstalar>Sí.

Nota

También se puede ejecutar el Asistente para instalación del agente haciendo doble clic en MMASetup-\<platform\>.exe, que está disponible para su descarga desde un área de trabajo en Azure Portal.

Desinstalar desde la línea de comandos

El archivo descargado del agente es un paquete de instalación independiente creado con IExpress. El programa de instalación para el agente y los archivos auxiliares se encuentran en el paquete y deben extraerse para realizar la desinstalación correctamente con la línea de comandos que se muestra en el ejemplo siguiente.

  1. Inicie sesión en el equipo con una cuenta con derechos administrativos.

  2. Para extraer los archivos de instalación del agente, desde un símbolo del sistema con privilegios elevados ejecute extract MMASetup-<platform>.exe y se le solicitará la ruta en la que extraer los archivos. Como alternativa, puede especificar la ruta de acceso pasando los argumentos extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Para más información acerca de los modificadores de la línea de comandos compatibles con IExpress, consulte Command-line switches for IExpress (Modificadores de la línea de comandos para IExpress) y, después, actualice el ejemplo para adaptarlo a sus necesidades.

  3. En el símbolo del sistema, escriba %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Agente Linux

Para quitar el agente, ejecute el siguiente comando en el equipo Linux. El argumento --purge quita completamente el agente y su configuración.

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh --purge

Configurar el agente para que envíe notificaciones a un grupo de administración de Operations Manager

Use el agente de Windows.

Agente de Windows

Siga estos pasos para configurar al agente de Log Analytics para Windows para informar a un grupo de administración de System Center Operations Manager.

Nota

Como parte de la transición en curso de Microsoft Operations Management Suite (OMS) a Azure Monitor, se hará referencia al agente de Operations Management Suite para Windows o Linux como el agente de Log Analytics para Windows y el agente de Log Analytics para Linux.

  1. Inicie sesión en el equipo con una cuenta con derechos administrativos.

  2. Abra el Panel de control.

  3. Seleccione Microsoft Monitoring Agent y, después, la pestaña Operations Manager.

  4. Si los servidores de Operations Manager tienen integración con Active Directory, seleccione Actualizar automáticamente asignaciones de grupos de administración desde AD DS.

  5. Seleccione Agregar para abrir el cuadro de diálogo Agregar un grupo de administración.

  6. En el campo Nombre del grupo de administración, escriba el nombre para el grupo de administración.

  7. En el campo Servidor de administración principal, escriba el nombre de equipo del servidor de administración principal.

  8. En el campo Puerto de servidor de administración, escriba el número de puerto TCP.

  9. En Cuenta de acción del agente, seleccione la cuenta de sistema local o una cuenta de dominio local.

  10. Seleccione Aceptar para cerrar el cuadro de diálogo Agregar un grupo de administración. Luego, seleccione Aceptar para cerrar la ventana Propiedades de Microsoft Monitoring Agent.

Agente Linux

Siga estos pasos para configurar al agente de Log Analytics para Linux para informar a un grupo de administración de System Center Operations Manager.

Nota

Como parte de la transición en curso de Microsoft Operations Management Suite (OMS) a Azure Monitor, se hará referencia al agente de Operations Management Suite para Windows o Linux como el agente de Log Analytics para Windows y el agente de Log Analytics para Linux.

  1. Edite el archivo /etc/opt/omi/conf/omiserver.conf.

  2. Asegúrese de que la línea que comienza con httpsport= define el puerto 1270, como httpsport=1270.

  3. Reinicie el servidor OMI mediante el siguiente comando:

    sudo /opt/omi/bin/service_control restart

Preguntas más frecuentes

Esta sección proporciona respuestas a preguntas comunes.

¿Cómo puedo detener la comunicación del agente de Log Analytics con Azure Monitor?

En el caso de los agentes conectados a Log Analytics directamente, abra el panel de control y seleccione Microsoft Monitoring Agent. Elimine todas las áreas de trabajo enumeradas en la pestaña Azure Log Analytics (OMS) . En System Center Operations Manager, quite el equipo de la lista de equipos que administra Log Analytics. Operations Manager actualiza la configuración del agente para que ya no informe a Log Analytics.

Pasos siguientes