Anforderungen an den Datenstandort und CMEK beheben

Sie können einen Beobachtbarkeits-Bucket neu bereitstellen, um die gesetzlichen Anforderungen an den Datenstandort und die Verschlüsselung zu erfüllen. Nach der erneuten Bereitstellung entsprechen der Speicherort und die Verschlüsselungskonfiguration des Buckets _Trace Ihren Standardeinstellungen für Beobachtbarkeits-Buckets.

Wenn Sie einen Bucket neu bereitstellen möchten, konfigurieren Sie die Standardeinstellungen und rufen Sie dann die Methode zur Neubereitstellung auf. Der Vorgang zur erneuten Bereitstellung kann Folgendes bewirken:

  • Cloud Key Management Service-Schlüssel rückwirkend auf einen Beobachtbarkeits-Bucket anwenden, ohne den Speicherort zu ändern.
  • Ändern Sie den Speicherort eines Beobachtbarkeits-Buckets und verwenden Sie die standardmäßige Google-Verschlüsselung.
  • Speicherort eines Observability-Buckets ändern und die gespeicherten Daten mit einem Cloud KMS-Schlüssel verschlüsseln

Stellen Sie einen Beobachtbarkeits-Bucket nicht neu bereit, wenn Sie den Anzeigenamen, die Beschreibung oder den Cloud KMS-Schlüssel ändern möchten. Aktualisieren Sie in diesen Fällen den Beobachtbarkeits-Bucket.

So funktioniert die erneute Bereitstellung

Wenn Sie einen Vorgang zur erneuten Bereitstellung initiieren, führt das System die folgenden Schritte aus:

  1. Das System bestimmt, ob der Beobachtbarkeits-Bucket für die erneute Bereitstellung infrage kommt. Ein Beobachtbarkeits-Bucket ist zulässig, wenn alle folgenden Prüfungen erfolgreich sind:

    • Der Beobachtbarkeits-Bucket hat den Namen _Trace.
    • Der Bucket wurde nicht neu bereitgestellt.
    • Die Standardeinstellungen für Beobachtbarkeits-Buckets werden gefunden.
    • Damit die Standardeinstellungen eingehalten werden, muss der Standort des Observability-Buckets geändert oder die Verschlüsselung von der standardmäßigen Google-Verschlüsselung in CMEK geändert werden.

  2. Das System aktualisiert die Bucket-Konfiguration. Dieser Vorgang dauert vier bis fünf Stunden.

Beschränkungen

Es gelten folgende Einschränkungen:

  • Das System lässt maximal einen Vorgang zur erneuten Bereitstellung pro Beobachtbarkeits-Bucket zu. Nachfolgende Anfragen schlagen mit dem Fehler FAILED_PRECONDITION fehl.

  • Sie können nur Buckets mit dem Namen _Trace neu bereitstellen.

  • Sie können nicht auf Daten zugreifen, die vor der Initiierung der erneuten Bereitstellung gespeichert wurden. Diese Daten wurden gelöscht und können nicht wiederhergestellt werden.

  • Wenn sich der Speicherort des Buckets ändert, werden Links und verknüpfte BigQuery-Datasets gelöscht. Sie müssen alle Verknüpfungen neu erstellen.

  • Wenn sich der Standort des Buckets ändert, müssen Sie vorhandene Analyseansichten manuell aktualisieren.

  • Sie können einen Vorgang zur erneuten Bereitstellung nicht abbrechen oder rückgängig machen. Versuche, den Vorgang abzubrechen, werden ignoriert.

  • Das Verhalten von Abfragen während eines Vorgangs zur erneuten Bereitstellung ist nicht definiert.

Audit

Anhand Ihrer Audit-Logs können Sie den Verlauf der erneuten Bereitstellung eines Observability-Buckets ermitteln. In den Logs für Administratoraktivitäten wird aufgezeichnet, wer eine Anfrage zur erneuten Bereitstellung gestellt hat, welcher Observability-Bucket betroffen ist und wie die erste Antwort lautet.

Wenden Sie die folgenden Filter im Log-Explorer an, um diese Einträge zu finden:

logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity" AND
resource.type="audited_resource" AND
resource.labels.service="observability.googleapis.com" AND
resource.labels.method="google.cloud.observability.v1.Observability.ReprovisionBucket"

Das folgende unvollständige Beispiel zeigt ein Audit-Log für Administratoraktivitäten:

  {
    "logName": "projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity",
    "resource": {
      "type": "audited_resource",
      "labels": {
        "project_id": "PROJECT_ID",
        "service": "observability.googleapis.com",
        "method": "google.cloud.observability.v1.Observability.ReprovisionBucket"
      }
    },
    "protoPayload": {
      "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
      "status": {
        "code": 0,
        "message": "OK"
      },
      ...
      "serviceName": "observability.googleapis.com",
      "methodName": "google.cloud.observability.v1.Observability.ReprovisionBucket",
      "authorizationInfo": [...]
      "resourceName": "projects/PROJECT_ID/locations/us/buckets/_Trace",
      "request": {
        "@type": "type.googleapis.com/google.cloud.observability.v1.ReprovisionBucketRequest",
        "name": "projects/PROJECT_ID/locations/us/buckets/_Trace"
      },
      "response": {
        "@type": "type.googleapis.com/google.longrunning.Operation",
        "name": "projects/PROJECT_ID/locations/us/operations/reprovision-123456789-0",
        "done": false,
        "metadata": {
          "@type": "type.googleapis.com/google.cloud.observability.v1.OperationMetadata",
          "target": "projects/PROJECT_ID/locations/us/buckets/_Trace",
          "verb": "reprovision",
          "apiVersion": "v1"
        }
      }
    },
    "severity": "NOTICE",
    "timestamp": "2026-06-30T16:54:02.123456Z"
  }

Hinweis

  1. Sehen Sie sich die Einschränkungen an.

  2. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Observability Editor (roles/observability.editor) für das Projekt zuzuweisen, in dem Ihr Observability-Bucket gehostet wird, um die Berechtigungen zu erhalten, die Sie zum erneuten Bereitstellen eines Observability-Buckets benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Die Rolle „Observability Editor“ bietet Berechtigungen zum Erstellen und Löschen von Observability-Buckets, Observability-Datasets und Links zu Datasets. Sie benötigen diese Berechtigungen, da der Vorgang zur erneuten Bereitstellung sowohl Erstellungs- als auch Löschbefehle ausgibt.

    Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Beobachtbarkeits-Bucket neu bereitstellen

So stellen Sie einen Beobachtbarkeits-Bucket neu bereit:

  1. Standardeinstellungen für Beobachtbarkeits-Buckets konfigurieren
  2. Bucket neu bereitstellen
  3. Fortschritt im Blick behalten
  4. Verknüpfungen manuell erstellen und Analyseansichten aktualisieren

Standardeinstellungen für Beobachtbarkeits-Buckets konfigurieren

Legen Sie einen Standardspeicherort und optional einen Cloud KMS-Standardschlüssel fest. Sie können diese auf Projekt-, Ordner- oder Organisationsebene festlegen. Wenn Sie beispielsweise Standardeinstellungen für einen Ordner konfigurieren, verwenden die untergeordneten Elemente dieses Ordners diese Einstellungen, es sei denn, für ein untergeordnetes Element wurden ebenfalls Standardeinstellungen konfiguriert.

Weitere Informationen zum Aufrufen und Konfigurieren von Standardeinstellungen finden Sie unter Standardeinstellungen für Beobachtbarkeits-Buckets festlegen.

Bucket neu bereitstellen

Verwenden Sie Scripts, die die Anfrage zur erneuten Bereitstellung asynchron senden und abfragen, um festzustellen, wann der Vorgang abgeschlossen ist. Verwenden Sie die Methode projects.locations.buckets.reprovision, um einen Beobachtbarkeits-Bucket neu bereitzustellen.

Sie müssen den Namen des Beobachtbarkeits-Buckets angeben, der das folgende Format hat:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

Die Felder im vorherigen Ausdruck haben die folgenden Bedeutungen:

