StatisticsCollector ポリシー

基本的な例

<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 という 2 つのカスタム変数に関する統計情報を収集します。リクエストごとに、Statistics Collector ポリシーがこの 2 つの変数の値を分析サーバーに書き込みます。

この例では、各変数のオプションのデフォルト値も設定します。ここで、product.id のデフォルト値は 999999、デフォルトの product.price は 0 です。変数が未定義で、デフォルト値を指定していない場合、データは変数に記録されません。変数が未定義で、デフォルト値を指定した場合、デフォルト値が記録されます。

統計情報データを収集したら、Edge 管理 UI または API を使用して統計を取得できます。統計情報を取得するときは、これらの変数について収集されたデータをそれぞれ productID と price として参照します。

統計にアクセスする

この例では、Edge Management API を使用して、productID というコレクションの統計情報データを表示します。このリクエストでは、各日の各プロダクト ID に対する送信メッセージ件数の合計に基づくプロダクト ID のカスタム レポートを作成します。変数 {org_name} を組織名に置き換え、Apigee Edge のアカウントのメールアドレスとパスワードを email:password に置き換えます。

timeRange パラメータを設定して、データが収集される時間間隔を含めます。デフォルトでは、現在の日付から 6 か月以上経過しているデータはアクセスできません。6 か月以上前のデータにアクセスするには、Apigee のサポートにお問い合わせください。

$ 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>

Statistics Collector ポリシーでは、収集したデータを変数に保存する必要があります。 データは、Apigee が事前に定義したフロー変数か、ユーザーのカスタム変数に保存されます。

この例では、Extract Variables ポリシーを使用して、気象情報を含む XML ペイロードからデータを抽出します。このポリシーでは次のことを行います。

• 都市の名前を抽出し、weather.location という名前の変数に書き込みます。
• 現在の条件を抽出し、weather.condition という名前の変数に書き込みます。

次のように Statistics 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 メッセージ コンテンツを分析するをご覧ください。