Logbasierte Messwerte auf Bucket-Ebene

In diesem Dokument werden die Merkmale logbasierter Messwerte auf Bucket-Ebene zusammengefasst. Außerdem wird beschrieben, wie sie sich von logbasierten Messwerten auf Projektebene unterscheiden.

Merkmale logbasierter Messwerte 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 wurden. Mit logbasierten Messwerten auf Bucket-Ebene können Sie logbasierte Messwerte erstellen, die in den folgenden Fällen Daten aus Logs extrahieren:

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

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

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

Projekt- und Messwertbereiche

Logbasierte Messwerte auf Bucket-Ebene werden im selben Projekt definiert, das den Quell-Bucket enthält. Standardmäßig kann nur das Projekt, das einen logbasierten Messwert auf Bucket-Ebene definiert, die Messwertdaten für den Log-Bucket sehen. Wenn Ihr Projekt jedoch im Messwertbereich anderer Projekte angezeigt wird, können diese Projekte auch Ihre Messwerte sehen.

Die Google Cloud-Projekte, die Logs an den Bucket weiterleiten, müssen sich nicht im Messwertbereich eines Projekts befinden.

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

Wenn die Logs im Bucket empfangen werden, sind die abgeleiteten Logmesswert-Daten für jedes Projekt sichtbar, das das Projekt des Buckets in seinem Messwertbereich enthält. Wenn die Routinglogs eines Projekts nicht im Messwertbereich eines Projekts enthalten sind, sind andere Informationen im Routingprojekt nicht sichtbar.

Wenn Sie logbasierte Messwerte auf Bucket-Ebene verwenden, gelten die folgenden Anweisungen:

  • Sie definieren den logbasierten Messwert im Projekt mit dem Ziel-Bucket.
  • Ihre logbasierten Messwerte auf Bucket-Ebene werten alle an den Bucket weitergeleiteten Logeinträge aus, unabhängig davon, ob das Log aus demselben Projekt wie der Bucket oder aus einem anderen Projekt stammt.
  • Die Messwertdaten sind für jedes andere Projekt sichtbar, das das Projekt mit dem Bucket im Messwertbereich enthält.
  • Routinglogs von Projekten müssen sich nicht im Messwertbereich eines Projekts befinden.

Typ der überwachten Ressource: logging_bucket

Logbasierte Messwerte auf Bucket-Ebene verwenden beim Schreiben von Zeitreihendaten in Cloud Monitoring den Typ der überwachten Ressource logging_bucket. Der Ressourcentyp logging_bucket 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 aus der MonitoredResource-Struktur, die im Feld resource des Logeintrags enthalten ist.
  • source_resource_container: Die ID des Projekts, des Ordners oder der Organisation, von der der Logeintrag gesendet wurde, als String in einer der folgenden Formen:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID