Inoltrare i log di Cloud Storage FUSE a Cloud Logging

Questo documento fornisce istruzioni su come inoltrare i log di Cloud Storage FUSE a Cloud Logging.

I log di Cloud Storage FUSE ti aiutano a capire come funziona Cloud Storage FUSE e ti consentono di risolvere i problemi e monitorare le prestazioni. Quando utilizzi l' --log-severity opzione o il logging:severity campo per generare i log, questi vengono generati da Cloud Storage FUSE e possono essere visualizzati come output standard o file di log locali sulla macchina su cui è in esecuzione Cloud Storage FUSE.

Puoi anche inoltrare i log di Cloud Storage FUSE a Cloud Logging, che offre i seguenti vantaggi:

  • Visualizza tutti i log di Cloud Storage FUSE in un'unica posizione nella Cloud de Confiance console, che fornisce una visione olistica del comportamento di Cloud Storage FUSE e semplifica la correlazione degli eventi tra i diversi componenti.

  • Filtra i log di Cloud Storage FUSE in base al livello di gravità, al timestamp, al tipo di risorsa e ad altri campi, il che può aiutarti a individuare errori o problemi di prestazioni.

  • Crea avvisi basati su metriche attivati da eventi di log specifici. Ad esempio, puoi configurare un avviso per ricevere una notifica ogni volta che viene rilevato un messaggio di log error o warning da Cloud Storage FUSE, in modo da poter reagire in modo proattivo ai problemi.

  • Archivia i log in Cloud Logging per un periodo configurabile ed esportali in Cloud Storage per l'archiviazione a lungo termine, l'archiviazione o l'analisi approfondita.

Prezzi

Per informazioni sui prezzi di Cloud Logging, consulta Costi di Cloud Logging.

Ottenere i ruoli richiesti

Per ottenere le autorizzazioni necessarie per utilizzare Cloud Logging per visualizzare i log di Cloud Storage FUSE, concedi il ruolo IAM Writer log (roles/logging.logWriter) nel progetto per il quale vuoi raccogliere le metriche.

Questo ruolo predefinito include le autorizzazioni necessarie per utilizzare Cloud Logging. Per saperne di più sul ruolo Writer log, consulta la documentazione IAM relativa a roles/logging.logWriter.

Per istruzioni sulla concessione dei ruoli per i progetti, consulta Gestire l'accesso ai progetti.

Prima di iniziare

  1. Attiva l'API Storage di Cloud Storage.

    Vai all'API Cloud Storage

  2. Abilita l'API Cloud Logging.

    Vai all'API Cloud Logging

  3. Installa Cloud Ops Agent, l'agente principale Cloud de Confiance by S3NSper la raccolta di log e metriche. Seleziona un metodo di installazione in base al tipo di macchina virtuale che stai utilizzando.

  4. Imposta la gravità del logging su trace utilizzando l'opzione --log-severity o il campo severity su trace.

Inoltrare i log di Cloud Storage FUSE a Cloud Logging

  1. Specifica /gcsfuse.log per il montaggio di gcsfuse:

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

  2. Configura Cloud Ops Agent per inoltrare i log dal file /gcfuse.log a Cloud Logging utilizzando la seguente configurazione. In questa configurazione, gcsfuse_trace_logs è un elemento receiver che riceve i log dal file /gcsfuse.log. L'elemento service collega l'elemento receiver nella pipeline.

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

    Per scoprire di più sulle configurazioni di logging aggiuntive, consulta Configurazioni di Cloud Logging.

  3. Inserisci la configurazione per Cloud Ops Agent in un percorso basato sul tuo sistema operativo. Per scegliere il percorso in cui inserire la configurazione, consulta la documentazione di Google Cloud Observability per le configurazioni specificate dall'utente.

  4. Riavvia Cloud Ops Agent per applicare le nuove modifiche alla configurazione utilizzando il comando systemctl restart:

    sudo systemctl restart google-cloud-ops-agent`

  5. Vai a Cloud Logging nella Cloud de Confiance console.

  6. Esegui la query di filtro fuse_debug per convalidare i log di traccia gcsfuse inoltrati a Cloud Logging.

Passaggi successivi