Die Antwort ist ein Operation-Objekt. Das Feld Operation.done enthält Informationen zum Fortschritt:

  • done ist false: Der Vorgang wird ausgeführt. Informationen zum Abfragen des Vorgangs finden Sie unter Fortschritt überwachen.

  • done ist true: Der Vorgang ist abgeschlossen und entweder das Feld error oder response ist festgelegt:

    • response ist festgelegt: Gibt den erfolgreichen Abschluss des asynchronen Vorgangs an. Der Wert spiegelt den neuesten Status des Beobachtbarkeits-Buckets wider, der das Ziel der erneuten Bereitstellung war.

    • error ist festgelegt: Gibt an, dass der asynchrone Vorgang fehlgeschlagen ist. Der Wert dieses Felds ist ein Status-Objekt, das einen gRPC-Fehlercode und eine Fehlermeldung enthält. Informationen zu häufigen Fehlermeldungen finden Sie unter Fehlermeldungen.

Die erneute Bereitstellung dauert in der Regel vier bis fünf Stunden.

Fortschritt überwachen

Das Operation-Objekt enthält Informationen zum Fortschritt. Fragen Sie den Vorgang ab, bis der Wert des Felds Operation.done true ist. Anhand der Felder Operation.response und Operation.error können Sie dann feststellen, ob die erneute Bereitstellung erfolgreich war oder fehlgeschlagen ist.

Verwenden Sie zum Abfragen des Operation die Methode folders.locations.operations.get.

Legen Sie den Pfadparameter auf den Namen des Vorgangs fest:

operations/UNIQUE_ID

Das Feld UNIQUE_ID ist die eindeutige Kennung des Vorgangs.

Die Antwort ist ein aktualisiertes Operation-Objekt.

Wenn Ihre Anwendung beim Abfragen eine HTTP 503 / UNAVAILABLE-Antwort erhält, implementieren Sie einen exponentiellen Backoff und wiederholen Sie die Anfrage. Dieser Fehler weist darauf hin, dass die Anfrage auf der Transport- oder Netzwerkschicht fehlgeschlagen ist.

Links manuell erstellen und Analyseansichten aktualisieren

Erstellen Sie nach Abschluss der erneuten Bereitstellung alle Links neu und aktualisieren Sie Ihre Analyseansichten.

Sie könnten beispielsweise Folgendes tun:

  1. Listen Sie die Links im Observability-Dataset auf. In einigen Szenarien bleiben die Links beim erneuten Bereitstellen erhalten. Informationen zu diesem Schritt finden Sie unter Verknüpfungen in einem Dataset auflisten.

  2. Erstellen Sie das verknüpfte BigQuery-Dataset neu. Informationen zu diesem Schritt finden Sie unter Verknüpfung für ein Dataset erstellen.

  3. Überprüfen Sie Ihre Analyseansichten und aktualisieren Sie den Pfad zum Observability-Bucket nach Bedarf.

Fehlermeldungen

In diesem Abschnitt werden häufige Fehlercodes und, falls zutreffend, Wiederherstellungsaktionen aufgeführt.

FAILED_PRECONDITION

Die Fehlermeldung FAILED_PRECONDITION weist darauf hin, dass der Beobachtbarkeits-Bucket nicht für die erneute Bereitstellung infrage kommt.

Beispiel für Fehlermeldung:

{
    "error":{
        "code": 400,
        "message": "Only _Trace buckets can be reprovisioned.",
        "status": "FAILED_PRECONDITION",
        "details": [ ... ]
    }
}

Sie können nichts tun, um den Beobachtbarkeits-Bucket für die erneute Bereitstellung infrage kommen zu lassen.

INVALID_ARGUMENT

Die Fehlermeldung INVALID_ARGUMENT gibt an, dass der Standort und die CMEK-Konfiguration des Observability-Buckets mit den Standardeinstellungen für Observability-Buckets übereinstimmen.

Aktualisieren Sie die Standardeinstellungen für Observability-Buckets für das Projekt, den Ordner oder die Organisation und versuchen Sie dann noch einmal, den Observability-Bucket bereitzustellen.

PERMISSION_DENIED

Die Fehlermeldung PERMISSION_DENIED weist darauf hin, dass Sie nicht die erforderlichen IAM-Rollen haben, um einen Beobachtbarkeits-Bucket neu bereitzustellen.

