Logs regionalisieren

In diesem Dokument wird beschrieben, wie Sie mit dem _Default-Sink Ihre Logeinträge an einen Cloud Logging-Bucket in einer bestimmten Region weiterleiten können. Für eine Liste der unterstützten Regionen finden Sie unter Standorte.

Sie können auch einen Standardspeicherort für neue _Default- und _Required-Buckets festlegen, indem Sie die Standardeinstellungen für Ihre Organisation oder Ihren Ordner konfigurieren. Für weitere Informationen, Weitere Informationen finden Sie unter Standardspeicherort festlegen.

Dieser Leitfaden führt Sie durch die indem Sie alle Logs an einen Region Dieser Vorgang umfasst folgende Schritte:

  1. Erstellen Sie einen Log-Bucket in der dafür vorgesehenen Region zum Speichern der Logs.

  2. Leiten Sie die Senke _Default weiter, um die Logs an den neuen Log-Bucket weiterzuleiten.

  3. Suchen Sie im Log-Explorer nach Logs.

Übersicht

In Logging sind Log-Buckets regionale Ressourcen: die Infrastruktur, in der Ihre Logs gespeichert, indexiert und durchsucht werden, befindet sich an einem bestimmten geografischen Standort. Google Cloud verwaltet diese Infrastruktur, sodass Ihre Anwendungen redundant verfügbar sind. für alle Zonen in dieser Region.

Ihre Organisation muss Logdaten möglicherweise in bestimmten Regionen speichern. Einer der primären Hauptfaktoren bei der Auswahl der Region, in der Logs gespeichert werden, ist die Erfüllung der Anforderungen Ihres Unternehmens in Bezug auf Latenz, Verfügbarkeit oder Compliance. Berücksichtigen Sie bei der Auswahl einer Region für den Logspeicher die Standorte der anderen Google Cloud-Produkte und -Dienste, die Ihre Anwendung verwendet.

Wichtige Konzepte

Die folgenden wichtigen Konzepte gelten für die Datenregionalität für Logging.

Log-Router-Standorte

Der Log-Router verarbeitet alle Logeinträge, die in die Cloud Logging API geschrieben wurden. Er prüft jeden Logeintrag auf vorhandene Regeln, um zu bestimmen, welche Logeinträge in Logging-Buckets gespeichert werden und welche Logeinträge mithilfe von Senken an unterstützte Ziele weitergeleitet werden. Für ein zuverlässiges Routing von Logs Log Router speichert die Protokolle auch temporär, wodurch ein Zwischenspeicher für temporäre Störungen verursacht.

Der Log-Router verarbeitet Logs in der Region, in der sie empfangen werden. Der Log-Router kann Logs an eine andere Region senden; dies ist abhängig von der Definition einer Senke bzw. davon, ob Logdaten mit einem anderen Google Cloud-Dienst wie Security Command Center Threat Detection gemeinsam genutzt werden. Senken gelten unabhängig von der Region für alle Logs gleichermaßen.

Log-Bucket-Standorte

Log-Buckets sind die Container in Ihrem Google Cloud-Projekt, -Rechnungskonto, -Ordner und -Organisation, die und zum Organisieren Ihrer Logdaten.

Für jedes Google Cloud-Projekt, jedes Rechnungskonto, jeden Ordner und jede Organisation Logging erstellt automatisch zwei Log-Buckets: _Required und _Default. Diese befinden sich am Standort global. Sie können den Standort vorhandener Buckets nicht ändern. Ihre Organisation kann jedoch eine Richtlinie der einen anderen Standardspeicherort für diese Buckets festlegt. Weitere Informationen finden Sie unter Standardeinstellungen für Organisationen und Ordner konfigurieren.

Sie können für beliebige Log-Buckets auch benutzerdefinierte Log-Buckets erstellen. Google Cloud-Projekt Wenn Sie einen benutzerdefinierten Log-Bucket erstellen, können Sie Geben Sie den Speicherort des Log-Buckets an. Nachdem Sie den Log-Bucket erstellt haben, kann der Speicherort nicht mehr geändert werden. Sie können jedoch einen neuen Bucket erstellen und Logeinträge mithilfe von Senken an den neuen Log-Bucket weiterleiten. Weitere Informationen zum Standort Ihrer Buckets, siehe Logs regionalisieren

Logging unterstützt die gemeinsame Abfrage von Logs aus mehreren Regionen, in In diesem Fall werden Abfragen an denselben Orten verarbeitet wie die Buckets, abgefragt und dann in der Region aggregiert, aus der die Abfrage zurückgegeben wurde die Ergebnisse.

Hinweis

So führen Sie die Schritte in dieser Anleitung aus:

  1. Geben Sie das Google Cloud-Projekt an, in dem Ihre Logeinträge gespeichert werden sollen.
  2. Geben Sie den Namen und Speicherort des Log-Buckets an, in dem Ihre Logeinträge gespeichert werden sollen.
  3. Legen Sie fest, welche Logeinträge an Ihren Log-Bucket weitergeleitet werden sollen. In diesem Leitfaden sind alle Logs enthalten, die von der Senke _Default weitergeleitet werden.

Unterstützte Regionen

Wenn Sie Ihren Log-Bucket erstellen, können Sie auswählen, wo Ihre Logs gespeichert werden sollen. Eine Liste der unterstützten Regionen finden Sie unter Standorte.

