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 Kolektor Statistik akan menulis nilai kedua variabel ini ke server analisis.

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

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

Mengakses statistik

Dalam contoh ini, Anda menggunakan Edge management API untuk melihat data statistik untuk koleksi bernama productID. Permintaan ini membuat laporan kustom untuk ID produk berdasarkan jumlah pesan yang dikirimkan bagi setiap ID produk setiap hari. Ganti nama organisasi Anda dengan variabel {org_name}, dan ganti email dan sandi untuk akun Anda di Apigee Edge dengan email:password.

Tetapkan parameter timeRange untuk menyertakan interval waktu saat data Anda dikumpulkan. Secara default, data yang lebih lama dari enam bulan dari 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, kolom name berisi ID dan nilai produk menampilkan jumlah permintaan 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 pengumpulan

<?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 Kolektor Statistik mewajibkan data yang dikumpulkan disimpan dalam variabel. Variabel ini dapat ditentukan 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 menuliskannya ke variabel bernama weather.location
• Mengekstrak kondisi saat ini dan menuliskannya ke variabel bernama weather.condition

Selanjutnya, Anda dapat menggunakan kebijakan Kolektor Statistik 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 Kolektor Statistik, lihat Menganalisis konten pesan API menggunakan analisis kustom.