StatsCollector 政策

基本示例

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="productID" ref="product.id" type="string">999999</Statistic>
    <Statistic name="price" ref="product.price" type="string">0</Statistic>
  </Statistics>
</StatisticsCollector>

在此示例中，您将收集有关以下两个自定义变量的统计信息：product.id 和 product.price。在每个请求中，统计信息收集器政策都会将这两个变量的值写入分析服务器。

本示例还为每个变量设置一个可选默认值，其中 product.id 的默认值为 999999，默认的 product.price 为 0。如果未定义某个变量，且未指定默认值，则系统不会为该变量记录任何数据。如果您指定默认值，则系统会在未定义变量时记录默认值。

收集统计数据后，您可以使用 Edge 管理界面或 API 检索统计信息。检索统计信息时，您需要将为这些变量收集的数据分别引用为 productID 和 price。

访问统计信息

在此示例中，您将使用 Edge Management API 查看名为 productID 的集合的统计数据。此请求会根据每天为每个产品 ID 提交的消息计数总和，生成产品 ID 的自定义报告。将 {org_name} 变量替换为您的组织名称，并将 email:password 替换成您在 Apigee Edge 上的帐号电子邮件地址和密码。

设置 timeRange 参数以包含收集数据的时间间隔。默认情况下，不可访问自当前日期起超过 6 个月的数据。如果您要访问六个月之前的数据，请与 Apigee Edge 支持团队联系。

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/environments/test/stats/productID?"select=sum(message_count)&timeRange=1/19/2015%2000:00~6/21/2015%2000:00&timeUnit=day"
-u email:password

在响应中，name 字段包含产品 ID，而值显示每天的请求数量：

{
  "environments" : [ {
    "dimensions" : [ {
      "metrics" : [ {
        "name" : "sum(message_count)",
        "values" : [ {
          "timestamp" : 1353369600000,
          "value" : "4.0"
        } ]
      } ],
      "name" : "52"
    }, {
      "metrics" : [ {
        "name" : "sum(message_count)",
        "values" : [ {
          "timestamp" : 1353369600000,
          "value" : "19.0"
        } ]
      } ],
      "name" : "14"
    }, ...
  } ],
  "metaData" : {
    "samplingRate" : "100"
  }
}

正在提取数据以进行收集

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="GetWeatherData">
    <VariablePrefix>weather</VariablePrefix>
    <XMLPayload>
       <Namespaces>
          <Namespace prefix="yweather">http://xml.weather.yahoo.com/ns/rss/1.0</Namespace>
       </Namespaces>
       <Variable name="location" type="string">
          <XPath>/rss/channel/yweather:location/@city</XPath>
       </Variable>
       <Variable name="condition" type="string">
          <XPath>/rss/channel/item/yweather:condition/@text</XPath>
       </Variable>
    </XMLPayload>
</ExtractVariables>

统计信息收集器政策要求将收集的数据存储在变量中。 这些变量可以由 Apigee 预定义，也可以由您定义的自定义变量。

在此示例中，您将使用“提取变量”政策从包含天气信息的 XML 载荷中提取数据。本政策的目的：

• 提取城市名称并将其写入名为 weather.location 的变量
• 提取当前条件并将其写入名为 weather.condition 的变量

然后，您可以使用统计信息收集器政策来收集有关变量的信息，如下所示：

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="weatherLocation" ref="weather.location" type="string"></Statistic>
    <Statistic name="weatherCondition" ref="weather.condition" type="string"></Statistic>
  </Statistics>
</StatisticsCollector>

如需查看完整教程，了解如何针对 Stats Collector 政策从 XML 载荷中提取数据，请参阅使用自定义分析来分析 API 消息内容。