Logbasierte Messwerte mit Bucket-Bereich

In diesem Dokument werden die Merkmale von logbasierten Messwerten auf Bucket-Ebene zusammengefasst und die Unterschiede zu logbasierten Messwerten auf Projektebene beschrieben.

Merkmale von logbasierten Messwerten auf Bucket-Ebene

Logbasierte Messwerte auf Bucket-Ebene sind benutzerdefinierte logbasierte Messwerte, mit denen Logeinträge ausgewertet werden, die an einen bestimmten Log-Bucket weitergeleitet werden. Mit logbasierten Messwerten auf Bucket-Ebene können Sie logbasierte Messwerte erstellen, mit denen Daten aus Logs in den folgenden Fällen extrahiert werden können:

  • Logs, die von einem Projekt an einen Bucket in einem anderen Projekt weitergeleitet werden.
  • Logs, die über eine aggregierte Senke in einen Bucket weitergeleitet werden.

Wie logbasierte Messwerte auf Projektebene werden logbasierte Messwerte auf Bucket-Ebene in einem Google Cloud Projekt definiert, nicht auf Ordner- oder Organisationsebene. Wenn Sie den Ordner oder die Organisation verfolgen möchten, von dem bzw. der ein Logeintrag an den Bucket weitergeleitet wurde, können Sie in dem logbasierten Messwert Labels definieren, um diese Informationen zu erfassen.

Logbasierte Messwerte auf Bucket-Ebene unterscheiden sich in mehreren Punkten von logbasierten Messwerten auf Projektebene.

Projekte und Messwertbereiche

Logbasierte Messwerte auf Bucket-Ebene werden in demselben Projekt definiert, das den Quell-Bucket enthält. Standardmäßig kann nur das Projekt, in dem ein logbasierter Messwert auf Bucket-Ebene definiert ist, die Messwertdaten für den Log-Bucket sehen. Wenn Ihr Projekt jedoch im Messwertbereich anderer Projekte enthalten ist, können diese Projekte auch Ihre Messwerte sehen.

Die Google Cloud Projekte, die Logs an den Bucket weiterleiten, müssennicht im Messwertbereich eines Projekts enthalten sein.

Weitere Informationen zu logbasierten Messwerten und Messwertbereichen finden Sie unter Sichtbarkeit für Messwertbereiche.

Wenn die Logs im Bucket eingehen, sind die abgeleiteten Messwertdaten für weitergeleitete Logs für alle Projekte sichtbar, die das Projekt des Buckets in ihrem Messwertbereich enthalten. Wenn ein Projekt, das Logs weiterleitet, nicht im Messwertbereich eines Projekts enthalten ist, sind andere Informationen im weiterleitenden Projekt nicht sichtbar.

Bei der Verwendung von logbasierten Messwerten auf Bucket-Ebene gilt Folgendes:

  • Sie definieren den logbasierten Messwert in dem Projekt mit dem Ziel-Bucket.
  • Mit logbasierten Messwerten auf Bucket-Ebene werden alle Logeinträge ausgewertet, die an den Bucket weitergeleitet werden, unabhängig davon, ob das Log aus demselben Projekt wie der Bucket oder aus einem anderen Projekt stammt.
  • Die Messwertdaten sind für alle anderen Projekte sichtbar, die das Projekt mit dem Bucket in ihrem Messwertbereich enthalten.
  • Projekte, die Logs weiterleiten, müssen nicht im Messwertbereich eines Projekts enthalten sein.

Typ der überwachten Ressource: logging_bucket

Bei logbasierten Messwerten auf Bucket-Ebene wird der Typ der überwachten Ressource logging_bucket verwendet, wenn Zeitreihendaten in Cloud Monitoring geschrieben werden. Der logging_bucket Ressourcentyp enthält die folgenden Labels:

  • project_id: Die ID Ihres Google Cloud Projekts, ein String wie my-test-project.
  • bucket_id: Der Name des Log-Buckets, der mit dem logbasierten Messwert verknüpft ist, ein String wie my-test-bucket.
  • location: Der Speicherort des Log-Buckets.
  • monitored_resource_type: Der Typ der überwachten Ressource, die diesen Logeintrag erzeugt hat. Der Wert stammt aus dem Feld type der Struktur MonitoredResource, die im Feld resource des Logeintrags enthalten ist.
  • source_resource_container: Die ID des Projekts, Ordners oder der Organisation, von dem bzw. der der Logeintrag gesendet wurde, ein String in einem der folgenden Formate:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID