Conexión de equipos Linux a Azure MonitorConnect Linux computers to Azure Monitor

Para poder supervisar y administrar máquinas virtuales o equipos físicos del centro de datos local o de otro entorno en la nube con Azure Monitor, debe implementar el agente de Log Analytics y configurarlo para que envíe información a un área de trabajo de Log Analytics.In order to monitor and manage virtual machines or physical computers in your local datacenter or other cloud environment with Azure Monitor, you need to deploy the Log Analytics agent and configure it to report to a Log Analytics workspace. Asimismo, el agente admite el rol de Hybrid Runbook Worker de Azure Automation.The agent also supports the Hybrid Runbook Worker role for Azure Automation.

Si desea instalar el agente de Log Analytics para Linux, siga uno de los métodos siguientes.The Log Analytics agent for Linux can be installed by using one of the following methods. Más adelante en el artículo se proporcionan detalles sobre el uso de cada método.Details on using each method are provided later in the article.

Para comprender la configuración compatible, revise los sistemas operativos Linux admitidos y la configuración del firewall de red.To understand the supported configuration, review supported Linux operating systems and network firewall configuration.

Nota

No se puede configurar el agente de Log Analytics para Linux para informar a varias áreas de trabajo de Log Analytics.The Log Analytics agent for Linux cannot be configured to report to more than one Log Analytics workspace. Solo se puede configurar para enviar informes simultánea o individualmente a un grupo de administración de System Center Operations Manager y a un área de trabajo de Log Analytics.It can only be configured to report to both a System Center Operations Manager management group and Log Analytics workspace concurrently, or to either individually.

Paquete de instalación del agenteAgent install package

El agente de Log Analytics para Linux se compone de varios paquetes.The Log Analytics agent for Linux is composed of multiple packages. El archivo de lanzamiento contiene los siguientes paquetes, que estarán disponibles si el conjunto de paquetes de shell se ejecuta con el parámetro --extract:The release file contains the following packages, which are available by running the shell bundle with the --extract parameter:

PackagePackage VersiónVersion DescripciónDescription
omsagentomsagent 1.12.151.12.15 Agente de Log Analytics para LinuxThe Log Analytics Agent for Linux
omsconfigomsconfig 1.1.11.1.1 Agente para configurar el agente de Log AnalyticsConfiguration agent for the Log Analytics agent
omiomi 1.6.31.6.3 Infraestructura de administración abierta (OMI), servidor de CIM ligeroOpen Management Infrastructure (OMI) -- a lightweight CIM Server. Tenga en cuenta que OMI debe tener acceso raíz para poder ejecutar los trabajos de Cron que son necesarios para que el servicio funcione.Note that OMI requires root access to run a cron job necessary for the functioning of the service
scxscx 1.6.31.6.3 Proveedores de CIM OMI para métricas de rendimiento del sistema operativoOMI CIM Providers for operating system performance metrics
apache-cimprovapache-cimprov 1.0.11.0.1 Proveedor de supervisión de rendimiento de servidor HTTP de Apache para OMI.Apache HTTP Server performance monitoring provider for OMI. Solo se instala si se detecta un servidor HTTP de Apache.Only installed if Apache HTTP Server is detected.
mysql-cimprovmysql-cimprov 1.0.11.0.1 Proveedor de supervisión de rendimiento de servidor MySQL Server para OMI.MySQL Server performance monitoring provider for OMI. Solo se instala si se detecta un servidor MySQL/MariaDB de Apache.Only installed if MySQL/MariaDB server is detected.
docker-cimprovdocker-cimprov 1.0.01.0.0 Proveedor de Docker para OMI.Docker provider for OMI. Solo se instala si se detecta Docker.Only installed if Docker is detected.

Detalles de instalación del agenteAgent installation details

