Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

建立可觀測性 bucket

您可以在專案收到追蹤資料前，手動建立 _Trace 可觀測性 bucket，自訂儲存位置和客戶管理的加密金鑰 (CMEK) 設定。如果 Google Cloud 專案在值區存在前就擷取追蹤資料，Google Cloud Observability 會自動使用專案的可觀測性值區預設設定佈建值區。

如要瞭解 Google Cloud Observability 如何儲存資料，請參閱「儲存空間總覽」。

與機構政策互動

建立可觀測性 bucket 的要求會驗證指令參數是否符合機構政策。舉例來說，如果機構政策限制資源位置，則指定受限位置時，建立 bucket 的作業會失敗。

與可觀測性值區的預設設定互動

如果 Google Cloud Observability 因擷取資料而自動建立可觀測性 bucket，系統會使用適用於 bucket 父項資源的可觀測性 bucket 預設設定。這些預設設定可能是在父項或父項的階層式祖系中定義，並指定下列項目：

儲存位置。
用於儲存資料的 Cloud KMS 金鑰。

建立可觀測性值區時，必須指定位置。除非您在建立要求中明確指定其他金鑰，否則 Google Cloud Observability 會套用預設設定中定義的 Cloud KMS 金鑰。

如果適用的預設設定指定 Cloud KMS 金鑰，您就無法使用 Google 預設加密方式建立值區。如要使用 Google 預設加密，請確認預設設定中未設定任何 Cloud KMS 金鑰。

如要瞭解可觀測性值區的預設設定，請參閱「設定可觀測性值區的預設值」。

限制

相關限制如下：

您必須指定支援的收件地點。
BUCKET_ID 必須為 _Trace。
顯示名稱不得超過 100 個編碼位元組。
說明不得超過 1000 個編碼位元組。
資料會保存 30 天。您必須省略保留期限或設為 30。
如果您提供 Cloud KMS 金鑰，金鑰位置必須與可觀測性值區的父項位置完全相符。
您只能在 Google Cloud 專案中建立可觀測性值區。
一個 Google Cloud 專案最多只能有一個名為 _Trace 的可觀測性儲存空間。

事前準備

設定專案和 IAM 角色，然後選取要使用的介面。

設定專案和角色

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.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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

如要取得建立可觀測性 bucket 所需的權限，請要求管理員授予您專案的「可觀測性編輯者」 (roles/observability.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

設定介面

gcloud

安裝 Google Cloud CLI，然後使用聯合身分登入 gcloud CLI。登入後，執行下列指令來初始化 Google Cloud CLI：

gcloud init

REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

安裝 Google Cloud CLI，然後使用聯合身分登入 gcloud CLI。

詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

設定 Cloud KMS 金鑰

選用。如要建立觀測資料 bucket 並指定 Cloud KMS 金鑰，請按照下列步驟操作：

啟用 Cloud Key Management Service API。
啟用 API 時所需的角色
如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。
啟用 API
建立金鑰環和金鑰。

可觀測性 bucket 的位置必須與金鑰位置相符。
將 PROJECT_ID 替換為專案 ID，然後執行下列指令：
```
gcloud beta observability settings describe \
--location=global --project=PROJECT_ID
```
上述指令會檢查您是否已設定預設儲存位置。如果 Google Cloud Observability 服務帳戶不存在，系統也會建立該帳戶。該指令會輸出服務帳戶 ID。
將 Cloud KMS CryptoKey Encrypter/Decrypter 角色授予 Google Cloud Observability 服務帳戶。
```
gcloud kms keys add-iam-policy-binding \
--project=KMS_PROJECT_ID \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-observability. \
--role=roles/cloudkms.cryptoKeyEncrypterDecrypter \
--location=KMS_KEY_LOCATION \
--keyring=KMS_KEY_RING \
KMS_KEY_NAME
```
執行上述指令前，請先進行下列替換：
- KMS_PROJECT_ID：由專案名稱和隨機指派的數字組成的唯一英數字元 ID，用於執行 Cloud KMS 的專案。 Google Cloud Google Cloud 如要瞭解如何取得這個 ID，請參閱「識別專案」。
- service-PROJECT_NUMBER：上一個步驟的回應中列出的 Observability 服務帳戶名稱。
- KMS_KEY_LOCATION：Cloud KMS 金鑰的區域。
- KMS_KEY_RING：Cloud KMS 金鑰環的名稱。
- KMS_KEY_NAME： Cloud KMS 金鑰的名稱。格式如下： projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY。