管理資料收集器

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

資料收集器資源可讓您從 API 流量收集各種自訂資料。建立資料收集器後，請使用 DataCapture 政策指定要收集的資料。資料收集器就像購物車，而 DataCapture 政策則是購物清單，列出您想擷取的資料。

注意： 如果您在多項政策中使用資料收集器，系統會以最後執行的政策覆寫擷取的資料。

如需可使用資料收集器資源擷取的 API 流量相關數量清單，請參閱「指標」。

建立資料收集器

您可以在 Apigee UI 中或使用 Apigee API 建立資料收集器資源：

Cloud 控制台中的 Apigee

如要使用 Cloud 控制台中的 Apigee 建立資料收集器資源，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「管理」>「資料收集器」頁面。

   前往資料收集器

2. 在「資料收集器」檢視畫面中，按一下「建立」。
3. 在「新增資料收集器」對話方塊中，輸入下列資訊：
   • 名稱：資料收集器的名稱。
     注意：資料收集器的名稱必須以 dc_ 開頭。
     警告：請勿建立名稱只差在大小寫的兩個資料收集器，例如 dc_my_data 和 dc_My_Data，否則匯出資料時會發生「資料欄名稱重複」錯誤。
   • 類型：要收集的資料類型 (Integer、String 等)。
   • 說明：非正式說明要收集的資料，可能包括收集資料的原因。這項功能可讓其他參與資料分析的 API 開發人員受益。
4. 按一下「新增」。

傳統版 Apigee

如要使用 Classic Apigee 建立資料收集器資源，請按照下列步驟操作：

1. 在瀏覽器中開啟 Apigee 使用者介面。

2. 在導覽窗格中，依序選取「管理」>「資料收集器」。

   

   畫面會顯示「資料收集器」窗格。

   

   由於尚未建立任何資料收集器，因此上述窗格是空白的。此時，您可以建立新的資料收集器。建立一些資料收集器後，您可以在窗格中點按其名稱進行編輯。

3. 按一下「+ 建立」，系統會顯示「新增資料收集器」對話方塊。

   
4. 在對話方塊中新增下列資訊：
   • 名稱：資料收集器的名稱。
     注意：資料收集器的名稱必須以 dc_ 開頭。
     注意：請勿建立名稱只差大小寫的兩個資料收集器，例如 dc_my_data 和 dc_My_Data，否則匯出資料時會發生「重複的資料欄名稱」錯誤。
   • 類型：要收集的資料類型 (Integer、String 等)。
   • 說明：非正式地說明要收集的資料，可能包括收集資料的原因。這有助於其他可能參與資料分析的 API 開發人員。
5. 按一下「新增」。

新的資料收集器會顯示在「資料收集器」窗格中。

如要編輯或刪除資料收集器，請按一下「動作」下方資料列尾端的三點圖示，然後選取「編輯」或「刪除」。

Apigee API

您可以使用 Apigee API 建立 資料收集器資源。例如：

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -X POST -H "content-type:application/json" \
  -d '
{
  "name": "dc_data_collector",
  "description": "Collects data for analysis.",
  "type": "STRING",
}' \
  "https://apigee.googleapis.com/v1/organizations/ORG/datacollectors"

其中 ORG 是機構名稱。 這會建立名為 dc_data_collector 的資源，您可以在 DataCapture 政策中使用該資源。

注意：

• 資料收集器資源名稱開頭必須為前置字元「dc_」。
• 如果您在多項 DataCapture 政策中使用資料收集器，系統會以最後執行的政策覆寫擷取的資料。

警告：請勿建立名稱只差大小寫的兩個資料收集器，例如 dc_my_data 和 dc_My_Data，否則匯出資料時會發生「資料欄名稱重複」錯誤。