Kebijakan StatisticsCollector

Contoh dasar

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

Dalam contoh ini, Anda mengumpulkan informasi statistik tentang dua variabel kustom: product.id dan product.price. Pada setiap permintaan, Kebijakan Statistics Collector menuliskan nilai kedua variabel ini ke analisis server tertentu.

Contoh ini juga menetapkan nilai default opsional untuk setiap variabel, dengan nilai default nilai product.id adalah 999999 dan atribut product.price default adalah 0. Jika variabel tidak ditentukan dan Anda tidak menetapkan nilai default, maka tidak ada data untuk variabel tersebut. Jika Anda menentukan nilai default, nilai defaultnya adalah dicatat ketika variabel tidak terdefinisi.

Setelah mengumpulkan data statistik, Anda dapat menggunakan API atau UI pengelolaan Edge untuk mengambil statistik. Saat mengambil statistik, Anda mereferensikan data yang dikumpulkan untuk variabel tersebut sebagai productID dan price.

Mengakses statistik

Dalam contoh ini, Anda menggunakan Edge management API untuk melihat data statistik untuk koleksi yang disebut productID. Permintaan ini membangun laporan kustom untuk ID produk berdasarkan jumlah pesan yang dikirim untuk setiap ID produk mereka. Ganti nama organisasi Anda untuk variabel {org_name}, dan mengganti email dan sandi akun Anda di Apigee Edge dengan email:password.

Tetapkan parameter timeRange untuk menyertakan interval waktu saat data Anda kumpulkan. Secara default, data yang sudah lebih dari enam bulan sejak tanggal saat ini tidak dapat diakses. Jika Anda ingin mengakses data yang lebih lama dari enam bulan, hubungi Dukungan 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

Dalam respons, name berisi ID produk dan nilai yang menunjukkan jumlah permintaan untuk setiap hari:

{
  "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"
  }
}

Mengekstrak data untuk koleksi

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

Kebijakan Statistics Collector mengharuskan data yang dikumpulkan disimpan dalam variabel. Variabel ini dapat ditetapkan sebelumnya oleh Apigee, atau variabel kustom yang Anda tentukan.

Dalam contoh ini, Anda menggunakan kebijakan Ekstrak Variabel untuk mengekstrak data dari payload XML yang berisi informasi cuaca. Kebijakan ini:

• Mengekstrak nama kota dan menulisnya ke variabel bernama weather.location
• Mengekstrak kondisi saat ini dan menulisnya ke variabel bernama weather.condition

Lalu, Anda dapat menggunakan kebijakan Statistics Collector untuk mengumpulkan informasi tentang variabel, seperti yang ditunjukkan di bawah ini:

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

Untuk tutorial lengkap yang menunjukkan cara mengekstrak data dari payload XML untuk Kebijakan Statistics Collector, lihat Analyze API konten pesan menggunakan analisis kustom.