Logbasierte Messwerte auf Bucket-Ebene

In diesem Dokument werden die Merkmale von logbasierten Messwerten auf Bucketebene zusammengefasst und beschrieben, wie sie sich von logbasierten Messwerten auf Projektebene unterscheiden.

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 Bucketebene können Sie logbasierte Messwerte erstellen, die in den folgenden Fällen Daten aus Protokollen extrahieren:

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

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

Logbasierte Messwerte auf Bucketebene unterscheiden sich in mehreren Punkten von logbasierten Messwerten auf Projektebene.

Projekte und Messwertbereiche

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

Die Google Cloud-Projekte, die Protokolle an den Bucket weiterleiten, müssen nicht zum Messwertbereich eines Projekts gehören.

Weitere Informationen zu logbasierten Messwerten und Messwertbereichen finden Sie unter Zugriff auf Messwertbereiche.

Wenn die Logs im Bucket empfangen werden, sind die abgeleiteten Messwertdaten der weitergeleiteten Logs für alle Projekte sichtbar, die den Bucket in ihrem Messwertbereich enthalten. Wenn sich die Logs eines Projekts nicht im Messwertbereich eines Projekts befinden, sind andere Informationen im Routingprojekt nicht sichtbar.

Bei der Verwendung von logbasierten Messwerten auf Bucketebene gilt Folgendes:

  • Sie definieren den logbasierten Messwert im Projekt mit dem Ziel-Bucket.
  • Bei logbasierten Messwerten auf Bucket-Ebene werden alle Logeinträge ausgewertet, die an den Bucket weitergeleitet werden, unabhängig davon, ob das Protokoll 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 im Messwertbereich enthalten.
  • Routing-Logs von Projekten müssen sich nicht im Messwertbereich eines Projekts befinden.

Typ der überwachten Ressource: logging_bucket

Bei logbasierten Messwerten auf Bucketebene wird der Typ „Überwachte Ressource“ logging_bucket verwendet, wenn Zeitreihendaten in Cloud Monitoring geschrieben werden. Der Ressourcentyp logging_bucket enthält die folgenden Labels:

  • project_id: Die Kennung Ihres Google Cloud-Projekts, ein String wie my-test-project.
  • bucket_id: Der Name des Log-Buckets, der dem logbasierten Messwert zugeordnet ist, z. B. my-test-bucket.
  • location: Der Speicherort des Log-Buckets.
  • monitored_resource_type: Der Typ der überwachten Ressource, für die dieser Logeintrag erstellt wurde. Der Wert stammt aus dem Feld type der Struktur MonitoredResource, die im Feld resource des Logeintrags enthalten ist.
  • source_resource_container: Die Kennung für das Projekt, den Ordner oder die Organisation, von dem bzw. der der Logeintrag gesendet wurde. Ein String in einer der folgenden Formen:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID