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. 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. Weitere Informationen finden Sie unter Standardspeicherort festlegen.

In diesem Leitfaden wird der Prozess beispielhaft anhand der Weiterleitung aller Logs in eine Region erläutert. 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 in den Zonen innerhalb dieser Region redundant verfügbar sind.

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 die zuverlässige Weiterleitung von Logs speichert der Log-Router die Logs auch temporär, wodurch sie vor temporären Ausfällen in einer Senke geschützt werden.

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, Abrechnungskonto, Ordner und Ihrer Organisation, in denen Logdaten gespeichert und organisiert werden.

Für jedes Google Cloud-Projekt, jedes Rechnungskonto, jeden Ordner und jede Organisation erstellt Logging automatisch zwei Log-Buckets, _Required und _Default, die sich am Speicherort global befinden. Der Speicherort vorhandener Buckets kann nicht geändert werden. Ihre Organisation kann jedoch eine Richtlinie erstellen, mit der ein anderer Standardspeicherort für diese Bucket festgelegt wird. Weitere Informationen finden Sie unter Standardeinstellungen für Organisationen und Ordner konfigurieren.

Für jedes Google Cloud-Projekt können Sie auch benutzerdefinierte Log-Buckets erstellen. Wenn Sie einen benutzerdefinierten Log-Bucket erstellen, können Sie den Speicherort des Log-Buckets angeben. 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. Informationen zum Festlegen des Standorts für Ihre Buckets finden Sie unter Logs regionalisieren.

Logging unterstützt die gemeinsame Abfrage von Logs aus mehreren Regionen. In diesem Fall werden Abfragen am selben Standort wie die abgefragten Buckets verarbeitet und dann in der Region zusammengefasst, in der die Abfrage empfangen wurde, um die Ergebnisse zurückzugeben.

Die Region eines Log-Buckets wird auf der Seite Logspeicher und in einigen Dialogfeldern angezeigt. Wenn Sie beispielsweise die Seite „Log-Explorer“ aufrufen und mit der Auswahl Umfang eingrenzen Logansichten auflisten, werden auch Regionsinformationen angezeigt. Wenn die Region global ist, werden sowohl die Region als auch der aktuelle Speicherort in einem Format ähnlich GLOBAL (US-WEST4) angezeigt.

Hinweise

  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 Protokolleinträge gespeichert werden sollen.
  3. Legen Sie fest, welche Logeinträge an Ihren Log-Bucket weitergeleitet werden sollen. In dieser Anleitung werden alle Logs berücksichtigt, die von der Senke _Default weitergeleitet werden.

  4. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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.

  1. Öffnen Sie eine Shell.

    So verwenden Sie beispielsweise Cloud Shell:

    1. Öffnen Sie die Google Cloud Console:

      Zur Google Cloud Console

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

  2. Führen Sie den Befehl gcloud logging buckets create in der Shell aus, um einen Log-Bucket zu erstellen. 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

  3. 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 Eigenschaften ändern, z. B. 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 für den Datenablauf namens _Default aktualisiert. 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 Kennung 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 Logging 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 Logging ist.

  2. Wählen Sie Bereich eingrenzen aus.

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

  4. Wählen Sie die _AllLogs-Ansicht aus, die mit Ihrer 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