Reenviar registros de Cloud Storage FUSE a Cloud Logging

En esta página se explica cómo reenviar los registros de Cloud Storage FUSE a Cloud Logging.

Información general

Los registros de Cloud Storage FUSE te ayudan a entender cómo funciona Cloud Storage FUSE y te permiten solucionar problemas y monitorizar el rendimiento. Cuando usas la opción de la CLI --log-severity o el campo de configuración logging:severity para generar registros, Cloud Storage FUSE genera los registros, que se pueden ver como salida estándar o como archivos de registro locales en la máquina en la que se ejecuta Cloud Storage FUSE.

También puedes reenviar los registros de Cloud Storage FUSE a Cloud Logging, que ofrece las siguientes ventajas:

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

  • Filtra 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.

  • Crea alertas basadas en métricas que se activen por eventos de registro específicos. Por ejemplo, puedes configurar una alerta para que te avise cuando 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 periodo configurable y expórtalos a Cloud Storage para almacenarlos a largo plazo, archivarlos o analizarlos en profundidad.

Precios

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

Obtener los roles necesarios

Para obtener los permisos que necesitas para usar Cloud Logging y ver los registros de Cloud Storage FUSE, asigna el rol de gestión de identidades y accesos Escritor de registros (roles/logging.logWriter) al proyecto del que quieras recoger métricas.

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

Para obtener instrucciones sobre cómo asignar roles a proyectos, consulta Gestionar el acceso a proyectos.

Antes de empezar

  1. Habilita la API de Cloud Storage.

    Ir a la API de Cloud Storage

  2. Habilita la API Cloud Logging.

    Ir a la API Cloud Logging

  3. Instala el agente de Cloud Ops, que es el agente principal de Google Cloudpara recoger registros y métricas. Selecciona un método de instalación en función del tipo de máquina virtual que utilices.

  4. Define la gravedad del registro como trace mediante la opción --log-severity de la CLI o el campo severity con el valor trace.

Reenviar registros de Cloud Storage FUSE a Cloud Logging

  1. Especifica /gcsfuse.log para el montaje de tu gcsfuse:

    logging:
      file-path: "/gcsfuse.log"
      severity: trace
    
  2. Configura el agente de Cloud Ops para que reenvíe los 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 pipeline.

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

    Para obtener información sobre otras configuraciones de registro, consulta Configuraciones de Cloud Logging.

  3. Coloca la configuración del agente de Cloud Ops en una ruta basada en tu sistema operativo. Para elegir la ruta en la que se debe colocar la configuración, consulta la documentación de Observabilidad de Google Cloud sobre las configuraciones especificadas por el usuario.

  4. Reinicia el agente de Cloud Ops para aplicar los nuevos cambios de configuración con el comando systemctl restart:

    sudo systemctl restart google-cloud-ops-agent`
    
  5. Ve a Cloud Logging en la Google Cloud consola.

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

Siguientes pasos