Cloud Storage FUSE-Logs an Cloud Logging weiterleiten

In diesem Dokument wird beschrieben, wie Sie Cloud Storage FUSE-Logs an Cloud Logging weiterleiten.

Cloud Storage FUSE-Logs helfen dabei, die Funktionsweise von Cloud Storage FUSE zu verstehen, Probleme zu beheben und die Leistung zu überwachen. Wenn Sie die Option --log-severity oder das Feld logging:severityzum Generieren von Logs verwenden, werden diese von Cloud Storage FUSE generiert und können als Standardausgabe oder lokale Logdateien auf dem Computer angezeigt werden, auf dem Cloud Storage FUSE ausgeführt wird.

Sie können Cloud Storage FUSE-Logs auch an Cloud Logging weiterleiten. Das bietet folgende Vorteile:

  • Alle Cloud Storage FUSE-Logs sind an einem zentralen Ort in der Google Cloud Console verfügbar. So erhalten Sie einen ganzheitlichen Überblick über das Verhalten von Cloud Storage FUSE und können Ereignisse in verschiedenen Komponenten leichter in Beziehung setzen.

  • Sie können Cloud Storage FUSE-Logs nach Schweregrad, Zeitstempel, Ressourcentyp und anderen Feldern filtern, um Fehler oder Leistungsprobleme zu erkennen.

  • Sie können messwertbasierte Benachrichtigungen erstellen, die durch bestimmte Log-Ereignisse ausgelöst werden. Sie können beispielsweise eine Benachrichtigung einrichten, die Sie informiert, wenn ein error- oder warning-Logeintrag von Cloud Storage FUSE erkannt wird. So können Sie proaktiv auf Probleme reagieren.

  • Sie können Logs für einen konfigurierbaren Zeitraum in Cloud Logging speichern und zur Langzeitspeicherung, Archivierung oder detaillierten Analyse in Cloud Storage exportieren.

Preise

Informationen zu den Preisen für Cloud Logging finden Sie unter Cloud Logging –Kosten.

Erforderliche Rollen abrufen

Um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Cloud Storage FUSE-Logs mit Cloud Logging benötigen, weisen Sie die IAM-Rolle Logs Writer (roles/logging.logWriter) für das Projekt zu, für das Sie Messwerte erfassen möchten.

Diese vordefinierte Rolle enthält die Berechtigungen, die für die Verwendung von Cloud Logging erforderlich sind. Weitere Informationen zur Rolle „Logs Writer“ finden Sie in der IAM-Dokumentation zu roles/logging.logWriter.

Eine Anleitung zum Zuweisen von Rollen für Projekte finden Sie unter Zugriff auf Projekte verwalten.

Hinweis

  1. Aktivieren Sie die Cloud Storage API.

    Zur Cloud Storage API

  2. Cloud Logging API aktivieren

    Zur Cloud Logging API

  3. Installieren Sie den Cloud Ops-Agent, den primären Agenten von Google Cloudzum Erfassen von Logs und Messwerten. Wählen Sie eine Installationsmethode basierend auf dem Typ der virtuellen Maschine aus, die Sie verwenden.

  4. Legen Sie den Logging-Schweregrad auf trace fest. Verwenden Sie dazu entweder die Option --log-severity oder das Feld severity zu trace.

Cloud Storage FUSE-Logs an Cloud Logging weiterleiten

  1. Geben Sie /gcsfuse.log für die gcsfuse-Bereitstellung an:

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

  2. Konfigurieren Sie den Cloud Ops-Agent so, dass Logs aus der Datei /gcfuse.log mit der folgenden Konfiguration an Cloud Logging weitergeleitet werden. In dieser Konfiguration ist gcsfuse_trace_logs ein receiver-Element, das Logs aus der Datei /gcsfuse.log empfängt. Das service-Element verknüpft das receiver-Element in der Pipeline.

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

    Weitere Informationen zu weiteren Logging-Konfigurationen finden Sie unter Cloud Logging-Konfigurationen.

  3. Speichern Sie die Konfiguration für den Cloud Ops-Agent in einem von Ihrem Betriebssystem abhängigen Pfad ab. Informationen dazu, welchen Pfad Sie für die Konfiguration auswählen müssen, finden Sie in der Dokumentation von Google Cloud Observability zu vom Nutzer angegebenen Konfigurationen.

  4. Starten Sie den Cloud Ops-Agent neu, um neue Konfigurationsänderungen zu übernehmen. Verwenden Sie dazu den Befehl systemctl restart:

    sudo systemctl restart google-cloud-ops-agent`

  5. Rufen Sie in der Google Cloud Console Cloud Logging auf.

  6. Führen Sie die Filterabfrage fuse_debug aus, um die gcsfuse-Trace-Logs zu validieren, die an Cloud Logging weitergeleitet werden.

Nächste Schritte