Instala el agente de Stackdriver Logging

El agente de Logging transmite registros de tus instancias de VM y de paquetes de software de terceros seleccionados a Stackdriver Logging. Se recomienda ejecutar el agente de Logging en todas tus 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.

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.
  • 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 la página con los precios de Stackdriver.

  • Credenciales en la instancia de VM que autoricen la comunicación con Stackdriver. Por lo general, las instancias de VM de Compute Engine tienen las credenciales correctas de manera predeterminada. Si alguno de los siguientes casos se aplica a ti, 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

La documentación de Stackdriver suele hacer referencia al proyecto de Google Cloud asociado a tu instancia de VM. Para las instancias de VM de EC2, esto se refiere al proyecto de conector de AWS vinculado con tu cuenta de AWS.

Stackdriver crea el proyecto de conector de AWS cuando conectas tu cuenta de AWS a un lugar de trabajo. El proyecto de conector tiene los siguientes atributos:

  • Un nombre que comienza con AWS Link

  • Un ID que comienza con aws-

    Este ID es el proyecto de Google Cloud asociado a tu instancia de VM.

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

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 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.

Cómo instalar en Linux y Windows

Para instalar el agente en instancias de VM que ejecutan Linux o Microsoft Windows, sigue las siguientes instrucciones.

Si intentas habilitar el registro estructurado, consulta las instrucciones de instalación para el registro estructurado.

LINUX

  1. Abre una conexión de terminal en tu instancia de VM con SSH o una herramienta similar.

  2. Ejecuta los siguientes comandos en tu instancia de VM para instalar el agente como se muestra a continuación:

    curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
    sudo bash install-logging-agent.sh
    
  3. Si usas un proxy HTTP, haz lo siguiente:

    1. Edita el siguiente archivo:

           /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
      

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

WINDOWS

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

  1. Abre una conexión terminal en tu instancia con RDP o una herramienta similar y accede a Windows.

  2. Si usas un proxy HTTP, ejecuta el siguiente comando desde un símbolo del sistema del administrador. Esta acción configura 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
    
  3. Abre una terminal de PowerShell y ejecuta los siguientes comandos. No necesitas privilegios de administrador.

    cd $env:UserProfile;
    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-10.exe", ".\StackdriverLogging-v1-10.exe")
    .\StackdriverLogging-v1-10.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-10.exe

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

    .\StackdriverLogging-v1-10.exe /S
    

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

    .\StackdriverLogging-v1-10.exe /S /D="C:\Stackdriver\Logging\"
    

    Puedes borrar el instalador una vez que se complete de forma correcta.

Tareas opcionales

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

Configurar 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. Si deseas definir la configuración del agente, consulta Configura el agente.

Determina 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:

DEBIAN o 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

AMAZON LINUX, RED HAT o CENTOS

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

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

Ejecuta el siguiente comando en Windows:

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

Requiere privilegios de administrador: Para reiniciar el agente, ejecuta los siguientes comandos en tu instancia de VM en PowerShell:

Restart-Service -Name StackdriverLogging

Actualiza el agente

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

DEBIAN o UBUNTU

Ejecuta los siguientes comandos en Debian o Ubuntu:

sudo apt-get update
sudo apt-get install --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 --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

AMAZON LINUX, RED HAT o CENTOS

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

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. En la instalación, se 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.

DEBIAN o 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

AMAZON LINUX, RED HAT o CENTOS

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

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.

Soluciona problemas

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