Descripción general del agente de Logging

En esta guía, se proporciona información básica sobre el agente de Logging, una aplicación basada en fluentd que se ejecuta en tus instancias de máquina virtual (VM).

En la configuración predeterminada, el agente de Logging transmite los registros de aplicaciones comunes de terceros y del software del sistema a Logging; consulta la lista de registros predeterminados. Puedes configurar el agente a fin de que transmita registros adicionales. Ve a Configura el agente de Logging si deseas obtener detalles sobre la configuración y la operación del agente.

Como práctica recomendada, ejecuta el agente de Logging en todas tus instancias de VM. El agente se ejecuta en Linux y Windows.

Para instalar el agente de Logging, consulta Instala el agente de Logging.

Cómo funciona el agente de Logging

Sistemas operativos compatibles

Puedes ejecutar el agente de Logging en los siguientes sistemas operativos en instancias de máquinas virtuales (VM) compatibles:

  • CentOS 7 y 8
  • Rocky Linux 8
  • Red Hat Enterprise Linux 7 y 8
  • Debian 9 “Stretch”, 10 “Buster” y 11 “Bullseye”
  • Ubuntu LTS 20.04 (Focal Fossa)
  • Ubuntu Minimal LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12 y 12 SP5 para SAP
  • SUSE Linux Enterprise Server 15, 15 SP2 para SAP, 15 S3 para SAP, 15 SP4 para SAP y 15 SP5 para SAP
  • OpenSUSE Leap 15, 15.2, 15.3 y 15.4
  • Windows Server 2016 y 2019
  • Windows Server Core 2016 y 2019
  • Amazon Linux AMI (excepto Amazon Linux 2.0 AMI)

Si ejecutas VM de Container-Optimized OS, sigue las instrucciones de Container-Optimized OS para recopilar registros de tus VM.

Entornos compatibles

El agente de Logging es compatible con los siguientes entornos:

  • Instancias de Compute Engine. El agente de Logging envía los registros al proyecto asociado con cada instancia de VM.

    En el caso de las instancias sin direcciones IP externas, debes habilitar el acceso privado a Google para permitir que el agente de Logging envíe registros.

  • Instancias de Amazon Elastic Compute Cloud (Amazon EC2). El agente de Logging envía los registros desde AWS a un proyecto de Google Cloud.

    Para que el agente de Logging funcione correctamente, la instancia de Amazon EC2 en la que se ejecuta debe poder comunicarse con las APIs de Google Cloud, en particular, con la API de Logging. Esto requiere una dirección IP externa o una puerta de enlace a Internet de VPC.

Para estas instancias de VM, se requiere un mínimo de 250 MiB de memoria residente (RSS) a fin de ejecutar el agente de Logging; pero se recomienda 1 GiB. Por ejemplo, a una frecuencia de 100 entradas de registro de 1 KB por segundo, el agente de Logging con configuración predeterminada consume un 5% de CPU en un núcleo y 150 MiB de memoria.

Las siguientes instancias de VM admiten Logging con el uso de su propio software, por lo que no se puede instalar manualmente el agente de Logging en ellas:

Compatibilidad con nubes híbridas y locales

Google Cloud se asocia con observIQ para proporcionar servicios de registro para plataformas de nube híbrida y locales de manera coherente y predecible. Con BindPlane, puedes recopilar tus propios datos y enviarlos a Logging para su análisis. BindPlane se integra en Cloud Logging para capturar datos de tu infraestructura y se incluye en el proyecto sin costo adicional.

Para obtener más información, consulta Acerca de observIQ y BindPlane.

Requisitos de acceso al agente

La ejecución del agente requiere acceso a los siguientes nombres de DNS:

  • Servidor del token OAuth2: oauth2.googleapis.com

    Es posible que las versiones anteriores del agente requieran acceso a www.googleapis.com (URL completa: https://www.googleapis.com/oauth2/v3/token).

    Si usas una versión anterior del agente, te recomendamos que actualices tu agente a la versión más reciente.

  • API de Logging: logging.googleapis.com

La instalación del agente requiere acceso a los siguientes nombres de DNS:

  • (Linux) Repositorio de paquetes de Google Cloud: packages.cloud.google.com

  • Servidor de descarga de Google: dl.google.com

Código fuente del agente de Logging

No necesitarás la información de esta sección, a menos que desees comprender el código fuente o tengas otras necesidades particulares. El agente de Logging se instala mediante la secuencia de comandos que se describe en las instrucciones de instalación.

El agente de Logging google-fluentd es una versión modificada del recopilador de datos de registro fluentd. google-fluentd se distribuye en dos paquetes separados. El código fuente está disponible en los repositorios asociados de GitHub:

  • El repositorio de GitHub llamado google-fluentd, que incluye el programa fluentd central, las secuencias de comandos personalizadas de empaquetado y el complemento de salida para la API de Cloud Logging.
    • El complemento de salida se empaqueta como una gema de Ruby y se incluye en el paquete google-fluentd. También está disponible por separado en el servicio de hosting de gemas de Ruby en fluent-plugin-google-cloud.
    • El contenido relacionado con el instalador de Windows se encuentra en la carpeta windows-installer.
  • El repositorio de GitHub llamado google-fluentd-catch-all-config, que incluye los archivos de configuración del agente de Logging para transferir los registros de varios paquetes de software de terceros.

Notas de la versión del agente de Logging

  • Las notas de la versión del paquete google-fluentd de Linux se pueden encontrar en google-fluentd/releases, donde las etiquetas de la versión siguen el formato de versiones semánticas [Major].[Minor].[Patch].

  • Las notas de la versión de los instaladores de Windows se pueden encontrar en la misma ubicación: google-fluentd/releases. La diferencia es que las etiquetas de la versión tienen el prefijo Windows.

  • Las notas de la versión de la gema independiente fluent-plugin-google-cloud se pueden encontrar en fluent-plugin-google-cloud/releases, donde las etiquetas de la versión siguen el formato de versiones semánticas [Major].[Minor].[Patch].

Política de baja

El agente de Logging está sujeto a la política de baja de los agentes de Google Cloud Observability.

Próximos pasos