管理数据收集器

本页面适用于 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 文档。

借助数据收集器资源，您可以从 API 流量收集各种自定义数据。创建数据收集器后，您可以使用 DataCapture 政策指定要收集的数据。数据收集器就像购物车，而 DataCapture 政策是您要捕获的数据的购物清单。

注意：如果您在多项政策中使用数据收集器，则执行的最后一项政策会覆盖所捕获的数据。

如需查看您可以使用数据收集器资源收集的 API 流量数量列表，请参阅指标。

创建数据收集器

您可以在 Apigee 界面中或使用 Apigee API 创建数据收集器资源：

注意：Apigee 界面有一个新版本，该版本与 Google Cloud 控制台集成。新界面称为 Cloud 控制台中的 Apigee。下文前两个标签页中的说明介绍了如何使用 Cloud 控制台中的 Apigee 或经典版 Apigee。

Cloud 控制台中的 Apigee

如需使用 Cloud 控制台中的 Apigee 创建数据收集器资源，请执行以下操作：

1. 在浏览器中打开 Cloud 控制台中的 Apigee 界面。
2. 在导航窗格中，选择管理 > 数据收集器。
3. 在数据收集器视图中，点击创建。
4. 点击 + 创建以显示添加数据收集器对话框。
5. 在对话框中添加以下信息：
   • 名称：数据收集器的名称。
     注意：数据收集器的名称必须以 dc_ 开头。
     警告：请勿创建名字只有大小写区别的数据收集器（例如 dc_my_data 和 dc_My_Data），因为之后导出数据将导致“重复的列名称”错误。
   • 类型：要收集的数据的类型（Integer、String 等）。
   • 说明：要收集的数据的非正式说明，可能包括收集数据的原因。这样做可能会让可能参与分析数据的其他 API 开发者受益。
6. 点击添加。

经典版 Apigee

如需使用经典版 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），因为之后导出数据将导致“重复的列名称”错误。