Observability-Buckets aktualisieren

Sie können den Anzeigenamen, die Beschreibung oder den Cloud Key Management Service-Schlüssel eines Beobachtbarkeits-Buckets aktualisieren, um Änderungen in der Organisation widerzuspiegeln oder Verschlüsselungsschlüssel zu rotieren.

Mit diesen Aktualisierungsvorgängen können Sie keine Compliance-Probleme beheben. Sie können diese Vorgänge beispielsweise nicht verwenden, um den Speicherort eines Beobachtbarkeits-Buckets zu ändern oder einen Cloud KMS-Schlüssel auf einen Bucket anzuwenden, der die standardmäßige Google-Verschlüsselung verwendet.

Auswirkungen der Aktualisierung eines Cloud KMS-Schlüssels

Die Aktualisierung des Cloud KMS-Schlüssels für einen Beobachtbarkeits-Bucket hat keine Auswirkungen auf gespeicherte Daten. Das heißt, vor Abschluss der Aktualisierung werden neue Daten mit dem ursprünglichen Schlüssel verschlüsselt. Nach Abschluss der Aktualisierung werden neue Daten mit dem aktualisierten Schlüssel verschlüsselt.

Sie können weiterhin auf die gespeicherten Daten zugreifen und sie ansehen, sofern der ursprüngliche Cloud KMS-Schlüssel aktiviert bleibt und das Google Cloud Observability-Dienstkonto die Berechtigungen zum Verschlüsseln und Entschlüsseln behält.

Wenn Sie den ursprünglichen Cloud KMS-Schlüssel deaktivieren oder löschen, sind alle Daten, die geschrieben wurden, als dieser Schlüssel aktiv war, sofort dauerhaft unzugänglich und nicht lesbar.

Beschränkungen

Folgende Einschränkungen gelten:

• Sie können den Speicherort nicht ändern.
• Sie können keinen Cloud KMS-Schlüssel auf einen Beobachtbarkeits-Bucket anwenden, der die standardmäßige Google-Verschlüsselung verwendet.
• Der Anzeigename darf nicht länger als 100 codierte Byte sein.
• Die Beschreibung darf nicht länger als 1.000 codierte Byte sein.
• Daten werden 30 Tage lang gespeichert. Sie können den Aufbewahrungszeitraum weglassen oder auf 30 festlegen.
• Wenn Sie den Cloud KMS-Schlüssel aktualisieren, muss der Speicherort des Schlüssels genau mit dem übergeordneten Speicherort des Beobachtbarkeits-Buckets übereinstimmen.

Hinweis

Konfigurieren Sie Ihr Projekt und Ihre IAM-Rollen und wählen Sie die Schnittstelle aus, die Sie verwenden möchten.

Projekt und Rollen konfigurieren

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Konto bei Google Cloudhaben, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Beobachtbarkeits-Editor (roles/observability.editor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Beobachtbarkeits-Buckets benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

   Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Schnittstellen konfigurieren

Cloud KMS-Schlüssel konfigurieren

Optional. Wenn Sie den Cloud KMS-Schlüssel aktualisieren möchten, der vom Beobachtbarkeits-Bucket verwendet wird, gehen Sie so vor:

1. Aktivieren Sie die Cloud Key Management Service API.

   Rollen, die zum Aktivieren von APIs erforderlich sind

   Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen.

   API aktivieren

2. Schlüsselbund und Schlüssel erstellen.

   Der Speicherort des Beobachtbarkeits-Buckets muss mit dem Speicherort des Schlüssels übereinstimmen.

3. Ersetzen Sie PROJECT_ID durch die ID Ihres Projekts und führen Sie dann den folgenden Befehl aus:

   gcloud beta observability settings describe \
   --location=global --project=PROJECT_ID
   

   Die Antwort auf den vorherigen Befehl enthält die ID des Google Cloud Observability-Dienstkontos.

4. Weisen Sie dem Google Cloud Observability-Dienstkonto die Rolle „ Cloud KMS CryptoKey-Verschlüsseler/Entschlüsseler “ zu.

   gcloud kms keys add-iam-policy-binding \
   --project=KMS_PROJECT_ID \
   --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-observability.iam.gserviceaccount.com \
   --role=roles/cloudkms.cryptoKeyEncrypterDecrypter \
   --location=KMS_KEY_LOCATION \
   --keyring=KMS_KEY_RING \
   KMS_KEY_NAME
   

   Nehmen Sie vor dem Ausführen des vorherigen Befehls die folgenden Ersetzungen vor:

   • KMS_PROJECT_ID: Die eindeutige alphanumerische Kennung des Google Cloud Projekts, in dem Cloud KMS ausgeführt wird. Sie besteht aus dem Namen Ihres Google Cloud Projekts und einer zufällig zugewiesenen Nummer. Informationen zum Abrufen dieser Kennung finden Sie unter Projekte identifizieren.
   • service-PROJECT_NUMBER: Der Name des Google Cloud Observability-Dienst kontos, das im vorherigen Schritt aufgeführt wurde.
   • KMS_KEY_LOCATION: Die Region des Cloud KMS-Schlüssels.
   • KMS_KEY_RING: Der Name des Cloud KMS-Schlüsselbunds.
   • KMS_KEY_NAME: Der Name des Cloud KMS-Schlüssels. Er hat folgendes Format: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY.

Beobachtbarkeits-Bucket aktualisieren

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

{
    "description": "Updated description for my observability bucket."
}

Um zu ermitteln, ob eine Methode, die ein Operation Objekt zurückgibt, abgeschlossen ist, rufen Sie in der Regel projects.locations.operations.get auf, bis das Operation.done Feld auf true gesetzt ist. Anschließend können Sie anhand anderer Felder in der Operation-Struktur feststellen, ob die Methode erfolgreich war oder fehlgeschlagen ist.

Die Methode patch wird jedoch schnell abgeschlossen. Alternativ können Sie daher eine Minute warten und die Aktualisierung dann überprüfen, indem Sie Ihre Beobachtbarkeits-Buckets auflisten.

In diesem Abschnitt wird beschrieben, wie Sie Ihre Beobachtbarkeits-Buckets auflisten. Ein Beobachtbarkeits-Bucket ist die Verwaltungseinheit für Datasets, in denen Daten gespeichert werden.

gcloud beta observability buckets list \
 --location=LOCATION --project=PROJECT_ID

gcloud beta observability buckets list `
 --location=LOCATION --project=PROJECT_ID

gcloud beta observability buckets list ^
 --location=LOCATION --project=PROJECT_ID

---
createTime: '2026-01-21T21:39:22.381083860Z'
description: Bucket for storing spans from Cloud Trace.
name: projects/my-project/locations/us/buckets/_Trace

projects/PROJECT_ID/locations/LOCATION

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

{
  "buckets": [
    {
      "name": "projects/my-project/locations/us/buckets/_Trace",
      "description": "Trace Bucket",
      "createTime": "2025-01-01T15:42:30.988919645Z",
      "updateTime": "2025-02-04T15:42:30.988919645Z",
      "retentionDays": 30
    }
  ]
}

Nächste Schritte

• Traces suchen und untersuchen
• Traces mit SQL abfragen und analysieren