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, a risolvere i problemi e a monitorare le prestazioni. Quando generi i log utilizzando l'opzione --log-severity o il campo logging:severity, puoi visualizzarli come output standard o nei file di log locali sulla macchina in cui viene eseguito Cloud Storage FUSE. L'inoltro di questi log a Cloud Logging ti consente di visualizzarli, filtrarli, ricevere avvisi e conservarli in una posizione centralizzata.

Questo documento descrive come inoltrare i log di Cloud Storage FUSE a Cloud Logging.

Vantaggi dell'inoltro dei log a Cloud Logging

Quando inoltri i log di Cloud Storage FUSE a Cloud Logging, puoi:

  • Visualizza tutti i log di Cloud Storage FUSE in un'unica posizione nella console Google Cloud , 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, in modo da individuare errori o problemi di prestazioni.

  • Creare avvisi basati su metriche che vengono 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 ai problemi in modo proattivo.

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

Prezzi

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

Ottieni 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) al progetto per cui vuoi raccogliere le metriche.

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

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

Prima di iniziare

  1. Abilita 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 di Google Cloudper 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.

Inoltra 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 l'agente Cloud Ops 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 l'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 console Google Cloud .

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

Passaggi successivi