追蹤資料匯出作業總覽

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本頁面提供使用 Cloud Trace 匯出追蹤記錄資料的概念總覽。您可能會基於以下原因匯出追蹤記錄資料：

• 如要儲存追蹤記錄資料的時間超過預設的 30 天保留期限。

• 讓您使用 BigQuery 工具分析追蹤記錄資料。舉例來說，您可以使用 BigQuery 找出跨度計數和百分位數。如要瞭解用於產生下列表格的查詢，請參閱 HipsterShop 查詢。

  

匯出功能的運作方式

匯出作業包括為 Google Cloud 專案建立接收器。sink 會將 BigQuery 資料集定義為目的地。

您可以使用 Cloud Trace API 或 Google Cloud CLI 建立接收器。

接收器屬性與術語

Sink 是針對 Google Cloud 專案定義，並具有下列屬性：

• 名稱：接收器的名稱。例如：

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

  其中 PROJECT_NUMBER 是接收器的 Google Cloud 專案編號，my-sink 則是接收器 ID。

• 父項：您在其中建立接收器的資源。父項必須是 Google Cloud 專案：

  "projects/PROJECT_ID"
  

  PROJECT_ID 可以是 Google Cloud 專案 ID 或編號。

• 目的地：指定要傳送追蹤區間的單一位置。Trace 支援將追蹤記錄匯出至 BigQuery。目的地可以是接收器的 Google Cloud 專案，或同機構中的任何其他 Google Cloud 專案。

  舉例來說，有效的目的地如下：

  bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
  

  其中 DESTINATION_PROJECT_NUMBER 是目的地的Google Cloud 專案編號，而 DATASET_ID 是 BigQuery 資料集 ID。

• 寫入者身分：服務帳戶名稱。匯出目的地的擁有者必須為這個服務帳戶授予寫入到匯出目的地的權限。匯出追蹤記錄時，Trace 會採用這個身分進行授權。為了提高安全性，新接收器會取得專屬服務帳戶：

  export-PROJECT_NUMBER-GENERATED_VALUE@gcp-sa-cloud-trace.iam.gserviceaccount.com
  

  其中 PROJECT_NUMBER 是您的 Google Cloud 專案編號，以 16 進制表示，而 GENERATED_VALUE 則是隨機產生的值。

  您不會建立、擁有或管理由接收器的寫入者身分識別的服務帳戶。建立接收器時，Trace 會建立接收器所需的服務帳戶。這個服務帳戶必須至少有一個 Identity and Access Management 繫結，才會列入專案的服務帳戶清單。您可以在設定接收器目的地時新增此繫結。

  如要瞭解如何使用作者身分，請參閱目的地權限。

接收器的運作方式

每次追蹤區塊抵達專案時，追蹤功能就會匯出該區塊的副本。

Trace 在建立接收器之前收到的追蹤記錄無法匯出。

存取權控管

如要建立或修改接收器，您必須具備下列任一 Identity and Access Management 角色：

• Trace 管理員
• 追蹤使用者
• 專案擁有者
• 專案編輯者

詳情請參閱「存取權控管」。

如要將追蹤記錄匯出至目的地，接收器的寫入者服務帳戶必須具備寫入目的地的權限。如要進一步瞭解作者身分，請參閱本頁的「Sink 屬性」。

配額與限制

Cloud Trace 會利用 BigQuery 串流 API，將追蹤間隔傳送至目的地。Cloud Trace 會將 API 呼叫分批處理。Cloud Trace 不會實作重試或節流機制。如果資料量超出目的地配額，追蹤間距可能無法匯出。

如要詳細瞭解 BigQuery 配額和限制，請參閱「配額與限制」。

定價

匯出追蹤記錄不會產生 Cloud Trace 費用。不過，您可能會產生 BigQuery 費用。詳情請參閱 BigQuery 定價一文。

預估費用

BigQuery 會針對資料攝入和儲存收取費用。如要估算每個月的 BigQuery 費用，請按照下列步驟操作：

