Instalar el agente de Cloud Logging en máquinas virtuales concretas

El agente de Logging transmite registros desde tus instancias de VM y desde paquetes de software de terceros seleccionados a Cloud Logging. Es una práctica recomendada ejecutar el agente de Logging en todas las instancias de máquina virtual.

Las imágenes de VM de Compute Engine y Amazon Elastic Compute Cloud (EC2) no incluyen el agente de Logging, por lo que debes completar estos pasos para instalarlo en esas instancias. El agente se ejecuta en Linux y Windows.

Si tus VMs se ejecutan en Google Kubernetes Engine o App Engine, el agente ya está incluido en la imagen de la VM, por lo que puedes saltarte esta página.

Antes de empezar

Para instalar el agente, asegúrate de que tienes lo siguiente:

  • Una instancia de VM compatible en un Google Cloud proyecto o una cuenta de Amazon Web Services (AWS).

    • Al instalar el agente de Logging, se necesitan 250 MiB de memoria como mínimo, pero se recomienda 1 GiB.

    Asegúrate también de que tu VM ejecute un sistema operativo compatible.

  • Credenciales en la instancia de VM que autorizan la comunicación con Cloud Logging o Cloud Monitoring. Las instancias de VM de Compute Engine suelen tener las credenciales correctas de forma predeterminada. Si te encuentras en alguna de las siguientes situaciones, es posible que no tengas las credenciales adecuadas y debas completar los procedimientos de autorización del agente de registro:

    • Si ejecutas instancias de VM de AWS EC2, debes instalar credenciales de autorización en tus VMs antes de instalar el agente.

    • Ejecutar instancias de Compute Engine muy antiguas o instancias de Compute Engine creadas sin las credenciales predeterminadas.

    Para comprobar si tienes las credenciales adecuadas, sigue los procedimientos de verificación de las credenciales de Compute Engine.

  • Para obtener información sobre los precios, consulta la página Precios de Google Cloud Observability.

  • Si usas VMs que no tienen acceso a repositorios de paquetes remotos, consulta la sección VMs sin acceso a paquetes remotos para obtener más información.

Instalar el agente desde la línea de comandos

Para instalar el agente mediante la línea de comandos, sigue estas instrucciones.

Instalar la versión más reciente del agente

Para instalar la versión más reciente del agente, sigue estos pasos.

Linux

  1. Abre una conexión de terminal a tu instancia de VM mediante SSH o una herramienta similar y asegúrate de tener acceso sudo.

  2. Cambia a un directorio al que tengas acceso de escritura, por ejemplo, tu directorio principal.

  3. Descarga y ejecuta la secuencia de comandos de instalación del agente con los siguientes comandos:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
sudo bash add-logging-agent-repo.sh --also-install

    Una vez instalado, el agente se inicia automáticamente.

Windows

  1. Conéctate a tu instancia mediante RDP o una herramienta similar e inicia sesión en Windows.

  2. Abre una terminal de PowerShell con privilegios de administrador haciendo clic con el botón derecho en el icono de PowerShell y seleccionando Ejecutar como administrador.

  3. Ejecuta los siguientes comandos de PowerShell:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-22.exe", "${env:UserProfile}\StackdriverLogging-v1-22.exe")
& "${env:UserProfile}\StackdriverLogging-v1-22.exe"

Instalar una versión específica del agente

Para instalar una versión específica del agente, sigue estos pasos.

Linux

  1. Abre una conexión de terminal a tu instancia de VM mediante SSH o una herramienta similar y asegúrate de tener acceso sudo.

  2. Cambia a un directorio al que tengas acceso de escritura, por ejemplo, tu directorio principal.

  3. Descarga la secuencia de comandos de instalación del agente:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh

    Al ejecutar la secuencia de comandos add-logging-agent-repo.sh, también puedes definir las siguientes marcas:

    • --verbose: activa el registro detallado durante la ejecución de la secuencia de comandos.
    • --also-install: instala el agente después de añadir el repositorio del paquete del agente.
    • --version: define la versión del agente del script que se va a instalar. Para obtener información sobre las versiones, consulta Listar todas las versiones del agente.
    • --uninstall: desinstala el agente.
    • --remove-repo: elimina el repositorio de paquetes del agente correspondiente después de instalar o desinstalar el agente.
    • --dry-run: solo activa una prueba de la ejecución de la secuencia de comandos e imprime los comandos que se supone que debe ejecutar.

    Consulta los comentarios de la secuencia para obtener más información y ejemplos de uso.

  4. Añade el repositorio de paquetes del agente e instala el agente:

    1. Para ver una lista de las versiones del agente disponibles, consulta Mostrar todas las versiones del agente.

    2. En los entornos de producción, puede que quieras fijar una versión principal para evitar instalar versiones principales que puedan incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:

      sudo bash add-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

      Por ejemplo, para fijar la versión 1.x.x del agente, ejecuta lo siguiente:

      sudo bash add-logging-agent-repo.sh --also-install \
  --version=1.*.*

    3. Para instalar una versión específica del agente, ejecuta el siguiente comando:

      sudo bash add-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION

  5. Reiniciar el servicio del agente

    Es necesario reiniciar para que las configuraciones que instalan los paquetes catch-all anteriores surtan efecto.

    sudo service google-fluentd restart

Puedes eliminar la secuencia de comandos de instalación una vez que se haya ejecutado correctamente.

  • Para verificar que el agente funciona correctamente, ejecuta el siguiente comando:

    sudo service google-fluentd status

    El estado del agente debe ser OK.

  • También puedes examinar los registros y asegurarte de que no haya errores:

    tail /var/log/google-fluentd/google-fluentd.log

Si tienes problemas con la instalación, consulta la página Solución de problemas.

Windows

  1. Conéctate a tu instancia mediante RDP o una herramienta similar e inicia sesión en Windows.

  2. Abre una terminal de PowerShell con privilegios de administrador haciendo clic con el botón derecho en el icono de PowerShell y seleccionando Ejecutar como administrador.

    1. Ejecuta los siguientes comandos de PowerShell:

      (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-22.exe", "${env:UserProfile}\StackdriverLogging-v1-22.exe")
& "${env:UserProfile}\StackdriverLogging-v1-22.exe"

    También puedes ir a la siguiente URL para descargar y ejecutar el instalador del agente:

    https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-22.exe

    Para instalar el agente de forma silenciosa, añade la opción /S a la invocación del instalador:

    & "${env:UserProfile}\StackdriverLogging-v1-22.exe" /S
    .

    En el modo "silencioso", usa la opción /D para especificar el directorio de instalación. Por ejemplo:

    & "${env:UserProfile}\StackdriverLogging-v1-22.exe" /S /D="C:\Stackdriver\Logging\"

    Puedes eliminar el instalador cuando se haya completado correctamente.

    Si tienes problemas con la instalación, consulta la página Solución de problemas.

Ver información del agente mediante la Google Cloud consola

Puedes consultar información sobre el estado del agente en el panel de control Instancias de VM de Monitoring preconfigurado. Para acceder a este panel de control, siga estos pasos:

En la Google Cloud consola, ve a la página Panel de control de instancias de VM:

Ve al panel de control de instancias de VM.

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

En la vista Lista de la pestaña Inventario del panel de control se muestran todas las máquinas virtuales y se incluye una columna de estado para tu agente, como se muestra en la siguiente captura de pantalla:

El panel de control Instancias de VM de Monitoring muestra el estado de los agentes.

La columna Agente muestra los siguientes valores:

  • No detectado: no tienes ningún agente instalado o no se está ejecutando. Si no sabes si has instalado un agente, puedes consultar la versión instalada. Si has instalado el agente, puedes reiniciarlo.

  • Agente de operaciones: estás ejecutando el agente de operaciones. Si no ves una marca de verificación verde junto a la entrada, significa que hay una actualización del agente disponible, en función del sistema operativo detectado de tu VM.

    Si colocas el cursor sobre el indicador del agente de operaciones en la tabla, verás información sobre la versión del agente de operaciones. Si estás usando una versión anterior, también verás una recomendación para actualizar tu agente.

  • Pendiente: el Agente de operaciones se está instalando o actualizando.

  • No se ha podido instalar el agente: no se ha podido instalar el Agente de operaciones.

  • No se recogen datos de telemetría: la instalación del agente de Ops se ha completado correctamente, pero el agente aún no envía datos de telemetría.

  • Agente antiguo: estás usando el agente de Monitoring o el de Logging antiguos. Consulta el artículo Migrar de los agentes antiguos al agente de operaciones para obtener información sobre cómo cambiar al agente de operaciones.

  • No aplicable: esta VM no es una plataforma compatible para ejecutar el agente.

  • VM Stopped: la VM no se está ejecutando, por lo que no se conoce el estado del agente.

Para instalar el Agente de operaciones, sigue estos pasos:

  • Selecciona las instancias de VM en las que quieras instalar agentes.
  • En la tabla Instancias, haz clic en la opción Instalar o actualizar el agente de operaciones.

También puedes instalar o actualizar el agente de operaciones desde la página Detalles de la VM de una VM específica.

Cuando sea posible, el agente se instalará mediante una política de SO del agente de operaciones. Para obtener más información, consulta Gestionar las máquinas virtuales cubiertas por la política de SO del agente de Ops. Las políticas de SO del agente de Ops no son compatibles con todas las versiones de todos los sistemas operativos. En este caso, al hacer clic en Instalar o actualizar el Agente de operaciones, se muestra una serie de comandos que se deben ejecutar en Cloud Shell.

El agente de operaciones recoge tanto métricas como registros de forma predeterminada. Puedes cambiar este comportamiento predeterminado configurando el agente de operaciones.

Tareas opcionales

En esta sección se describe cómo realizar tareas de mantenimiento habituales.

Habilitar el almacenamiento de registros estructurado

Cuando ejecutas la secuencia de comandos de instalación en una máquina virtual Linux, la secuencia de comandos instala de forma predeterminada el paquete google-fluentd-catch-all cuando está presente la marca --also-install. Para cambiar al registro estructurado, sigue estos pasos.

  1. Crea una copia de seguridad de los cambios locales de /etc/google-fluentd/config.d/.

  2. Ejecuta uno de los siguientes comandos, en función de tu distribución de Linux:

    • YUM:

      sudo yum remove -y google-fluentd-catch-all-config
sudo yum install -y google-fluentd-catch-all-config-structured
sudo service google-fluentd restart

    • APT:

      sudo apt-get remove -y google-fluentd-catch-all-config
sudo apt-get install -y google-fluentd-catch-all-config-structured
sudo service google-fluentd restart

Para obtener información sobre el registro estructurado, consulta la guía sobre registro estructurado.

Configurar el agente de Logging

El agente viene preconfigurado para monitorizar determinadas ubicaciones de registro conocidas. En Linux, estas ubicaciones se describen en el paquete google-fluentd-catch-all-config, que se extrae automáticamente mediante la secuencia de comandos de instalación. En Windows, el agente monitoriza el registro de eventos de Windows de forma predeterminada.

Para ajustar la configuración del agente, consulta Configurar el agente de Logging.

Configurar un proxy HTTP

Si usas un proxy HTTP para enviar solicitudes a las APIs Logging y Monitoring, haz lo siguiente:

Linux

  1. Edita el siguiente archivo de configuración (créalo si aún no existe):

     /etc/default/google-fluentd

  2. Añade lo siguiente al archivo:

     export http_proxy="http://proxy-ip:proxy-port"
 export https_proxy="http://proxy-ip:proxy-port"
 export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.

  3. Reinicia el agente ejecutando el siguiente comando en tu instancia de VM:

     sudo service google-fluentd restart

Windows

  1. Si usas un proxy HTTP, ejecuta el siguiente comando desde un símbolo del sistema de administrador. De esta forma, se definen las variables de entorno http_proxy y https_proxy para que el agente pueda enviar datos mediante HTTPS saliente:

    setx http_proxy http://proxy-ip:proxy-port /m
setx https_proxy http://proxy-ip:proxy-port /m
setx no_proxy 169.254.169.254 /m

Determinar la versión del agente

Para determinar la versión del agente de Logging en tu sistema, ejecuta los siguientes comandos en tu instancia de VM:

AMI DE AMAZON LINUX, CENTOS O RHEL

Ejecuta el siguiente comando en Amazon Linux, Red Hat o CentOS Linux:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

DEBIAN/UBUNTU

Ejecuta el siguiente comando en Debian o Ubuntu:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

SLES/SUSE

Ejecuta el siguiente comando en SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

WINDOWS

  1. Conéctate a tu instancia mediante RDP o una herramienta similar e inicia sesión en Windows.

  2. Abre una terminal de PowerShell con privilegios de administrador haciendo clic con el botón derecho en el icono de PowerShell y seleccionando Ejecutar como administrador.

  3. Ejecuta este comando de PowerShell:

     reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version

Reiniciar el agente

Debes reiniciar el agente de registro para que se apliquen los cambios en los archivos de configuración. Para reiniciar el agente, sigue estas instrucciones.

LINUX

Ejecuta el siguiente comando en tu instancia:


     sudo service google-fluentd restart

Después de reiniciar el agente de Logging, puedes enviar un mensaje de prueba.

Windows

  1. Conéctate a tu instancia mediante RDP o una herramienta similar e inicia sesión en Windows.

  2. Abre una terminal de PowerShell con privilegios de administrador haciendo clic con el botón derecho en el icono de PowerShell y seleccionando Ejecutar como administrador.

  3. Ejecuta este comando de PowerShell:

Restart-Service -Name StackdriverLogging

Actualizar el agente

Para actualizar el agente de Logging a la versión más reciente, sigue estas instrucciones:

Linux

Para actualizar el agente a la versión más reciente, ejecuta el siguiente comando:

sudo bash add-logging-agent-repo.sh --also-install

Para actualizar el agente a la última versión secundaria de una versión principal específica, ejecuta el siguiente comando:

sudo bash add-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Para actualizar a la versión más reciente del agente, instale la versión más reciente del agente tal como se describe en la sección Instalar en Windows de esta página. El instalador te pedirá que desinstales la versión anterior del agente.

Mostrar todas las versiones del agente

Para ver las versiones disponibles del agente, ejecuta el siguiente comando:

AMI DE AMAZON LINUX, CENTOS O RHEL

Lista las versiones disponibles del agente:

sudo yum list --showduplicates google-fluentd

DEBIAN/UBUNTU

Lista las versiones disponibles del agente:

sudo apt-cache madison google-fluentd

SLES/SUSE

Lista las versiones disponibles del agente:

sudo zypper search -s google-fluentd

WINDOWS

No se admite la instalación de versiones anteriores del agente en Windows.

Desinstalar el agente

Para quitar el agente Logging y sus archivos de configuración, sigue estas instrucciones.

Después de desinstalar el agente, la consola Google Cloud puede tardar hasta una hora en registrar este cambio.

del agente para guardarlos.

Linux

Ejecuta el siguiente comando:

sudo bash add-logging-agent-repo.sh --uninstall

Opcionalmente, para quitar el repositorio además de desinstalar el agente, añade --remove-repo al comando anterior.

Windows

En el Panel de control de Windows, elige Desinstalar un programa. Debería ver el agente de registro en la lista de programas que puede desinstalar. También puedes ejecutar uninstall.exe desde el directorio en el que hayas instalado el agente de registro.

VMs sin acceso remoto a paquetes

Para instalar el agente de Logging se necesita acceso a repositorios de paquetes remotos, tanto para el paquete del agente como para sus dependencias (en Linux).

Si usas VPC-SC o una red privada, la configuración de la red también puede afectar a tu capacidad para instalar dependencias del agente desde repositorios upstream. Se puede acceder a los paquetes de agentes mediante Acceso privado de Google. Para configurarlo, sigue los pasos que se indican en el artículo Habilitar Acceso privado a Google.

Si la política de seguridad de tu host de VM deniega el acceso a repositorios de paquetes remotos, te recomendamos que crees una imagen de VM personalizada con el agente preinstalado y que inhabilites la gestión de paquetes en esa imagen.

Siguientes pasos