Instala el agente de Cloud Logging en una VM única

Punto clave: Ahora puedes instalar todos los agentes de Google Cloud's operations suite en toda tu flota de VM de Linux de Compute Engine en un solo paso. Con un comando, puedes crear una política que regule las VM nuevas y existentes, lo que garantiza una instalación adecuada y una actualización automática opcional de ambos agentes. Para obtener más información, consulta la guía Administra políticas de agentes.

El agente de Logging transmite registros de tus instancias de VM y de paquetes de software de terceros seleccionados a Cloud Logging. Se recomienda ejecutar el agente de Logging en todas las instancias de VM.

Las imágenes de VM para 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 las VM se ejecutan en Google Kubernetes Engine o App Engine, el agente ya está incluido en la imagen de VM, así que puedes omitir esta página.

Si ejecutas cargas de trabajo de registro especializadas que requieren mayor capacidad de procesamiento o mejora en la eficiencia de los recursos en comparación con el agente de Cloud Logging estándar, considera usar el agente de operaciones.

Antes de comenzar

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

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

  • Durante la instalación del agente de Logging, se requiere un mínimo de 250 MiB de memoria, pero se recomienda 1 GiB.

  Además, asegúrate de que tu VM ejecute un sistema operativo compatible.

• Un lugar de trabajo que supervise la cuenta de AWS que contiene la instancia de VM. Para obtener información sobre los precios, ve a Precios de Google Cloud's operations suite.

• Las credenciales en la instancia de VM que autorizan la comunicación con Cloud Logging o Cloud Monitoring. Por lo general, las instancias de VM de Compute Engine tienen las credenciales adecuadas de forma predeterminada. Si alguno de los siguientes casos se aplica a tu situación, es posible que no tengas las credenciales adecuadas y debas completar los procedimientos que se indican en Autoriza a un agente:

  • Si ejecutas instancias de VM de AWS EC2, deberás instalar las credenciales de autorización en tus VM antes de instalar el agente

  • Si ejecutas instancias de Compute Engine muy antiguas o instancias de Compute Engine creadas sin las credenciales predeterminadas

  Para comprobar si tienes las credenciales adecuadas, ejecuta los procedimientos que se indican en Verifica las credenciales de Compute Engine.

Proyectos de Google Cloud para instancias de VM de AWS EC2

Cuando la documentación menciona al proyecto de Google Cloud asociado a tu instancia de VM, en el caso de las instancias de VM de EC2, esta frase hace referencia al proyecto del conector de AWS vinculado a tu cuenta de AWS.

Cuando conectas tu cuenta de AWS a un lugar de trabajo, se crea el proyecto del conector de AWS. Para identificar el proyecto de conector de AWS, ve a la pestaña Configuración del lugar de trabajo. El proyecto de conector se enumera en el encabezado Cuentas de AWS. En la columna ID del proyecto, se muestran los proyectos de Google Cloud asociados con tu lugar de trabajo.

Consulta la página Lugares de trabajo para obtener más información sobre los proyectos de conector de AWS.

Nota: No instales el agente en una instancia de VM de EC2 hasta que hayas conectado tu cuenta de AWS a un lugar de trabajo. Hasta que la conexión esté disponible, no habrá ningún proyecto de Google Cloud asociado y, por lo tanto, no habrá ningún lugar para enviar datos.

VM sin acceso a paquetes remotos

La instalación del agente de Logging requiere acceso a los repositorios de paquetes remotos, tanto para el paquete del agente (en Linux) como para sus dependencias.

Si usas VPC-SC o una red privada, la configuración de red también puede afectar tu capacidad para instalar dependencias de agentes de repositorios ascendentes. El agente en sí puede accederse a través de Acceso privado a Google,

Si la política de seguridad de tu host de VM niega el acceso a los repositorios de paquetes remotos, te recomendamos crear una imagen de VM personalizada con el agente preinstalado y, luego, inhabilitar la administración de paquetes de esa imagen.

