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 instancias de máquina virtual (VM).

En la configuración predeterminada, el agente de Logging transmite los registros desde aplicaciones comunes de terceros y desde el software del sistema hasta Logging. Consulta la lista de registros predeterminados. Puedes configurar el agente para que transmita registros adicionales. Accede a Configura el agente de Logging si quieres obtener detalles sobre su configuración y funcionamiento.

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

Para instalarlo, 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 VMs de Container-Optimized OS, sigue las instrucciones de Container-Optimized OS para recopilar registros de las VMs.

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 a cada instancia de VM.

    En el caso de las instancias que no tienen 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 hasta un proyecto de Google Cloud .

    Para que el agente de Logging funcione de forma correcta, 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.

En el caso de estas instancias de VM, se requiere un mínimo de 250 MiB de memoria residente (RSS) para poder 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 usando su propio software, por lo que el agente de Logging no se puede instalar de forma manual en ellas:

  • Instancias del entorno estándar de App Engine. App Engine incluye compatibilidad integrada con Logging. Para obtener más información, accede a Escribe registros de aplicaciones.

  • Instancias de entorno flexible de App Engine. Las apps que se ejecutan en el entorno flexible de App Engine pueden escribir registros que se agregan a lo que se incluye en el entorno estándar de App Engine. Para obtener más información, accede a Escribe registros de aplicaciones.

  • Instancias de nodo de Google Kubernetes Engine. La recopilación de registros con Logging está habilitada de forma predeterminada para los clústeres de contenedores nuevos, pero puedes habilitarla en los clústeres existentes. Para obtener más información, consulta Configura el registro y la supervisión para GKE.

  • En el caso de las instancias que se ejecutan en Google Distributed Cloud, el agente recopila los registros del sistema, pero no los de la aplicación.

  • Instancias de contenedor de Cloud Run. Cloud Run incluye compatibilidad integrada para Logging. Para obtener más información, accede a Registra y visualiza registros.

  • Funciones de HTTP y en segundo plano de Cloud Run Functions. Cloud Run Functions incluye compatibilidad integrada para Logging.

Compatibilidad con nubes híbridas y locales

Google Cloud se asocia con BindPlane con el objetivo de proporcionar servicios de registro para plataformas de nube híbrida y local de manera coherente y predecible. Con BindPlane, puedes recopilar tus propios datos y enviarlos a Logging para analizarlos. 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 BindPlane.

Requisitos de acceso del 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 lo actualices 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) Google Cloud Package Repository: 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 quieras comprender el código fuente o tengas otras necesidades especiales. El agente de Logging se instala con 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. Allí 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. Allí, 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.

Pasos siguientes