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.
Si ejecutas cargas de trabajo de registro especializadas que requieren mayor capacidad de procesamiento o mejor eficiencia de recursos en comparación con el agente estándar de Cloud Logging, considera usar el agente de operaciones.
Para instalar el agente de Logging, consulta Instala 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 18.04 (Bionic Beaver) y LTS 20.04 (Focal Fossa)
- Ubuntu Minimal LTS 18.04 (Bionic Beaver) y LTS 20.04 (Focal Fossa)
- SUSE Linux Enterprise Server 12, 12 SP3 para SAP, 12 SP4 para SAP y 12 SP5 para SAP
- SUSE Linux Enterprise Server 15, 15 SP1 para SAP, 15 SP2 para SAP, 15 SP3 para SAP y 15 SP4 para SAP
- OpenSUSE Leap 15, 15.2, 15.3 y 15.4
- Windows Server 2012 R2, 2016 y 2019
- Windows Server Core 2012 R2, 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 Web Services Elastic Compute Cloud (AWS EC2). El agente de Logging envía los registros al proyecto del conector de AWS que vincula tu cuenta de AWS a los servicios 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 API 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 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, ve 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, ve a Escribe registros de aplicaciones.
Instancias de nodo de Google Kubernetes Engine. Puedes habilitar las operaciones de Cloud para GKE, una solución integrada de supervisión y registro para tus clústeres de contenedores nuevos o existentes.
Para las instancias que se ejecutan en clústeres de Anthos alojados en VMware, el agente recopila registros del sistema, pero no recopila los registros de la aplicación.
Instancias del contenedor de Cloud Run. Cloud Run incluye compatibilidad integrada para Logging. Para obtener más información, ingresa a Registrar y ver registros.
Cloud Functions HTTP y funciones en segundo plano. Cloud Functions incluye compatibilidad integrada para Logging. Para obtener más información, ingresa a Escribe, visualiza y responde a registros.
Compatibilidad con nubes híbridas y locales
Google Cloud se asocia con Blue Medora a fin de proporcionar servicios de registro para plataformas de nube híbrida y locales de manera coherente y predecible. Si usas Blue Medora, podrás recopilar tus propios datos y enviarlos a Logging para su análisis. Bindplane de Blue Medora se integra con Cloud Logging para capturar datos de tu infraestructura y se incluye en el proyecto sin costo adicional.
Para obtener más información sobre Blue Medora, consulta Acerca de Blue Medora.
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 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 (Windows):
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 programafluentd
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 complemento de salida se empaqueta como una gema de Ruby y se incluye en el paquete
- 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 engoogle-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 prefijoWindows
.Las notas de la versión de la gema independiente
fluent-plugin-google-cloud
se pueden encontrar enfluent-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's operations suite.
Próximos pasos
Después de instalar el agente, consulta tus registros en el Explorador de registros.