Reenvía registros de Cloud Storage FUSE a Cloud Logging

En este documento, se proporcionan instrucciones para reenviar registros de Cloud Storage FUSE a Cloud Logging.

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

También puedes reenviar registros de Cloud Storage FUSE a Cloud Logging, lo que proporciona los siguientes beneficios:

  • Visualiza todos los registros de Cloud Storage FUSE en una sola ubicación en la Cloud de Confiance consola, lo que proporciona una vista integral del comportamiento de Cloud Storage FUSE y facilita la correlación de eventos en 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 activan por eventos de registro específicos. Por ejemplo, puedes configurar una alerta para que te notifique cada vez que se detecte un mensaje de registro error o warning de Cloud Storage FUSE, lo que te permite reaccionar a los problemas de forma proactiva.

  • Almacena registros en Cloud Logging durante un período configurable y expórtalos a Cloud Storage para almacenarlos, archivarlos o analizarlos en profundidad a largo plazo.

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 Escritor de registros (roles/logging.logWriter) de IAM 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, que es Cloud de Confiance by S3NS's el agente principal para recopilar registros y métricas. Selecciona un método de instalación según el tipo de máquina virtual que uses.

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

Reenvía 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 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 las configuraciones de registro adicionales, consulta Configuraciones de Cloud Logging.

  3. Coloca la configuración del Agente de operaciones en una ruta de acceso según tu sistema operativo. Para elegir la ruta de acceso 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 para recoger 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 Cloud de Confiance consola.

  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?