Memperbaiki persyaratan residensi data dan CMEK

Anda dapat menyediakan ulang bucket kemampuan observasi untuk memenuhi persyaratan peraturan enkripsi dan residensi data. Setelah penyediaan ulang, lokasi penyimpanan dan konfigurasi enkripsi bucket _Trace akan cocok dengan setelan default Anda untuk bucket kemampuan observasi.

Untuk menyediakan ulang bucket, konfigurasikan setelan default Anda, lalu panggil metode penyediaan ulang. Operasi penyediaan ulang dapat melakukan salah satu hal berikut:

  • Terapkan kunci Cloud Key Management Service secara retroaktif ke bucket kemampuan observasi tanpa mengubah lokasi penyimpanannya.
  • Mengubah lokasi penyimpanan bucket kemampuan observasi dan menggunakan enkripsi default Google.
  • Mengubah lokasi penyimpanan bucket kemampuan observasi dan menggunakan kunci Cloud KMS untuk mengenkripsi data yang disimpan.

Jangan sediakan ulang bucket kemampuan observasi jika Anda ingin mengubah nama tampilan, deskripsi, atau kunci Cloud KMS-nya. Untuk kasus tersebut, perbarui bucket kemampuan observasi.

Cara kerja penyediaan ulang

Saat Anda memulai operasi penyediaan ulang, sistem akan melakukan langkah-langkah berikut:

  1. Sistem akan menentukan apakah bucket kemampuan observasi memenuhi syarat untuk penyediaan ulang. Bucket kemampuan observasi memenuhi syarat jika semua pemeriksaan berikut lulus:

    • Bucket kemampuan observasi diberi nama _Trace.
    • Bucket belum disediakan ulang.
    • Setelan default untuk bucket kemampuan observasi ditemukan.
    • Agar sesuai dengan setelan default, lokasi bucket kemampuan observasi perlu diubah atau enkripsi harus diubah dari enkripsi berstandar Google ke CMEK.

  2. Sistem akan mengupdate konfigurasi bucket. Proses ini memerlukan waktu empat hingga lima jam.

Batasan

Batasan berikut berlaku:

  • Sistem mengizinkan maksimal satu operasi penyediaan ulang per bucket kemampuan observasi. Permintaan berikutnya akan gagal dengan error FAILED_PRECONDITION.

  • Anda hanya dapat menyediakan ulang bucket bernama _Trace.

  • Anda tidak dapat mengakses data apa pun yang disimpan sebelum penyediaan ulang dimulai. Data ini telah dihapus dan tidak dapat dipulihkan.

  • Jika lokasi bucket berubah, link dan set data BigQuery yang ditautkan akan dihapus. Anda harus membuat ulang link apa pun.

  • Jika lokasi bucket berubah, Anda harus memperbarui tampilan analisis yang ada secara manual.

  • Anda tidak dapat membatalkan atau mengurungkan operasi penyediaan ulang. Upaya untuk membatalkan operasi akan diabaikan.

  • Perilaku kueri selama operasi penyediaan ulang tidak ditentukan.

Pengauditan

Untuk menentukan histori penyediaan ulang bucket kemampuan observasi, Anda dapat menggunakan log audit. Log Aktivitas Admin mencatat siapa yang membuat permintaan penyediaan ulang, bucket kemampuan observasi yang terpengaruh, dan respons awal.

Untuk menemukan data ini, terapkan filter berikut di Logs Explorer:

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"

Contoh parsial berikut menunjukkan log audit Aktivitas Admin:

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

Sebelum memulai

  1. Tinjau Batasan.

  2. Untuk mendapatkan izin yang diperlukan untuk menyediakan ulang bucket kemampuan observasi, minta administrator untuk memberi Anda peran IAM Observability Editor (roles/observability.editor) pada project yang menghosting bucket kemampuan observasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

    Peran Observability Editor memberikan izin untuk membuat dan menghapus bucket kemampuan observasi, set data kemampuan observasi, dan link pada set data. Anda memerlukan izin ini karena operasi penyediaan ulang mengeluarkan perintah buat dan hapus.

    Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Menyediakan ulang bucket kemampuan observasi

Untuk menyediakan ulang bucket kemampuan observasi, lakukan langkah-langkah berikut:

  1. Mengonfigurasi setelan default untuk bucket kemampuan observasi
  2. Menyediakan ulang bucket
  3. Memantau progres
  4. Membuat link dan memperbarui tampilan analisis secara manual

Mengonfigurasi setelan default untuk bucket kemampuan observasi

Tetapkan lokasi penyimpanan default dan tetapkan kunci Cloud KMS default (opsional). Anda dapat menetapkannya di level project, folder, atau organisasi. Misalnya, jika Anda mengonfigurasi setelan default untuk folder, turunan folder tersebut akan menggunakan setelan tersebut, kecuali jika turunan juga memiliki setelan default yang dikonfigurasi.

Untuk mengetahui informasi selengkapnya tentang cara melihat dan mengonfigurasi setelan default, lihat Menetapkan setelan default untuk bucket kemampuan observasi.

Menyediakan ulang bucket

Gunakan skrip yang mengeluarkan permintaan penyediaan ulang secara asinkron dan lakukan polling untuk menentukan kapan operasi penyediaan ulang selesai. Untuk menyediakan ulang bucket kemampuan observasi, gunakan metode projects.locations.buckets.reprovision.

Anda harus menentukan nama bucket kemampuan observasi, yang memiliki format berikut:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

Responsnya adalah objek Operation. Kolom Operation.done memberikan informasi progres:

  • done adalah false: Operasi sedang berlangsung. Untuk mengetahui informasi tentang polling operasi, lihat Memantau progres.

  • done adalah true: Operasi selesai dan kolom error atau response ditetapkan:

    • response ditetapkan: Menunjukkan keberhasilan penyelesaian operasi asinkron. Nilai ini mencerminkan status terbaru bucket kemampuan observasi yang menjadi target penyediaan ulang.

    • error ditetapkan: Menunjukkan bahwa operasi asinkron gagal. Nilai kolom ini adalah objek Status yang berisi kode error gRPC dan pesan error. Untuk mengetahui informasi tentang pesan error umum, lihat Pesan error.

Penyediaan ulang biasanya memerlukan waktu empat hingga lima jam untuk diselesaikan.

Memantau progres

Objek Operation berisi informasi progres. Lakukan polling operasi hingga nilai kolom Operation.done adalah true. Kemudian, Anda dapat menggunakan kolom Operation.response dan Operation.error untuk menentukan apakah penyediaan ulang berhasil atau gagal.

Untuk melakukan polling Operation, gunakan metode folders.locations.operations.get.

Tetapkan parameter jalur ke nama operasi:

operations/UNIQUE_ID

Kolom UNIQUE_ID adalah ID unik operasi.

Responsnya adalah objek Operation yang diperbarui.

Jika aplikasi Anda menerima respons HTTP 503 / UNAVAILABLE saat melakukan polling, terapkan backoff eksponensial dan coba lagi permintaan tersebut. Error ini menunjukkan bahwa permintaan gagal di lapisan transport atau jaringan.

Membuat link dan memperbarui tampilan analisis secara manual

Setelah operasi penyediaan ulang selesai, buat ulang link dan perbarui tampilan analisis Anda.

Misalnya, Anda dapat melakukan hal berikut:

  1. Mencantumkan link di set data kemampuan observasi. Dalam beberapa skenario, operasi penyediaan ulang mempertahankan link. Untuk mengetahui informasi tentang langkah ini, lihat Mencantumkan link pada set data.

  2. Buat ulang set data BigQuery yang ditautkan. Untuk mengetahui informasi tentang langkah ini, lihat Membuat link di set data.

  3. Tinjau tampilan analisis Anda dan perbarui jalur ke bucket kemampuan observasi seperlunya.

Pesan error

Bagian ini mencantumkan kode error umum dan, jika ada, tindakan pemulihan.

FAILED_PRECONDITION

Pesan error FAILED_PRECONDITION menunjukkan bahwa bucket kemampuan observasi tidak memenuhi syarat untuk penyediaan ulang.

Contoh pesan error:

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

Tidak ada tindakan yang dapat Anda lakukan untuk membuat bucket kemampuan observasi memenuhi syarat untuk penyediaan ulang.

INVALID_ARGUMENT