Una vez instalado el agente de Log Analytics para paquetes Linux, se aplicarán los siguientes cambios de configuración adicionales en todo el sistema.After installing the Log Analytics agent for Linux packages, the following additional system-wide configuration changes are applied. Estos artefactos se quitan cuando se desinstala el paquete omsagent.These artifacts are removed when the omsagent package is uninstalled.

  • Se crea un usuario sin privilegios llamado: omsagent .A non-privileged user named: omsagent is created. El demonio se ejecuta con esta credencial.The daemon runs under this credential.
  • Se crea un archivo include de sudoers en /etc/sudoers.d/omsagent.A sudoers include file is created in /etc/sudoers.d/omsagent. Este archivo permite a omsagent reiniciar los demonios syslog y omsagent.This authorizes omsagent to restart the syslog and omsagent daemons. Si la versión de sudo instalada no es compatible con las directivas include de sudo, estas entradas se escribirán en /etc/sudoers.If sudo include directives are not supported in the installed version of sudo, these entries will be written to /etc/sudoers.
  • Se modifica la configuración de Syslog para reenviar un subconjunto de eventos al agente.The syslog configuration is modified to forward a subset of events to the agent. Para más información, consulte este artículo sobre la configuración de colecciones de datos de Syslog.For more information, see Configure Syslog data collection.

En los equipos supervisados con Linux, el agente aparece como omsagent.On a monitored Linux computer, the agent is listed as omsagent. omsconfig es el agente de configuración del agente de Log Analytics para Linux que busca la nueva configuración del portal cada cinco minutos.omsconfig is the Log Analytics agent for Linux configuration agent that looks for new portal side configuration every 5 minutes. Esta nueva configuración actualizada se aplica a los archivos de configuración del agente que se encuentran en /etc/opt/microsoft/omsagent/conf/omsagent.conf.The new and updated configuration is applied to the agent configuration files located at /etc/opt/microsoft/omsagent/conf/omsagent.conf.

Obtención de la clave y el identificador de área de trabajoObtain workspace ID and key

Antes de instalar el agente Log Analytics para Linux, necesita la clave y el identificador de área de trabajo para el área de trabajo de Log Analytics.Before installing the Log Analytics agent for Linux, you need the workspace ID and key for your Log Analytics workspace. Esta información es necesaria para configurar el agente de la forma adecuada y asegurarse de que puede comunicarse correctamente con Azure Monitor.This information is required during setup of the agent to properly configure it and ensure it can successfully communicate with Azure Monitor.

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.As part of the ongoing transition from Microsoft Operations Management Suite to Azure Monitor, the Operations Management Suite Agent for Windows or Linux will be referred to as the Log Analytics agent for Windows and Log Analytics agent for Linux.

  1. En la esquina superior izquierda de Azure Portal, seleccione Todos los servicios.In the upper-left corner of the Azure portal, select All services. En el cuadro de búsqueda, escriba Log Analytics.In the search box, enter Log Analytics. La lista se filtra en función de lo que escriba.As you type, the list filters based on your input. Seleccione Áreas de trabajo de Log Analytics.Select Log Analytics workspaces.

  2. En la lista de áreas de trabajo de Log Analytics, seleccione la que creó anteriormente.In your list of Log Analytics workspaces, select the workspace you created earlier. (Puede que le haya asignado el nombre DefaultLAWorkspace).(You might have named it DefaultLAWorkspace.)

  3. Seleccione Configuración avanzada.Select Advanced settings:

    Menú Opciones avanzadas de Log Analytics en Azure Portal

  4. Seleccione Orígenes conectados y Servidores Linux.Select Connected Sources, and then select Linux Servers.

  5. Encontrará los valores a la derecha de Id. del área de trabajo y Clave principal.The value to the right of Workspace ID and Primary Key. Copie y pegue ambos valores en el editor que prefiera.Copy and paste both into your favorite editor.

Instalación manual del agenteInstall the agent manually

El agente de Log Analytics para Linux viene en un conjunto de scripts de shell autoextraíbles e instalables.The Log Analytics agent for Linux is provided in a self-extracting and installable shell script bundle. Este paquete contiene los paquetes Debian y RPM para cada uno de los componentes del agente y se pueden instalar directamente o extraerse para recuperar los paquetes individuales.This bundle contains Debian and RPM packages for each of the agent components and can be installed directly or extracted to retrieve the individual packages. Hay dos paquetes, uno para arquitecturas x64 y otro para arquitecturas x86.One bundle is provided for x64 and one for x86 architectures.