Bitten Sie einen Administrator, Ihnen die IAM-Rollen zu gewähren, die im Abschnitt Hinweise dieses Dokuments aufgeführt sind, um diesen Fehler zu beheben.

Fehlerbehebung

In diesem Abschnitt wird beschrieben, wie Sie häufige Probleme beheben und Fragen beantworten, die nach der erneuten Bereitstellung eines Observability-Buckets auftreten können.

Woher weiß ich, ob ein Bucket neu bereitgestellt wurde?

Fragen Sie Ihre Audit-Logs ab und filtern Sie die Logeinträge nach dem Lognamen, dem Dienst und der Methode. Weitere Informationen finden Sie im Abschnitt Prüfung dieses Dokuments.

Warum sind in meinem Projekt zwei Buckets für Trace-Daten aufgeführt?

Während der erneuten Bereitstellung des _Trace-Beobachtbarkeits-Buckets muss das System möglicherweise einen neuen Bucket erstellen. Wenn dies der Fall ist, enthält Ihr Projekt während des Reprovisionierungsvorgangs zwei Beobachtbarkeits-Buckets mit dem Namen _Trace.

Sie müssen nichts weiter tun.

Wenn das System im Rahmen eines Reprovisionierungsvorgangs einen Beobachtbarkeits-Bucket erstellt hat, wird der Bucket, der das Ziel des Vorgangs war, nach erfolgreichem Abschluss des Vorgangs gelöscht. Wenn der Vorgang zur erneuten Bereitstellung fehlschlägt, wird der neue Bucket gelöscht.

Warum unterscheiden sich meine abgefragten Daten nach der erneuten Bereitstellung?

Bei einer erneuten Bereitstellung werden alle Daten gelöscht, die vor dem Start des Vorgangs gespeichert wurden. Diese Daten können nicht wiederhergestellt werden.

Warum werden im Trace Explorer nach der erneuten Bereitstellung keine Daten angezeigt?

Der Trace Explorer verwendet den Cache, um die Leistung zu verbessern. Der Cache ist an den abgefragten Beobachtbarkeits-Bucket gebunden. Wenn dieser Bucket zum Zeitpunkt einer Abfrage nicht verfügbar ist, schlägt die Abfrage fehl.

Während einer erneuten Bereitstellung kann Ihr Google Cloud -Projekt zwei Beobachtbarkeits-Buckets mit dem Namen _Trace enthalten. Wenn dieser Vorgang abgeschlossen ist, wird einer dieser Buckets gelöscht. In diesem Szenario kann der Cache, den der Trace Explorer verwendet, an einen Bucket gebunden sein, der nicht mehr existiert.

Dieser Fehler wird nach Ablauf des Cache-Timeouts automatisch behoben. Dies dauert etwa 10 Minuten.

Warum kann mein Beobachtbarkeits-Bucket nicht neu bereitgestellt werden?

Wenn ein Reprovisionierungsvorgang mit dem Status FAILED_PRECONDITION fehlschlägt, ist der Ziel-Bucket für die Beobachtbarkeit nicht für die Reprovisionierung geeignet. Im Folgenden sind einige Gründe aufgeführt, warum ein Bucket nicht für die erneute Bereitstellung infrage kommt:

  • Der Beobachtbarkeits-Bucket heißt nicht _Trace.
  • Die Anzahl der Bereitstellungen des Beobachtbarkeits-Buckets ist größer als eins. Sie können Ihre Audit-Logs abfragen, um festzustellen, ob der Bucket neu bereitgestellt wurde.
  • Die Standardeinstellungen für Beobachtbarkeits-Buckets wurden nicht gefunden. Konfigurieren Sie die Standardeinstellungen für Beobachtbarkeits-Buckets und wiederholen Sie den Befehl, um diesen Fehler zu beheben.
  • Die Konfiguration des Beobachtbarkeits-Buckets entspricht den Standardeinstellungen. Das bedeutet, dass der Vorgang zur erneuten Bereitstellung die Konfiguration des Beobachtbarkeits-Buckets nicht ändert.
  • Damit die Standardeinstellungen eingehalten werden, müsste das System den CMEK durch eine von Google verwaltete Verschlüsselung ersetzen. Diese Aktion wird nicht unterstützt.