Pesan error INVALID_ARGUMENT menunjukkan bahwa lokasi bucket kemampuan observasi dan konfigurasi CMEK konsisten dengan setelan default untuk bucket kemampuan observasi.

Untuk mengatasi kegagalan ini, perbarui setelan default untuk bucket kemampuan observasi untuk project, folder, atau organisasi, lalu coba lagi penyediaan ulang bucket kemampuan observasi.

PERMISSION_DENIED

Pesan error PERMISSION_DENIED menunjukkan bahwa Anda tidak memiliki peran IAM yang diperlukan untuk menyediakan ulang bucket kemampuan observasi.

Untuk mengatasi kegagalan ini, minta administrator memberi Anda peran IAM yang tercantum di bagian Sebelum memulai dalam dokumen ini.

Pemecahan masalah

Bagian ini menjelaskan cara menyelesaikan masalah umum dan menjawab pertanyaan yang mungkin muncul setelah Anda menyediakan ulang bucket kemampuan observasi.

Bagaimana cara mengetahui apakah bucket telah disediakan ulang?

Buat kueri log audit Anda dan filter entri log berdasarkan nama log, layanan, dan metode. Untuk mengetahui informasi selengkapnya, lihat bagian dokumen ini yang berjudul Pengauditan.

Mengapa project saya mencantumkan dua bucket untuk data trace?

Selama penyediaan ulang bucket kemampuan observasi _Trace, sistem mungkin perlu membuat bucket baru. Jika benar, project Anda akan berisi dua bucket kemampuan observasi bernama _Trace selama operasi penyediaan ulang.

Anda tidak perlu mengambil tindakan apa pun.

Jika sistem membuat bucket kemampuan observasi sebagai bagian dari operasi penyediaan ulang, setelah operasi tersebut berhasil diselesaikan, bucket yang ditargetkan oleh operasi tersebut akan dihapus. Jika operasi penyediaan ulang gagal, bucket baru akan dihapus.

Mengapa data yang saya kueri berbeda setelah penyediaan ulang?

Operasi penyediaan ulang akan menghapus semua data yang disimpan sebelum operasi dimulai. Data ini tidak dapat dipulihkan.

Mengapa Trace Explorer tidak menampilkan data apa pun setelah penyediaan ulang?

Trace Explorer menggunakan cache untuk meningkatkan performa. Cache terkait dengan bucket kemampuan observasi yang sedang dikueri dan, yang terpenting, jika bucket tersebut tidak tersedia pada saat kueri, kueri akan gagal.

Selama operasi penyediaan ulang, project Google Cloud Anda mungkin berisi dua bucket kemampuan observasi bernama _Trace. Selanjutnya, setelah operasi tersebut selesai, salah satu bucket tersebut akan dihapus. Dalam skenario ini, cache yang digunakan Trace Explorer mungkin terkait dengan bucket yang sudah tidak ada.

Kegagalan ini akan memperbaiki dirinya sendiri setelah waktu tunggu cache habis, yang memerlukan waktu sekitar 10 menit.

Mengapa bucket kemampuan observasi saya tidak dapat disediakan ulang?

Jika operasi penyediaan ulang gagal dengan status FAILED_PRECONDITION, bucket kemampuan observasi yang ditargetkan tidak memenuhi syarat untuk penyediaan ulang. Berikut adalah beberapa alasan mengapa bucket tidak memenuhi syarat untuk penyediaan ulang:

  • Bucket kemampuan observasi tidak diberi nama _Trace.
  • Frekuensi bucket kemampuan observasi disediakan ulang melebihi satu. Anda dapat membuat kueri log audit untuk menentukan apakah bucket telah disediakan ulang.
  • Setelan default untuk bucket kemampuan observasi tidak ditemukan. Untuk mengatasi kegagalan ini, konfigurasikan setelan default untuk bucket kemampuan observasi, lalu coba lagi perintah tersebut.
  • Konfigurasi bucket kemampuan observasi sesuai dengan setelan default. Artinya, operasi penyediaan ulang tidak akan mengubah konfigurasi bucket kemampuan observasi.
  • Agar sesuai dengan setelan default, sistem harus mengganti CMEK dengan enkripsi yang dikelola Google. Tindakan ini tidak didukung.