Puedes escribir registros en Cloud Logging desde las aplicaciones de Ruby con la biblioteca de Cloud Logging para Ruby o directamente con la biblioteca cliente de Cloud de Cloud Logging para Ruby.
No es necesario instalar el agente de Cloud Logging a fin de usar la biblioteca de Cloud Logging para Ruby en una instancia de VM de Compute Engine.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Cloud Logging API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Cloud Logging API.
- Instala Ruby 2.2+ o una versión superior.
Instala la biblioteca
Proporcionamos una biblioteca de Cloud Logging para Ruby, que proporciona una implementación del registrador fácil de usar para los frameworks web de Ruby basados en Rack:
Agrega la gema de Google Cloud Observability a tu Gemfile:
Usa Bundler para instalar la gema:
bundle install
Habilita la biblioteca
Si usas Ruby on Rails, Bundler carga la biblioteca automáticamente en tu aplicación cuando se inicia, lo que establece el valor Rails.logger
predeterminado en una instancia de registrador de Cloud Logging.
Otras aplicaciones basadas en Rack pueden usar el middleware de Rack para reemplazar el registrador de Rack con el registrador de Cloud Logging si tu framework web es compatible con el registrador de Rack:
Configura la biblioteca
Puedes personalizar el comportamiento de la biblioteca de Cloud Logging para Ruby. Consulta la configuración de la biblioteca para obtener una lista de las opciones de configuración posibles.
Usa el registrador de Cloud Logging
Una vez que esté habilitada la biblioteca de Cloud Logging para Ruby, puedes usar el registrador en tu aplicación:
logger.info "Hello World!"
logger.error "Oh No!"
Para obtener más información sobre la instalación, consulta la documentación de la biblioteca de Cloud Logging para Ruby. También puedes informar problemas con la Herramienta de seguimiento de errores.
Cómo escribir registros con la biblioteca cliente de Cloud Logging
Para obtener información sobre el uso directo de la biblioteca cliente de Cloud Logging para Ruby, consulta Bibliotecas cliente de Cloud Logging.
Ejecuta en Google Cloud
Para que una aplicación escriba registros con la biblioteca de Cloud Logging para Ruby, el
la cuenta de servicio del recurso subyacente debe tener la
Rol de IAM de Escritor de registros (roles/logging.logWriter
).
La mayoría de los entornos de Google Cloud configuran automáticamente la cuenta de servicio predeterminada para que tenga este rol.
App Engine
Cloud Logging se habilita automáticamente para App Engine, y la API de cuenta de servicio predeterminada tiene los permisos de IAM de forma predeterminada para escribir entradas de registro.
Para obtener más información, consulta Escribir y visualizar registros.
Google Kubernetes Engine (GKE)
GKE otorga automáticamente la cuenta de servicio predeterminada.
el rol de IAM de escritor de registros (roles/logging.logWriter
).
Si usas la federación de identidades para cargas de trabajo para GKE con esta cuenta de servicio predeterminada para permitir que las cargas de trabajo accedan a APIs específicas de Google Cloud, no se requiere ninguna configuración adicional.
Sin embargo, si usas Workload Identity Federation for GKE con una cuenta de servicio de IAM personalizada, asegúrate de que la cuenta de servicio personalizada tenga el rol de escritor de registros (roles/logging.logWriter
).
Si es necesario, también puedes usar el siguiente comando para agregar el permiso de acceso logging.write
cuando creas el clúster:
gcloud container clusters create example-cluster-name \
--scopes https://www.googleapis.com/auth/logging.write
Compute Engine
Cuando uses las instancias de VM de Compute Engine, agrega el permiso de acceso cloud-platform
a cada instancia. Cuando crees una instancia nueva a través de la consola de Google Cloud, puedes hacerlo en la sección Identidad y acceso a la API del panel Crear instancia. Usa la cuenta de servicio predeterminada de Compute Engine o una cuenta de servicio diferente y selecciona Permitir acceso total a las API de Cloud en la sección Identidad y acceso a la API. Cualquiera que sea el servicio
que selecciones, asegúrate de que se le haya otorgado la
El rol de escritor de registros en IAM y Administrador de la
Consola de Google Cloud
Ejecuta de forma local y en otros lugares
Para usar la biblioteca de Cloud Logging para Ruby fuera de Google Cloud, incluso ejecutar la biblioteca en tu propia estación de trabajo, en las computadoras de tu centro de datos o en las instancias de VM de otro proveedor de servicios en la nube, debes proporcionar el ID de tu proyecto de Google Cloud y las credenciales de la cuenta de servicio correspondientes directamente a la biblioteca de Cloud Logging para Ruby.
Para las cuentas de servicio existentes, haz lo siguiente:
Otorga la IAM a la cuenta de servicio Rol de IAM de Escritor de registros (
roles/logging.logWriter
). Para obtener más información sobre IAM, consulta Control de acceso.Configura las credenciales predeterminadas de la aplicación.
Si no tienes una cuenta de servicio, créala. Para obtener información sobre este proceso, consulta Crea cuentas de servicio.
Si deseas obtener información general sobre los métodos que puedes usar para la autenticación, consulta Terminología: cuentas de servicio.
Usa la interfaz de configuración de Ruby on Rails:Si usas el marco de trabajo de Ruby on Rails, proporciona los parámetros mediante su interfaz de configuración:
También puedes establecer la configuración compartida para todas las gemas de observabilidad de Google Cloud con el siguiente comando:
Logging se habilita de forma predeterminada cuando Rails se ejecuta en el modo de producción. Para habilitar Logging en el modo de desarrollo, agrega lo siguiente:
Usa la interfaz de configuración de instrumentación:
Cuando se use en otras aplicaciones basadas en Rack, proporciona los parámetros a través de la interfaz de configuración:
También puedes establecer la configuración compartida para todas las gemas de observabilidad de Google Cloud con el siguiente comando:
Consulta los registros
En la consola de Google Cloud, ve a la página Explorador de registros.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
En el Explorador de registros, debes especificar uno o más recursos, aunque la selección de recursos puede no ser obvia. Aquí encontrarás algunas sugerencias que te ayudarán a comenzar:
Si implementas tu aplicación en App Engine o utilizas las bibliotecas específicas de App Engine, configura tu recurso como Aplicación de GAE.
Si implementas tu aplicación en Compute Engine, configura el recurso como Instancia de VM de GCE.
Si implementas tu aplicación en Google Kubernetes Engine, la configuración de registro de tu clúster determina el tipo de recurso de las entradas de registro. Para obtener información detallada sobre Google Cloud Observability heredado y las soluciones de Kubernetes Monitoring de Google Cloud Observability, y cómo esas opciones afectan el tipo de recurso, consulta Cómo migrar a Kubernetes Monitoring de Google Cloud Observability.
Si la aplicación usa la API de Cloud Logging directamente, el recurso depende de la API y de tu configuración. Por ejemplo, en la aplicación, puedes especificar un recurso o usar un recurso predeterminado.
Si no ves ningún registro en el Explorador de registros, cambia al modo de consulta avanzada y usa una consulta vacía para ver todas las entradas de registro.
- Para cambiar al modo de consulta avanzada, haz clic en menú (▾) en la parte superior del visor de registros y selecciona Convertir a filtro avanzado.
- Borra el contenido que aparece en el cuadro de filtro.
- Haz clic en Enviar filtro.
Puedes examinar las entradas individuales para identificar tus recursos.
Para obtener más información, consulta Usa el Explorador de registros.