Log-Bucket erstellen

In Log-Buckets werden Logeinträge gespeichert. Projekte, Ordner und Organisationen enthalten Log-Senken, die Logeinträge an Log-Buckets oder andere Ziele weiterleiten. Wenn das Ziel eines Sinks ein Log-Bucket ist, kann sich dieses Log-Bucket in derselben Ressource wie der Log-Sink oder in einer anderen Ressource befinden. Weitere Informationen finden Sie unter Log-Buckets konfigurieren.

So erstellen Sie den Bucket in dem Google Cloud-Projekt, in dem Sie Logs speichern möchten führen Sie die folgenden Schritte aus:

  1. Rufen Sie die Google Cloud Console auf:

    Zur Google Cloud Console

  2. Klicken Sie in der Symbolleiste auf  Cloud Shell aktivieren.

  3. Führen Sie zum Erstellen eines Log-Buckets den Befehl gcloud logging buckets create-Befehl im Cloud Shell Bevor Sie den Beispielbefehl ausführen, ersetzen Sie die folgenden Werte:

    • BUCKET_ID: Der Name oder die ID des Log-Buckets.
    • LOCATION: Der Speicherort des Log-Buckets.
    • PROJECT_ID: Die Kennung des Projekts.

    Beispielbefehl:

    gcloud logging buckets create BUCKET_ID \
  --location=LOCATION \
  --project=PROJECT_ID

  4. Prüfen Sie, ob der Bucket erstellt wurde:

    gcloud logging buckets list --project=PROJECT_ID

Nachdem Sie den Log-Bucket erstellt haben, können Sie einige Attribute ändern, z. B. wie die Beschreibung und die Aufbewahrungsdauer. Verwenden Sie dazu den Befehl gcloud logging buckets update.

_Default-Logsenke weiterleiten

Um Logs zu einem Log-Bucket weiterzuleiten, können Sie eine Senke erstellen. Eine Senke enthält einen Filter, der bestimmt, welche Logeinträge über die Senke exportiert werden, sowie ein Ziel. In diesem Leitfaden aktualisieren Sie die vorhandene Senke _Default, um Logeinträge an den im vorherigen Schritt erstellten Log-Bucket weiterzuleiten.

Führen Sie den Befehl gcloud logging sinks update aus, um eine Senke zu aktualisieren. Bevor Sie den Beispielbefehl ausführen, ersetzen Sie die folgenden Werte:

  • _Default: In diesem Beispiel wird das Ziel der Senke mit dem Namen _Default. Wenn Sie einen anderen Datenablauf aktualisieren möchten, ändern Sie den Namen dieser Variablen.
  • BUCKET_ID: Der Name oder die ID des Log-Buckets.
  • LOCATION: Der Speicherort des Log-Buckets.
  • PROJECT_ID: Die Kennung des Projekts.

Beispielbefehl:

gcloud logging sinks update _Default \
  logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID \
  --log-filter='NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT
    LOG_ID("externalaudit.googleapis.com/activity") AND NOT
    LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT
    LOG_ID("externalaudit.googleapis.com/system_event") AND NOT
    LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT
    LOG_ID("externalaudit.googleapis.com/access_transparency")' \
  --description="Updated the _Default sink to route logs to the LOCATION region"

Logeintrag zum Testen der Senke erstellen

Führen Sie die folgenden Schritte aus, um zu prüfen, ob Sie die Senke ordnungsgemäß aktualisiert haben:

  1. Senden Sie mit dem Befehl gcloud logging write eine Testlognachricht an Ihren regionalisierten Bucket. Bevor Sie den Beispielbefehl ausführen, ersetzen Sie die folgenden Werte:

    • LOG_NAME: Der Name des Logs.
    • BUCKET_ID: Der Name oder die ID des Log-Buckets.
    • PROJECT_ID: Die Kennzeichnung des Projekts.

    Beispielbefehl:

    gcloud logging write LOG_NAME "Test to route logs to BUCKET_ID" \
--project=PROJECT_ID

  2. So rufen Sie den Logeintrag auf:

    1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

      Zum Log-Explorer

      Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

    2. Klicken Sie in der Symbolleiste auf Umfang eingrenzen und wählen Sie dann Aktuelles Projekt aus.

      Der Log-Explorer ist so konfiguriert, dass Logeinträge angezeigt werden, die aus Ihrem Projekt stammen.

    3. Wählen Sie im Bereich Logfeld den Ressourcentyp Global aus.

    4. Der Testlogeintrag wird im Bereich Abfrageergebnisse angezeigt.

Logs in der Google Cloud Console suchen

So rufen Sie die Logeinträge in Ihrem Log-Bucket in der Google Cloud Console auf:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie Bereich eingrenzen aus.

  3. Wählen Sie im Bereich Bereich eingrenzen die Option Logansicht aus.

  4. Wählen Sie die _AllLogs-Datenansicht aus, die mit BUCKET_NAME verknüpft ist.

  5. Klicken Sie auf Anwenden.

    Der Log-Explorer wird aktualisiert und zeigt die Logs Ihres Buckets an.

    Informationen zur Verwendung des Log-Explorers finden Sie unter Logs mit dem Log-Explorer ansehen

Nächste Schritte