Observability-Buckets aktualisieren

Sie können den Anzeigenamen, die Beschreibung oder den Cloud Key Management Service-Schlüssel eines Observability-Buckets aktualisieren, um Organisationsänderungen zu berücksichtigen 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 Observability-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

Wenn Sie den Cloud KMS-Schlüssel für einen Observability-Bucket aktualisieren, hat das 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 ist und das Google Cloud Observability-Dienstkonto die Berechtigungen zum Verschlüsseln/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 nicht mehr zugänglich und nicht mehr lesbar.

Beschränkungen

Folgende Einschränkungen gelten:

  • Sie können den Standort nicht ändern.
  • Sie können keinen Cloud KMS-Schlüssel auf einen Observability-Bucket anwenden, der die Google-Standardverschlü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.
  • Die Daten werden 30 Tage lang gespeichert. Sie können die Aufbewahrungsdauer 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 Observability-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

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, 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.

  2. 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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

  5. 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

  6. Verify that billing is enabled for your Google Cloud project.

  7. 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

    8.

  8. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Observability Editor (roles/observability.editor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktualisieren von Observability-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

gcloud

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

Terraform

Wenn Sie die Terraform-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

  1. Installieren Sie die Google Cloud CLI.

  2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto: 

    gcloud auth application-default login

    Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.

    Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter ADC für eine lokale Entwicklungsumgebung einrichten.

REST

Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

    Installieren Sie die Google Cloud CLI.

    Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Cloud KMS-Schlüssel konfigurieren

Optional. Wenn Sie den Cloud KMS-Schlüssel aktualisieren möchten, der vom Observability-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 Observability-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

    Ersetzen Sie vor dem Ausführen des vorherigen Befehls Folgendes:

    • 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-Dienstkontos, 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 das folgende Format: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY.

Observability-Bucket aktualisieren

gcloud

Nicht unterstützt.

Terraform

Verwenden Sie zum Aktualisieren des Anzeigenamens, der Beschreibung oder des CMEK die Terraform-Ressource google_observability_bucket und legen Sie die folgenden Felder fest:

  • project: die ID des Projekts
  • location: Der Speicherort des Observability-Buckets. Weitere Informationen finden Sie unter Standorte.
  • bucket_id: Die ID des Observability-Buckets. Dieses Feld muss auf _Trace gesetzt werden.

Sie können nur die Beschreibung, den Anzeigenamen und den CMEK aktualisieren. Weitere Informationen finden Sie in der Dokumentation für die Ressource.

REST

Wenn Sie einen Observability-Bucket aktualisieren möchten, senden Sie eine Anfrage an projects.locations.buckets.patch.

Sie müssen den übergeordneten Parameter angeben, der den zu aktualisierenden Bucket identifiziert. Dieser Parameter hat das folgende Format:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

Der Abfrageparameter muss ein updateMask-Feld enthalten, das angibt, welche Felder geändert werden sollen. Beispiel:

  • Verwenden Sie updateMask=description, um die Beschreibung zu aktualisieren.
  • Verwenden Sie updateMask=description,cmekSettings.kmsKey, um den Cloud KMS-Schlüssel und die Beschreibung zu aktualisieren.

Der Anfragetext ist ein Bucket-Objekt. Sie müssen jedes Feld ausfüllen, das in der Aktualisierungsmaske angegeben ist. Füllen Sie keine Felder aus, die Sie nicht aktualisieren.

Wenn Sie beispielsweise nur das Feld description aktualisieren möchten, können Sie das folgende Bucket-Objekt verwenden:

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

Die Antwort ist ein Operation-Objekt. Diese Methode dauert in der Regel weniger als eine Minute.

Normalerweise rufen Sie zum Ermitteln, ob eine Methode, die ein Operation-Objekt zurückgibt, abgeschlossen ist, das Objekt durch Aufrufen von projects.locations.operations.get ab, bis das Feld Operation.done 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 patch-Methode wird jedoch schnell abgeschlossen. Eine Alternative besteht darin, eine Minute zu warten und dann das Update zu bestätigen, indem Sie Ihre Observability-Buckets auflisten.

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

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • LOCATION: Der Speicherort der Observability-Buckets. Wenn Sie alle Observability-Buckets unabhängig vom Standort auflisten möchten, legen Sie den Standort auf einen Bindestrich (-) fest.
  • PROJECT_ID: Die Kennung des Projekts.

Führen Sie den Befehl gcloud beta observability buckets list aus:

Linux, macOS oder Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Die Antwort enthält den Namen, die Beschreibung und die Erstellungszeit der einzelnen Observability-Buckets. Hier ist ein Beispiel für eine Antwort, wenn der Befehl erfolgreich ist: 

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

Terraform

Sie können Terraform nicht verwenden, um Observability-Buckets aufzulisten.

REST

Mit der Methode projects.locations.buckets.list können Sie die Observability-Buckets auflisten, die sich in Ihrem Projekt und an einem bestimmten Standort befinden.

Sie müssen den Parameter „parent“ angeben, der das folgende Format hat:

projects/PROJECT_ID/locations/LOCATION

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

  • PROJECT_ID: Die Kennung des Projekts.
  • LOCATION: Der Speicherort des Observability-Buckets. Wenn Sie LOCATION auf einen Bindestrich (-) setzen, werden alle Observability-Buckets in Ihrem Projekt aufgeführt.

Die Antwort ist ein Array von Bucket-Objekten. Für jedes Objekt hat der Wert des Felds name das folgende Format:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

Im Folgenden finden Sie ein Beispiel für eine Antwort:

{
  "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
    }
  ]
}

Mit der Observability API können Sie weitere Informationen zum Bucket mit der ID BUCKET_ID abrufen. Sie können beispielsweise die Datasets in diesem Bucket sowie die Ansichten und Links für jedes Dataset auflisten. Weitere Informationen finden Sie in der Referenzdokumentation zur Observability API.

Nächste Schritte