Instala el agente en una sola VM

Para reiniciar el agente, sigue estas instrucciones.

AMAZON LINUX AMI / CENTOS / RHEL

1. Abre una conexión de terminal en 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, como tu directorio principal.

3. Agrega el repositorio de paquetes del agente:

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

4. Instala el agente:

   1. Crea una lista de las versiones disponibles del agente para seleccionar qué versión instalar:

      sudo yum list --showduplicates google-fluentd
      

   2. Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la incorporación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:

      sudo yum install -y google-fluentd-major-version.*
      

      Por ejemplo, si deseas fijar la versión 1.x.x del agente, ejecuta este comando:

      sudo yum install -y google-fluentd-1.*
      

   3. Si no deseas fijar una versión principal, puedes seleccionar una de las otras opciones de instalación:

      1. Para instalar una versión específica del agente, ejecuta este comando:

           sudo yum install -y google-fluentd-version-number
         

      2. Para instalar la versión más reciente del agente, ejecuta este comando:

           sudo yum install -y google-fluentd
         

5. Instala los archivos de configuración.

   1. Para los registros no estructurados, ejecuta este comando:

      sudo yum install -y google-fluentd-catch-all-config
      

   2. Para los registros estructurados, ejecuta este comando:

      sudo yum install -y google-fluentd-catch-all-config-structured
      

      Si deseas obtener información sobre los registros estructurados, consulta la guía de registros estructurados.

6. Reinicia el servicio del agente

   Es necesario reiniciar el sistema para que se apliquen las configuraciones instaladas mediante los paquetes genéricos antes mencionados.

   sudo service google-fluentd restart
   

Puedes borrar la secuencia de comandos de instalación una vez que se ejecute de forma correcta.

• Para verificar que el agente funcione de la forma prevista, 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.

DEBIAN / UBUNTU

1. Abre una conexión de terminal en 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, como tu directorio principal.

3. Agrega el repositorio de paquetes del agente:

   curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh && \
   sudo bash add-logging-agent-repo.sh && \
   sudo apt-get update
   

4. Instala el agente:

   1. Crea una lista de las versiones disponibles del agente para seleccionar qué versión instalar:

      sudo apt-cache madison google-fluentd
      

   2. Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la incorporación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:

      sudo apt-get install -y 'google-fluentd=major-version.*'
      

      Por ejemplo, si deseas fijar la versión 1.x.x del agente, ejecuta este comando:

      sudo apt-get install -y 'google-fluentd=1.*'
      

   3. Si no deseas fijar una versión principal, puedes seleccionar una de las otras opciones de instalación:

      1. Para instalar una versión específica del agente, ejecuta este comando:

           sudo apt-get install -y google-fluentd=version-number
         

      2. Para instalar la versión más reciente del agente, ejecuta este comando:

           sudo apt-get install -y google-fluentd
         

5. Instala los archivos de configuración.

   1. Para los registros no estructurados, ejecuta este comando:

      sudo apt-get install -y google-fluentd-catch-all-config
      

   2. Para los registros estructurados, ejecuta este comando:

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

      Si deseas obtener información sobre los registros estructurados, consulta la guía de registros estructurados.

6. Reinicia el servicio del agente

   Es necesario reiniciar el sistema para que se apliquen las configuraciones instaladas mediante los paquetes genéricos antes mencionados.

   sudo service google-fluentd restart
   

Puedes borrar la secuencia de comandos de instalación una vez que se ejecute de forma correcta.

• Para verificar que el agente funcione de la forma prevista, 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.

SLES / SUSE

1. Abre una conexión de terminal en 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, como tu directorio principal.

3. Agrega el repositorio de paquetes del agente:

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

4. Instala el agente:

   1. Crea una lista de las versiones disponibles del agente para seleccionar qué versión instalar:

      sudo zypper search -s google-fluentd
      

   2. Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la incorporación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:

      sudo zypper install -y 'google-fluentd<major-version.0.0'
      

      Por ejemplo, si deseas fijar la versión 1.x.x del agente, ejecuta este comando:

      sudo zypper install -y 'google-fluentd<2.0.0'
      

   3. Si no deseas fijar una versión principal, puedes seleccionar una de las otras opciones de instalación:

      1. Para instalar una versión específica del agente, ejecuta este comando:

           sudo zypper install -y google-fluentd=version-number
         

      2. Para instalar la versión más reciente del agente, ejecuta este comando:

           sudo zypper install -y google-fluentd
         

5. Instala los archivos de configuración.

   1. Para los registros no estructurados, ejecuta este comando:

      sudo zypper install -y google-fluentd-catch-all-config
      

   2. Para los registros estructurados, ejecuta este comando:

      sudo zypper install -y google-fluentd-catch-all-config-structured
      

      Si deseas obtener información sobre los registros estructurados, consulta la guía de registros estructurados.

6. Reinicia el servicio del agente

   Es necesario reiniciar el sistema para que se apliquen las configuraciones instaladas mediante los paquetes genéricos antes mencionados.

   sudo service google-fluentd restart
   

Puedes borrar la secuencia de comandos de instalación una vez que se ejecute de forma correcta.

• Para verificar que el agente funcione de la forma prevista, 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

Beta

Este producto o función está cubierto por las Condiciones de las ofertas anteriores a la disponibilidad general de las Condiciones del Servicio de Google Cloud Platform. Los productos y las características anteriores a la disponibilidad general pueden tener asistencia limitada, y los cambios en estos productos y características podrían no ser compatibles con otras versiones anteriores a la disponibilidad general. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para instalar el agente en una instancia de VM que ejecute Windows, sigue estos pasos:

1. Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.

2. Abre una terminal de PowerShell y ejecuta los siguientes comandos de PowerShell. No necesitas privilegios de administrador.

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

   Como alternativa, puedes navegar a la siguiente URL para descargar y ejecutar el instalador del agente:

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

   Precaución: Debes descargar el instalador en un directorio que no sea del sistema, como C:\Users\[USERNAME]. Por motivos de seguridad, el instalador no se ejecuta desde los directorios del sistema, incluido el directorio C:\.
   Si descargas el instalador en un directorio del sistema, trasládalo a otro directorio antes de ejecutarlo.
   Nota: El instalador del agente también admite una opción "silenciosa", /S, que se puede usar en la secuencia de comandos de la instalación.

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

   .\StackdriverLogging-v1-14.exe /S
   

   Precaución: La instalación silenciosa es una operación asíncrona. El agente aún no está instalado cuando se cierra el comando de instalación. Para comprobar si la instalación se realizó correctamente, busca el servicio StackdriverLogging.
   Nota: El instalador coloca el agente en el directorio “C:\Program Files (x86)\Stackdriver\LoggingAgent” de forma predeterminada. Puedes cambiar ese directorio durante la instalación.

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

   .\StackdriverLogging-v1-14.exe /S /D="C:\Google Cloud's operations suite\Logging\"
   

   Puedes borrar el instalador una vez que la instalación se complete de forma correcta.

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

Instala el agente en una VM de Compute Engine

Puedes instalar el agente de Logging en una sola VM desde el panel de instancias de VM de Monitoring preconfiguradas.

Para acceder a este panel, haz lo siguiente:

1. En Cloud Console, selecciona tu proyecto de Google Cloud.
   Ir a Cloud Console
2. En el panel de navegación, selecciona Monitoring.

   Si nunca usaste Cloud Monitoring, entonces, en tu primer acceso a Monitoring en Google Cloud Console, se crea un lugar de trabajo de forma automática y tu proyecto se asocia con ese lugar de trabajo. De lo contrario, si el proyecto no está asociado con un lugar de trabajo, aparecerá un diálogo y podrás crear uno o agregar tu proyecto a un lugar de trabajo existente. Te recomendamos que crees un lugar de trabajo. Después de realizar la selección, haz clic en Agregar.

3. En el panel de navegación de Monitoring, selecciona Alertas.
4. En la tabla de paneles, ubica la entrada Instancias de VM y haz clic en el nombre.

La pestaña Inventario en el panel Instancias de VM muestra todas las VM y contiene una columna de estado para el agente, como se muestra en la siguiente captura de pantalla:

Si el agente no se detecta en una instancia de Compute Engine, puedes hacer clic en el vínculo "No detectado" para abrir un flujo de trabajo de instalación en el panel.

Tareas opcionales

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

Configura el agente

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

Para ajustar la configuración del agente, consulta Configura el agente.

Configura un proxy HTTP

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

LINUX

1. Edita el siguiente archivo de configuración (debe crearse si no existe):

    /etc/default/google-fluentd
   

2. Agrega estas líneas:

    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. Ejecuta el siguiente comando en tu instancia de VM para reiniciar el agente de Logging:

    sudo service google-fluentd restart
   

WINDOWS

1. Si usas un proxy HTTP, ejecuta el siguiente comando desde un símbolo del sistema del administrador. De este modo, se configuran las variables de entorno http_proxy y https_proxy para que el agente pueda enviar datos a Logging mediante el HTTPS de salida:

   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
   

Determina la versión del agente

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

AMAZON LINUX AMI / CENTOS / 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 y accede a Windows.

2. Abre una terminal de PowerShell y ejecuta los siguientes comandos. Necesitas privilegios de administrador.

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

Reinicia el agente

Debes reiniciar el agente de Logging para que este incorpore los cambios de 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

Luego de reiniciar el agente de Logging, te recomendamos enviar un mensaje de prueba.

WINDOWS

1. Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.

2. Abre una terminal de PowerShell y ejecuta los siguientes comandos. Necesitas privilegios de administrador.

Restart-Service -Name StackdriverLogging

Actualiza el agente

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

Nota: Si actualizaste el sistema operativo Linux de tu instancia a una nueva versión principal, es mejor que no actualices el agente con este procedimiento, sino que lo quites y, luego, vuelvas a instalarlo según los procedimientos que se indican en esta página.

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum upgrade google-fluentd

El comando anterior no cambia el archivo de configuración del agente. Para obtener la configuración predeterminada más reciente y los archivos de configuración genéricos, ejecuta los siguientes comandos en tu instancia:

sudo yum upgrade google-fluentd google-fluentd-catch-all-config

DEBIAN / UBUNTU

Ejecuta los siguientes comandos en Debian o Ubuntu:

sudo apt-get update
sudo apt-get install -y --only-upgrade google-fluentd

Los comandos anteriores no cambian el archivo de configuración del agente. Para obtener la configuración predeterminada más reciente y los archivos de configuración genéricos, ejecuta los siguientes comandos en tu instancia:

sudo apt-get install -y --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install -y --only-upgrade google-fluentd

SLES / SUSE

Ejecuta el siguiente comando en SUSE:

sudo zypper update google-fluentd

El comando anterior no cambia el archivo de configuración del agente. Para obtener la configuración predeterminada más reciente y los archivos de configuración genéricos, ejecuta los siguientes comandos en tu instancia:

sudo zypper update google-fluentd google-fluentd-catch-all-config

WINDOWS

Para actualizar a la última versión del agente, instala el agente más reciente según se indica en la sección de esta página sobre la instalación en Windows. El instalador te solicitará que desinstales la versión anterior del agente.

Desinstala el agente

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

Nota: Si agregaste tus propios archivos de configuración de fluentd, cópialos del directorio de configuración del agente para que no se pierdan durante este proceso.

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

DEBIAN / UBUNTU

Ejecuta el siguiente comando en Debian o Ubuntu:

sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

SLES / SUSE

Ejecuta el siguiente comando en SUSE Linux:

sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

WINDOWS

En el panel de control de Windows, elige Desinstalar un programa. Deberías ver el agente de Logging en la lista de programas que puedes desinstalar.