Información general sobre el agente de Logging

Esta guía 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 su configuración predeterminada, el agente de Logging transmite registros de aplicaciones de terceros y software del sistema comunes a Logging. Consulta la lista de registros predeterminados. Puedes configurar el agente para que transmita registros adicionales. Consulta el artículo Configurar el agente de Logging para obtener más información sobre la configuración y el funcionamiento del agente.

Es una práctica recomendada ejecutar el agente de Logging en todas tus instancias de máquina virtual. El agente se ejecuta en Linux y Windows.

Para instalar el agente de Logging, consulta el artículo Instalar 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 compatibles:

  • Rocky Linux 8
  • RHEL 8: rhel-8-6-sap-ha, rhel-8-8-sap-ha
  • Debian 11 (Bullseye)
  • SLES 12: sles-12-sp5-sap
  • SLES 15: sles-15-sp6, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap
  • Windows Server 2016 y 2019
  • Windows Server Core 2016 y 2019

Si ejecutas VMs con Container-Optimized OS, sigue las instrucciones de Container-Optimized OS para recoger los registros de tus VMs.

Entornos admitidos

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 sin direcciones IP externas, debes habilitar Acceso privado de 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 de AWS a un Google Cloud proyecto.

    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, especialmente con la API de Logging. Para ello, se necesita una pasarela de Internet de VPC o una dirección IP externa.

Para estas instancias de VM, se necesitan al menos 250 MiB de memoria residente (RSS) para ejecutar el agente de Logging, pero se recomienda 1 GiB. Por ejemplo, a una velocidad de 100 entradas de registro de 1 KB por segundo, el agente de Logging con las configuraciones predeterminadas consume el 5% de la CPU en un núcleo y 150 MiB de memoria.

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

  • Instancias del entorno estándar de App Engine. App Engine incluye compatibilidad integrada con Logging. Para obtener más información, consulta el artículo Escribir registros de aplicaciones.

  • Instancias del entorno flexible de App Engine. Las aplicaciones que se ejecutan en el entorno flexible de App Engine pueden escribir registros que se añaden a los que se incluyen en el entorno estándar de App Engine. Para obtener más información, consulta el artículo Escribir registros de aplicaciones.

  • Instancias de nodo de Google Kubernetes Engine. La recogida de registros con Logging está habilitada de forma predeterminada en los clústeres de contenedores nuevos, pero también puedes habilitarla en los clústeres que ya tengas. Para obtener más información, consulta el artículo sobre cómo configurar el almacenamiento de registros y la monitorización de GKE.

  • En el caso de las instancias que se ejecutan en Google Distributed Cloud, el agente recoge registros del sistema, pero no registros de aplicaciones.

  • Instancias de contenedor de Cloud Run. Cloud Run incluye compatibilidad integrada con Logging. Para obtener más información, consulta el artículo Registrar y ver registros.

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

Compatibilidad con nubes híbridas y locales

Google Cloud se ha asociado con Bindplane para ofrecer servicios de registro para plataformas locales y de nube híbrida de forma coherente y predecible. Con Bindplane, puede recoger sus propios datos y enviarlos a Logging para analizarlos. Bindplane se integra con Cloud Logging para recoger datos de tu infraestructura y se incluye en tu proyecto sin coste adicional.

Para obtener más información sobre Bindplane y Bindplane, consulta Acerca de Bindplane y Bindplane.

Requisitos de acceso de agentes

Para ejecutar el agente, se necesita acceso a los siguientes nombres de DNS:

  • Servidor de tokens de 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 utilizas una versión anterior del agente, te recomendamos que actualices el agente a la versión más reciente.

  • APIs de registro: logging.googleapis.com

Para instalar el agente, se necesita acceso a los siguientes nombres de DNS:

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

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

Código fuente del agente de Logging

No necesitas la información de esta sección a menos que quieras entender el código fuente o tengas otras necesidades especiales. El agente de registro se instala mediante la secuencia de comandos descrita en las instrucciones de instalación.

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

  • El repositorio de GitHub llamado google-fluentd que incluye el programa principal fluentd, las secuencias de comandos de empaquetado personalizadas y el complemento de salida de la API 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 alojamiento de gemas de Ruby 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 registro para ingerir 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 de Linux google-fluentd se pueden consultar en google-fluentd/releases, donde las etiquetas de la versión siguen el formato de [Major].[Minor].[Patch] versiones semánticas.

  • Las notas de la versión de los instaladores de Windows se pueden encontrar en la misma ubicación: google-fluentd/releases. Sin embargo, las etiquetas de lanzamiento tienen el prefijo Windows.

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

Política de desactivación

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

Pasos siguientes