1. 預估一個月內擷取的追蹤記錄時距總數。

   如要瞭解如何查看用量，請參閱「依帳單帳戶查看用量」。

2. 根據已擷取的追蹤記錄時距數量，預估串流需求。

   每個區段都會寫入表格資料列。BigQuery 中的每個資料列至少需要 1024 個位元組。因此，BigQuery 串流要求的下限是為每個區段指派 1, 024 位元組。舉例來說，如果您的 Google Cloud專案擷取了 200 個區間，則這些區間至少需要 20,400 個位元組才能進行串流插入作業。

3. 您可以使用 Pricing Calculator 估算 BigQuery 的儲存空間、串流資料插入和查詢費用。

查看及管理 BigQuery 用量

您可以使用 Metrics Explorer 查看 BigQuery 用量。您也可以建立快訊政策，在 BigQuery 用量超過預先定義的限制時通知您。下表列出建立快訊政策的設定。建立圖表或使用 Metrics Explorer 時，您可以使用目標窗格表格中的設定。

如要建立快訊政策，以便在擷取的 BigQuery 指標超過使用者定義的等級時觸發通知，請使用下列設定。

建立快訊政策的步驟。

如要建立快訊政策，請按照下列指示操作：

1. 前往 Google Cloud 控制台的 notifications「Alerting」(警告) 頁面：

   前往「Alerting」(快訊)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 如果您尚未建立通知管道，但想收到通知，請按一下「Edit Notification Channels」(編輯通知管道)，然後新增通知管道。新增管道後，請返回「Alerting」頁面。
3. 在「Alerting」頁面中，選取「Create policy」。
4. 如要選取資源、指標和篩選器，請展開「Select a metric」選單，然後使用「New condition」表格中的值：
   1. 選用：如要將選單限制為相關項目，請在篩選列中輸入資源或指標名稱。
   2. 選取資源類型。例如選取「VM 執行個體」。
   3. 選取指標類別。例如選取「instance」。
   4. 選取指標。例如選取「CPU 使用率」。
   5. 選取 [Apply] (套用)。
5. 點選「Next」，然後設定快訊政策觸發條件。 如要填寫這些欄位，請使用「設定警示觸發條件」表格中的值。
6. 點按「Next」。

7. 選用步驟：如要新增通知至快訊政策，請按一下「通知管道」。在對話方塊中，從選單中選取一或多個通知管道，然後按一下「OK」。

   如要在事件開啟和關閉時收到通知，請勾選「Notify on incident closure」(事件關閉時通知)。根據預設，系統只會在事件開啟時傳送通知。

8. 選用：更新「Incident autoclose duration」。這個欄位會決定 Monitoring 在沒有指標資料時關閉事件的時間。
9. 選用步驟：按一下「說明文件」，然後輸入您希望在通知訊息中顯示的資訊。
10. 按一下「快訊名稱」，然後輸入快訊政策的名稱。
11. 點選「建立政策」。

新條件 欄位	值
資源和指標	在「資源」選單中，選取「BigQuery 資料集」。 在「指標類別」選單中，選取「儲存空間」。 在「指標」選單中選取指標。使用量專屬指標包括 Stored bytes、Uploaded bytes 和 Uploaded bytes billed。如需可用指標的完整清單，請參閱 BigQuery 指標。
篩選	project_id：您的 Google Cloud 專案 ID。 dataset_id：您的資料集 ID。
跨時間序列 時間序列分組依據	dataset_id：資料集 ID。
跨時間序列 時間序列匯總	sum
滾動週期	1 m
滾動週期函式	mean

設定快訊觸發條件 欄位	值
條件類型	Threshold
快訊觸發條件	Any time series violates
門檻位置	Above threshold
門檻值	由您定義可接受的值。
重新測試週期	1 minute

後續步驟

如要設定接收器，請參閱「匯出追蹤記錄」。