Instala el agente

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

Las imágenes de VM para Compute Engine y AWS EC2 no incluyen el agente de Logging, por lo que deberás instalarlo en esas instancias. El agente se ejecuta en Linux y Windows.

Antes de comenzar

Verifica que el agente Stackdriver Logging sea compatible con tu instancia de VM y obtén información sobre los lugares de trabajo. Para obtener más información sobre los requisitos y los entornos compatibles, consulta Acerca del agente de Stackdriver Logging.

Instancias de VM compatibles

Algunos tipos de instancias de VM ya contienen el agente de Logging o software similar al agente de Logging. Para otros, debes instalar el agente con las instrucciones de esta página:

  • Instancias de VM de Google Cloud Platform (GCP):
    • App Engine: se incluye un agente en la imagen de VM. Omite esta página.
    • GKE: se incluye un agente en la imagen de VM. Omite esta página.
    • Compute Engine: instala el agente en tus instancias de VM. Las instancias de VM ya tienen la autorización requerida. Consulta Instala en Linux y Windows.
  • Amazon EC2: instala las credenciales de autorización en tus instancias de VM y a continuación, instala el agente. Consulta Autoriza el agente y, luego, Instala en Linux y Windows.

Para instalar el agente de Stackdriver Logging se requiere un mínimo de 250 MB de memoria, pero se recomienda 1 GB.

Facturación de Stackdriver

Si usas las instancias de VM de AWS, debes vincular tu cuenta de AWS a un lugar de trabajo para usar el agente de Stackdriver Logging.

Si quieres obtener más información, consulta Crea un lugar de trabajo.

Instala sin acceso a paquetes remotos

Sigue los pasos a continuación a fin de instalar o actualizar el agente en un host cuya política de seguridad rechace el acceso a los repositorios de paquetes remotos:

  1. Instala el paquete de agente en un host que pueda acceder a los siguientes repositorios:

    • Cloud Rapture: packages.cloud.google.com
    • (Para entornos de Kubernetes) Google Container Registry: gcr.io
  2. Copia el paquete al host de destino.

Instala en Linux y Windows

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

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

Instancia de Linux

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

  2. Descarga la secuencia de comandos de instalación del agente de Logging mediante la ejecución del siguiente comando en tu instancia de VM:

    curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
    
  3. Ejecuta la secuencia de comandos de instalación con el siguiente comando:

    sudo bash install-logging-agent.sh
    

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

Instancia de Windows

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

  2. Si usas el proxy HTTP, ejecuta el siguiente comando de un símbolo del sistema del administrador. Esto establece la variable del entorno http_proxy para que el agente pueda enviar los datos a Stackdriver Logging:

    setx http_proxy http://[YOUR_PROXY_SERVER_URI] /m
    
  3. Abre una terminal de PowerShell y ejecuta los siguientes tres comandos de PowerShell. No necesitas privilegios de administrador.

    cd C:\Users\$env:Username
    Invoke-WebRequest https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-8.exe -OutFile StackdriverLogging-v1-8.exe;
    .\StackdriverLogging-v1-8.exe
    

    Notas:

    • Debes descargar el instalador a 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 a un directorio del sistema, muévelo a otro directorio antes de ejecutarlo.

    • El instalador del agente también es compatible con la 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 en la invocación del instalador:

      .\StackdriverLogging-v1-8.exe /S
      
    • El instalador coloca el agente en el siguiente directorio de forma predeterminada:

      C:\Program Files (x86)\Stackdriver\LoggingAgent\
      

      Puedes cambiar ese directorio durante la instalación.

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

Para verificar o probar la instalación del agente Stackdriver Logging, consulta Verifica la instalación del agente.

Si tienes problemas con la instalación, consulta Solución de problemas del agente de Logging.

Tareas adicionales

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 se agregan de forma automática mediante la secuencia de comandos de la instalación. 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 de Logging.

En esta sección, se describe cómo realizar tareas de mantenimiento comunes: determinar la versión del agente, reiniciar, actualizar y desinstalar el agente.

Determina la versión

Para identificar la versión del agente de Logging y sus componentes de configuración, ejecuta el siguiente comando:

Instancia de Linux

Ejecuta el siguiente comando en tu instancia:

# For Debian and Ubuntu systems:
dpkg-query --show --showformat \
    '${Package;-45} ${Version;-10} ${Architecture;-8} ${Status;-25}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

# For Amazon Linux, Red Hat, CentOS, and SUSE systems:
rpm --query --queryformat \
    '%-45{NAME} %-10{VERSION} %-10{RELEASE} %-8{ARCH}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

Instancia de Windows

Ejecuta el siguiente comando.

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

El comando anterior muestra un error si la versión del agente es anterior a v1-5. Actualiza al agente más reciente.

Reinicia el agente

Debes reiniciar el agente de Stackdriver Logging para que los cambios en los archivos de configuración surtan efecto. Para reiniciar el agente de Stackdriver Logging, usa las siguientes instrucciones.

Instancia de Linux

Ejecuta el siguiente comando en tu instancia:

    $ sudo service google-fluentd restart

Luego de reiniciar el agente de Logging, es posible que desees enviar un mensaje de prueba.

Instancia de Windows

Requiere privilegios de administrador: para reiniciar el agente, ejecuta los siguientes comandos en tu instancia de VM en el símbolo del sistema o PowerShell:

# For Logging agent version v1-5 and later.
net stop  StackdriverLogging
net start StackdriverLogging

# For Logging agents before v1-5.
net stop  fluentdwinsvc
net start fluentdwinsvc

Actualiza el agente

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

Instancia de Linux

Para actualizar a la última versión del agente, ejecuta el siguiente comando en tu instancia:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd

# For SUSE systems:
sudo zypper update 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:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo zypper update google-fluentd google-fluentd-catch-all-config

Como alternativa, puedes quitar el agente actual y, a continuación, instalar el agente más reciente. Este es el enfoque recomendado cuando se realizan actualizaciones que pueden causar cambios en la configuración (p. ej., en caso de una incrementación en la versión principal).

Instancia de Windows

Para actualizar a la última versión del agente, instala el agente más nuevo como se describe en Instala en Windows. Se te solicitará que desinstales la versión anterior del agente.

Desinstala el agente

Para quitar el agente de Stackdriver Logging y sus archivos de configuración, usa las siguientes instrucciones.

Instancia de Linux

Desinstala el agente de Linux actual:

# For Debian and Ubuntu systems:
sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

# For Amazon Linux, Red Hat and CentOS systems:
sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

Instancia de Windows

Desinstala el agente actual mediante la ejecución del siguiente comando:

[AGENT_INSTALLATION_DIRECTORY]\uninstall.exe

Si ejecutas las versiones v1-5 y posteriores del agente de Logging, usa el directorio que elegiste cuando instalaste el agente. El directorio de la instalación predeterminado es el siguiente:

C:\Program Files (x86)\Stackdriver\LoggingAgent\

Si ejecutas un agente de Logging anterior a v1-5, el directorio de instalación es este:

C:\GoogleStackdriverLoggingAgent\

Para obtener más información, consulta Configura el agente de Logging.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Stackdriver Logging
Si necesitas ayuda, visita nuestra página de asistencia.