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。在每個要求中， 統計資料收集器政策會將這兩個變數的值寫入 Analytics 伺服器

本例也會為每個變數設定選用的預設值，其中預設的 product.id 的值為 999999 和預設的 product.price 0。如果變數未定義，且未指定預設值，就不會有資料 變數的個別記錄如果您指定預設值，則預設值為 就會記錄下來。

收集統計資料後，您可以使用 Edge 管理 UI 或 API 擷取統計資料。擷取統計資料時，您會參照 將這些變數當做 productID 和 price。

存取統計資料

在本範例中，您會使用 Edge Management API 查看 名為「productID」的集合。這項請求會為 依據各個產品 ID 提交的訊息總數總和 當天。請將 {org_name} 變數換成您的機構名稱，並且 將您在 Apigee Edge 上的帳戶密碼替換成 email:password。

設定 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 的變數

然後您可以使用 Stats Collector 政策來收集 變數，如下所示：

<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 自訂數據分析訊息內容