İstatistiklerToplayıcı politikası

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Ne?

Bir mesajdaki verilerle ilgili istatistikleri (ör. ürün kimliği, fiyat, REST işlemi, istemci ve hedef URL, mesaj uzunluğu) toplamanıza olanak tanır. Veriler, Apigee tarafından önceden tanımlanmış akış değişkenlerinden veya sizin tanımladığınız özel değişkenlerden gelebilir.

İstatistik verileri, istatistikleri analiz eden ve raporlar oluşturan analiz sunucusuna aktarılır. Raporları Edge yönetim kullanıcı arayüzünü veya Edge API'yi kullanarak görüntüleyebilirsiniz.

Örnekler

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

$ 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

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

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

İstatistik Toplayıcı Politikası hakkında

İşleme alındığında, İstatistik Toplayıcı politikası bir veya daha fazla değişkenin geçerli değerini kaydeder. Bu değişkenler, Apigee tarafından önceden tanımlanmış akış değişkenleri veya sizin tanımladığınız özel değişkenler olabilir. Bu veriler Edge Analytics sunucusuna yazılır.

Politika tarafından toplanan istatistiksel verilere erişmek için Edge API'yi veya Edge yönetim kullanıcı arayüzünü kullanırsınız. Örneğin, toplanan verileri çeşitli biçimlerde gösteren özel bir rapor oluşturmak için Edge yönetim kullanıcı arayüzünü kullanabilirsiniz.

İstatistik Toplayıcı politikasının kullanıldığı eksiksiz bir eğitim için Özel analizler kullanarak API mesajı içeriğini analiz etme başlıklı makaleyi inceleyin.

Politika nereye yerleştirilir?

Bir API proxy'sinin istek veya yanıt akışına bir İstatistik Toplayıcı politikası yerleştirebilirsiniz. Ancak bir proxy'ye birden fazla İstatistik Toplayıcı politikası yerleştirirseniz son çalıştırılan politika, analiz sunucusuna yazılan verileri belirler ve önceki İstatistik Toplayıcı politikaları tarafından yazılan veriler kaybolur.

Bir API proxy'sinde birden fazla Statistics Collector politikasına sahip olabileceğiniz bir senaryo, istek veya yanıt akışında bir tane, hata işleyicide ise başka bir tane olduğunda ortaya çıkar. API proxy'sinde bir hata oluşursa hata işleyicideki İstatistik Toplayıcı, toplanan verileri belirler. Bu istatistik toplayıcıyı, arızayla ilgili bilgileri veya gerekli olduğunu düşündüğünüz diğer bilgileri kaydetmek için kullanabilirsiniz. Hata işleyicideki İstatistik Toplayıcı, istek/yanıttaki İstatistik Toplayıcı'nın daha önce yürütülüp yürütülmediğine bakılmaksızın toplanan verileri belirler.

Daha fazla bilgi için Hataları ele alma başlıklı makaleyi inceleyin.

Öğe referansı

Öğe referansı, İstatistik Toplayıcı politikasının öğelerini ve özelliklerini açıklar.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Statistics-Collector-1">
    <DisplayName>Statistics Collector 1</DisplayName>
    <Statistics>
        <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
    </Statistics>
</StatisticsCollector>

<StatisticsCollector> özellikleri

<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Stats-1">

Aşağıdaki tabloda tüm politika üst öğelerinde ortak olan özellikler açıklanmaktadır:

&lt;DisplayName&gt; öğe

Politikayı name özelliğine ek olarak farklı bir doğal dil adına sahip yönetim arayüzü proxy düzenleyicisi.

<DisplayName>Policy Display Name</DisplayName>

<Statistics>/<Statistic> öğesi

<Statistics>
    <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
</Statistics>

Hata referansı

Bu bölümde, bu politika bir hatayı tetiklediğinde ayarlanan hata mesajları ve akış değişkenleri açıklanmaktadır. Bir proxy için hata kuralları geliştiriyorsanız bu bilgileri bilmeniz önemlidir. Daha fazla bilgi edinmek için Politika hataları hakkında bilmeniz gerekenler ve Hataları ele alma başlıklı makaleleri inceleyin.

Çalışma zamanı hataları

Yok.

Dağıtım hataları

Hata değişkenleri

Yok.

Şema

Her politika türü bir XML şeması (.xsd) ile tanımlanır. Referans olarak politika şemaları GitHub'da mevcuttur.

İlgili konular

Daha fazla bilgi için aşağıdaki sayfaları inceleyin:

• Özel analizler kullanarak API mesajı içeriğini analiz etme
• Özel raporları yönetme
• API programı performansını ölçmek için metrik API'lerini kullanma