Nota

En el caso de las máquinas virtuales de Azure, le recomendamos que instale el agente utilizando la extensión de máquina virtual de Log Analytics para Linux.For Azure VMs, we recommend you install the agent on them using the Azure Log Analytics VM extension for Linux.

  1. Descargue y transfiera el conjunto adecuado (x64 o x86) a la máquina virtual o al equipo físico Linux mediante scp o sftp.Download and transfer the appropriate bundle (x64 or x86) to your Linux VM or physical computer, using scp/sftp.

  2. Instale el paquete utilizando el argumento --install.Install the bundle by using the --install argument. Para incluir un área de trabajo de Log Analytics durante la instalación, proporcione los parámetros -w <WorkspaceID> y -s <workspaceKey> que copió anteriormente.To onboard to a Log Analytics workspace during installation, provide the -w <WorkspaceID> and -s <workspaceKey> parameters copied earlier.

    Nota

    Si los paquetes dependientes (por ejemplo, omi, scx, omsconfig o sus versiones anteriores) están instalados, como ocurriría en el caso de que el agente de System Center Operations Manager para Linux estuviera instalado, es necesario utilizar el argumento --upgrade.You need to use the --upgrade argument if any dependent packages such as omi, scx, omsconfig or their older versions are installed, as would be the case if the system Center Operations Manager agent for Linux is already installed.

    sudo sh ./omsagent-*.universal.x64.sh --install -w <workspace id> -s <shared key>
    
  3. Si desea configurar el agente de Linux para instalar un área de trabajo de Log Analytics y conectarse a ella utilizando una puerta de enlace de Log Analytics, ejecute el siguiente comando con el proxy, el identificador del área de trabajo y los parámetros de clave del área de trabajo.To configure the Linux agent to install and connect to a Log Analytics workspace through a Log Analytics gateway, run the following command providing the proxy, workspace ID, and workspace key parameters. Esta configuración se puede especificar en la línea de comandos incluyendo -p [protocol://][user:password@]proxyhost[:port].This configuration can be specified on the command line by including -p [protocol://][user:password@]proxyhost[:port]. La propiedad proxyhost acepta un nombre de dominio completo o una dirección IP del servidor de puerta de enlace de Log Analytics.The proxyhost property accepts a fully qualified domain name or IP address of the Log Analytics gateway server.

    sudo sh ./omsagent-*.universal.x64.sh --upgrade -p https://<proxy address>:<proxy port> -w <workspace id> -s <shared key>
    

    Si se requiere autenticación, deberá especificar el nombre de usuario y la contraseña.If authentication is required, you need to specify the username and password. Por ejemplo:For example:

    sudo sh ./omsagent-*.universal.x64.sh --upgrade -p https://<proxy user>:<proxy password>@<proxy address>:<proxy port> -w <workspace id> -s <shared key>
    
  4. Si desea configurar el equipo Linux para que se conecte a un área de trabajo de Log Analytics situada en la nube de Azure Government, ejecute el comando siguiente con el identificador del área de trabajo y la clave principal que copió anteriormente.To configure the Linux computer to connect to a Log Analytics workspace in Azure Government cloud, run the following command providing the workspace ID and primary key copied earlier.

    sudo sh ./omsagent-*.universal.x64.sh --upgrade -w <workspace id> -s <shared key> -d opinsights.azure.us
    

Si desea instalar los paquetes del agente y configurarlos para que posteriormente envíen información a un área de trabajo de Log Analytics, ejecute el siguiente comando:If you want to install the agent packages and configure it to report to a specific Log Analytics workspace at a later time, run the following command:

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

Para extraer los paquetes de agente del conjunto de paquetes sin instalarlos, ejecute el siguiente comando:If you want to extract the agent packages from the bundle without installing the agent, run the following command:

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

Instalación del agente con un script contenedorInstall the agent using wrapper script

Los pasos siguientes permiten configurar el agente de Log Analytics en Azure y la nube de Azure Government utilizando el script contenedor en aquellos equipos Linux que puedan conectarse directamente o a través de un servidor proxy para descargar el agente hospedado en GitHub e instalar el agente.The following steps configure setup of the agent for Log Analytics in Azure and Azure Government cloud using the wrapper script for Linux computers that can communicate directly or through a proxy server to download the agent hosted on GitHub and install the agent.

Si el equipo Linux necesita un servidor proxy para comunicarse con Log Analytics, esta configuración puede especificarse en la línea de comandos incluyendo -p [protocol://][user:password@]proxyhost[:port].If your Linux computer needs to communicate through a proxy server to Log Analytics, this configuration can be specified on the command line by including -p [protocol://][user:password@]proxyhost[:port]. La propiedad protocol acepta http o https, y la propiedad proxyhost acepta el nombre de dominio completo o la dirección IP del servidor proxy.The protocol property accepts http or https, and the proxyhost property accepts a fully qualified domain name or IP address of the proxy server.

Por ejemplo: https://proxy01.contoso.com:30443For example: https://proxy01.contoso.com:30443

Si se requiere autenticación en alguno de los dos casos, deberá especificar el nombre de usuario y la contraseña.If authentication is required in either case, you need to specify the username and password. Por ejemplo: https://user01:password@proxy01.contoso.com:30443For example: https://user01:password@proxy01.contoso.com:30443

  1. Si desea configurar el equipo Linux para que se conecte a un área de trabajo de Log Analytics, ejecute el comando siguiente con el identificador del área de trabajo y la clave principal.To configure the Linux computer to connect to a Log Analytics workspace, run the following command providing the workspace ID and primary key. El siguiente comando descarga el agente, valida su suma de comprobación y lo instala.The following command downloads the agent, validates its checksum, and installs it.

    wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -w <YOUR WORKSPACE ID> -s <YOUR WORKSPACE PRIMARY KEY>
    

    El siguiente comando incluye el parámetro de proxy -p y la sintaxis de ejemplo necesaria cuando el servidor proxy requiere autenticación:The following command includes the -p proxy parameter and example syntax when authentication is required by your proxy server:

     wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -p [protocol://]<proxy user>:<proxy password>@<proxyhost>[:port] -w <YOUR WORKSPACE ID> -s <YOUR WORKSPACE PRIMARY KEY>
    
  2. Para configurar el equipo Linux de modo que se conecte con un área de trabajo de Log Analytics en la nube de Azure Government, ejecute el comando siguiente con el identificador del área de trabajo y la clave principal que ha copiado anteriormente.To configure the Linux computer to connect to Log Analytics workspace in Azure Government cloud, run the following command providing the workspace ID and primary key copied earlier. El siguiente comando descarga el agente, valida su suma de comprobación y lo instala.The following command downloads the agent, validates its checksum, and installs it.

    wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -w <YOUR WORKSPACE ID> -s <YOUR WORKSPACE PRIMARY KEY> -d opinsights.azure.us
    

    El siguiente comando incluye el parámetro de proxy -p y la sintaxis de ejemplo necesaria cuando el servidor proxy requiere autenticación:The following command includes the -p proxy parameter and example syntax when authentication is required by your proxy server:

     wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -p [protocol://]<proxy user>:<proxy password>@<proxyhost>[:port] -w <YOUR WORKSPACE ID> -s <YOUR WORKSPACE PRIMARY KEY> -d opinsights.azure.us
    
  3. Ejecute el comando siguiente para reiniciar el agente:Restart the agent by running the following command:

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

Actualización desde una versión anteriorUpgrade from a previous release

A partir de la versión 1.0.0-47, todos los lanzamientos permiten actualizar desde la versión anterior.Upgrading from a previous version, starting with version 1.0.0-47, is supported in each release. Realice la instalación con el parámetro --upgrade para actualizar todos los componentes del agente a la última versión.Perform the installation with the --upgrade parameter to upgrade all components of the agent to the latest version.

Pasos siguientesNext steps