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。如果變數未定義，而且您未指定預設值，系統就不會針對該變數記錄任何資料。如果指定預設值，系統就會在未定義變數時記錄預設值。

收集統計資料後，您可以使用邊緣管理 UI 或 API 擷取統計資料。擷取統計資料時，請將這些變數收集的資料分別視為 productID 和 price。

存取統計資料

在此範例中，您會使用 Edge Management API 查看名為 productID 的集合統計資料。這項要求會根據每天針對每個產品 ID 提交的訊息數量總和，為產品 ID 建立自訂報表。將變數名稱換成 {org_name} 變數，並在 Apigee Edge 中用 email:password 取代您的帳戶電子郵件地址和密碼。

設定 timeRange 參數，加入系統收集資料的時間間隔。根據預設，系統無法提供目前日期之前六個月內的資料。如要在六個月內存取資料，請與 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>

如需教學課程，瞭解如何從「統計資料收集器」的 XML 酬載擷取資料，請參閱使用自訂分析來分析 API 訊息內容。