Reenvía registros de Cloud Storage FUSE a Cloud Logging

Los registros de Cloud Storage FUSE te ayudan a comprender cómo funciona, solucionar problemas y supervisar el rendimiento. Cuando generas registros con la opción --log-severity o el campo logging:severity, puedes verlos como salida estándar o en archivos de registro locales en la máquina en la que se ejecuta Cloud Storage FUSE. Reenviar estos registros a Cloud Logging te permite verlos, filtrarlos, generar alertas y conservarlos en una ubicación central.

En este documento, se describe cómo reenviar registros de Cloud Storage FUSE a Cloud Logging.

Beneficios de reenviar registros a Cloud Logging

Cuando reenvías registros de Cloud Storage FUSE a Cloud Logging, puedes hacer lo siguiente:

  • Consulta todos los registros de Cloud Storage FUSE en una sola ubicación en la consola de Cloud de Confiance , que proporciona una vista integral del comportamiento de Cloud Storage FUSE y facilita la correlación de eventos en diferentes componentes.

  • Filtrar los registros de Cloud Storage FUSE por nivel de gravedad, marca de tiempo, tipo de recurso y otros campos, lo que puede ayudarte a identificar errores o problemas de rendimiento.

  • Crear alertas basadas en métricas que se activen por eventos de registro específicos Por ejemplo, puedes configurar una alerta para que se te notifique cada vez que se detecte un mensaje de registro error o warning de Cloud Storage FUSE, lo que te permitirá reaccionar a los problemas de forma proactiva.

  • Almacena los registros en Cloud Logging durante un período configurable y expórtalos a Cloud Storage para su almacenamiento a largo plazo, archivado o análisis en profundidad.

Precios

Para obtener información sobre los precios de Cloud Logging, consulta Costos de Cloud Logging.

Obtén las funciones necesarias

Para obtener los permisos que necesitas para usar Cloud Logging y ver los registros de Cloud Storage FUSE, otorga el rol de IAM de Escritor de registros (roles/logging.logWriter) en el proyecto para el que deseas recopilar métricas.

Este rol predefinido contiene los permisos necesarios para usar Cloud Logging. Para obtener más información sobre el rol de escritor de registros, consulta la documentación de IAM sobre roles/logging.logWriter.

Si deseas obtener instrucciones para otorgar roles a proyectos, consulta Administra el acceso a los proyectos.

Antes de comenzar

  1. Habilita la API de Cloud Storage.

    Ir a la API de Cloud Storage

  2. Habilita la API de Cloud Logging.

    Ir a la API de Cloud Logging

  3. Instala el Agente de operaciones de Cloud, que es el agente principal de Cloud de Confiance by S3NSpara recopilar registros y métricas. Selecciona un método de instalación según el tipo de máquina virtual que uses.

  4. Establece la gravedad del registro en trace con la opción --log-severity o el campo severity en trace.

Reenvía los registros de Cloud Storage FUSE a Cloud Logging

  1. Especifica /gcsfuse.log para tu activación de gcsfuse:

    logging:
  file-path: "/gcsfuse.log"
  severity: trace

  2. Configura el Agente de operaciones de Cloud para reenviar registros del archivo /gcfuse.log a Cloud Logging con la siguiente configuración. En esta configuración, gcsfuse_trace_logs es un elemento receiver que recibe registros del archivo /gcsfuse.log. El elemento service vincula el elemento receiver en la canalización.

    logging:
 receivers:
  gcsfuse_trace_logs:
  type: files
  include_paths:
  - /gcsfuse.log
service:
 pipelines:
   gcsfuse_pipeline:
     receivers: [gcsfuse_trace_logs]

    Para obtener información sobre parámetros de configuración de registros adicionales, consulta Configuración de Cloud Logging.

  3. Coloca la configuración del Agente de operaciones de Cloud en una ruta de acceso según tu sistema operativo. Para elegir la ruta en la que se colocará la configuración, consulta la documentación de Google Cloud Observability para las configuraciones especificadas por el usuario.

  4. Reinicia el Agente de operaciones de Cloud para que se apliquen los cambios de configuración nuevos con el comando systemctl restart:

    sudo systemctl restart google-cloud-ops-agent`

  5. Ve a Cloud Logging en la consola de Cloud de Confiance .

  6. Ejecuta la consulta de filtrado fuse_debug para validar los registros de seguimiento de gcsfuse que se reenvían a Cloud Logging.

¿Qué sigue?