İstatistiklerToplayıcı politikası

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

Ne

Bir mesaj içindeki veriler için ürün kimliği, fiyat, REST işlemi, istemci ile hedef URL ve mesaj uzunluğu gibi istatistikleri toplamanızı sağlar. 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.

Sana Özel

Temel örnek

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

Bu örnekte, iki özel değişken hakkında istatistiksel bilgiler topluyorsunuz: product.id ve product.price. İstatistik Toplayıcı politikası her istekte bu iki değişkenin değerini analiz sunucusuna yazar.

Bu örnekte, her değişken için isteğe bağlı bir varsayılan değer de ayarlanır. Burada varsayılan product.id değeri 999999, varsayılan product.price ise 0'dır. Değişken tanımlanmamışsa ve varsayılan değer belirtmezseniz değişken için veri kaydedilmez. Varsayılan bir değer belirtirseniz değişken tanımlanmamış olduğunda varsayılan değer kaydedilir.

İstatistiksel verileri topladıktan sonra, istatistikleri almak için Edge yönetim kullanıcı arayüzünü veya API'yi kullanabilirsiniz. İstatistikleri alırken bu değişkenler için toplanan verilere sırasıyla productID ve price olarak referans verirsiniz.

İstatistiklere erişim

Bu örnekte, productID adlı koleksiyonun istatistiksel verilerini görüntülemek için Edge Management API'yi kullanıyorsunuz. Bu istek, her gün için her ürün kimliği için gönderilen mesaj sayılarının toplamını temel alarak ürün kimliklerine yönelik özel bir rapor oluşturur. Kuruluşunuzun adını {org_name} değişkeniyle ve email:password yerine Apigee Edge'deki hesabınızın e-posta ve şifresini girin.

timeRange parametresini, verilerinizin toplandığı zaman aralığını içerecek şekilde ayarlayın. Varsayılan olarak, geçerli tarihten itibaren altı aydan daha eski verilere erişilemez. Altı aydan daha eski verilere erişmek istiyorsanız Apigee Edge Destek Ekibi ile iletişime geçin.

$ 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

Yanıttaki ad alanı ürün kimliğini içerir, değer ise her gün için istek sayısını gösterir:

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

Toplamak için verileri çıkarma

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

İstatistik Toplayıcı politikası, toplanan verilerin değişkenlerde depolanmasını gerektirir. Bu değişkenler, Apigee veya sizin tanımladığınız özel değişkenler tarafından önceden tanımlanmış olabilir.

Bu örnekte, hava durumu bilgilerini içeren bir XML yükünden veri ayıklamak için Değişkenleri Ayıkla politikasını kullanıyorsunuz. Bu politika:

  • Şehrin adını çıkarır ve weather.location adlı değişkene yazar.
  • Mevcut koşulları çıkarır ve weather.condition adlı değişkene yazar

Daha sonra, aşağıda gösterildiği gibi, değişkenler hakkında bilgi toplamak için İstatistik Toplayıcı politikasını kullanabilirsiniz:

<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ı için XML yükünden nasıl veri ayıklanacağını gösteren eksiksiz bir eğitim için Özel analizler kullanarak API mesajı içeriğini analiz etme bölümüne bakın.


İstatistik Toplayıcı politikası hakkında

Yürütüldüğünde, İ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 analiz sunucusuna yazılır.

Politika tarafından toplanan istatistik verilerine 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ığı kapsamlı bir eğitim için Özel analizler kullanarak API mesaj içeriğini analiz etme bölümüne bakın.

Politika nereye yerleştirilmelidir?

Bir API proxy'sinin istek veya yanıt akışına İstatistik Toplayıcı politikası yerleştirebilirsiniz. Ancak bir proxy'ye birden fazla İstatistik Toplayıcı politikası eklerseniz yürütülecek son politika, analiz sunucusuna yazılan verilerin ve önceki İstatistik Toplayıcı politikaları tarafından yazılan verilerin kaybolacağını belirler.

API proxy'sinde birden fazla İstatistik Toplayıcı politikasına sahip olabileceğiniz senaryolardan biri, istek veya yanıt akışında bir politika ve hata işleyicide başka bir politikanızın olmasıdır. API proxy'sinde hata oluşursa hata işleyicideki İstatistik Toplayıcı, toplanan verileri belirler. İstatistik Toplayıcıyı, hatayla ilgili bilgileri veya gerekli gördüğünüz diğer bilgileri kaydetmek için kullanabilirsiniz. Hata işleyicideki İstatistik Toplayıcı, istek/yanıttaki İstatistik Toplayıcının yürütülüp yürütülmediğine bakılmaksızın toplanan verileri belirler.

Daha fazla bilgi için Hataları işleme bölümüne bakın.

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

< StatsCollector> ö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:

Özellik Açıklama Varsayılan Varlık
name

Politikanın dahili adı. name özelliğinin değeri harf, sayı, boşluk, kısa çizgi, alt çizgi ve nokta içerebilir. Bu değer 255 karakterden uzun olamaz.

İsteğe bağlı olarak, politikayı yönetim kullanıcı arayüzü proxy düzenleyicisinde farklı bir doğal dil adıyla etiketlemek için <DisplayName> öğesini kullanın.

Yok Gerekli
continueOnError

Bir politika başarısız olduğunda hata döndürülmesi için false olarak ayarlayın. Bu, çoğu politika için beklenen davranıştır.

Bir politika başarısız olduktan sonra bile akış yürütülmesinin devam etmesi için true değerine ayarlayın.

false İsteğe bağlı
enabled

Politikayı uygulamak için true değerine ayarlayın.

Politikayı devre dışı bırakmak için false olarak ayarlayın. Bu politika, bir akışa bağlı kalsa bile uygulanmaz.

true İsteğe bağlı
async

Bu özellik kullanımdan kaldırıldı.

false Kullanımdan kaldırıldı

<DisplayName> öğesi

Politikayı, yönetim kullanıcı arayüzü proxy düzenleyicisinde farklı bir doğal dil adıyla etiketlemek için name özelliğine ek olarak kullanın.

<DisplayName>Policy Display Name</DisplayName>
Varsayılan

Yok

Bu öğeyi çıkarırsanız politikanın name özelliğinin değeri kullanılır.

Varlık İsteğe bağlı
Tür Dize

<İstatistik>/<İstatistik> öğesi

<Statistics>
    <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
</Statistics>
Özellik Açıklama Varsayılan Varlık
ad

Belirtilen değişken için toplanan verilere referans vermek üzere kullanılan ad. Analiz verilerini görüntülerken, ref özelliği tarafından belirtilen değişken hakkında toplanan verilere referans vermek için bu adı kullanın.

ref tarafından belirtilen değişken bir istekte veya yanıtta tanımlı değilse defaultStatValue, değişken için toplanan değeri belirtir. Varsayılan değeri çıkarırsanız değişken tanımlanmamışsa değişken için veri toplanmaz.

Adlandırma kısıtlamaları

Özel analiz değişkenleri için aşağıdaki adlandırma kısıtlamaları geçerlidir:

Yok Gerekli
referans

İstatistiklerini topladığınız akış değişkeni. Bu değişken, Apigee tarafından önceden tanımlanmış bir akış değişkeni veya API proxy'nizde tanımladığınız özel bir değişken olabilir.

ref özelliği genellikle Değişkenleri Ayıklama politikasında tanımlanan özelleştirilebilen değişkene referans verir. Daha fazla bilgi için Değişkenleri Ayıklama politikasını inceleyin.

Yok Gerekli
tür

ref özelliği tarafından belirtilen değişkenin veri türünü belirtir. Geçerli değerler: string/integer/float/long/double/boole.

Dize türündeki veriler için özel raporlarda istatistiksel verilere Boyut olarak referans verin. Sayısal veri türleri (tam sayı/kayan/uzun/çift) için özel bir rapordaki istatistiksel verilere Boyut veya Metrik olarak başvuruda bulunun. Daha fazla bilgi için Özel raporları yönetme başlıklı makaleye bakın.

type değeri yalnızca ref önceden tanımlanmış bir Apigee akış değişkenine işaret ediyorsa veya tür, Değişken Ayıklama politikasının XML yükünde belirtilmişse atlanabilir.

dize İsteğe bağlı

Hata referansı

Bu bölümde, bu politika bir hatayı tetiklediğinde ayarlanan hata mesajları ve akış değişkenleri açıklanmaktadır. Bu bilgiler, bir proxy için hata kuralları geliştirip geliştirmediğinizi bilmeniz önemlidir. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler ve Hataları işleme bölümlerine bakın.

Çalışma zamanı hataları

Yok.

Dağıtım hataları

Hata adı Neden Düzelt
UnsupportedDatatype İstatistik Toplayıcı politikasının <Statistic> öğesindeki ref özelliği tarafından belirtilen değişken türü desteklenmiyorsa API proxy'sinin dağıtımı başarısız olur. Desteklenen veri türleri şunlardır: string, integer, float, long, double ve boolean.
InvalidName İstatistik Toplayıcı politikasının <Statistic> öğesinde tanımlanan belirtilen değişken için toplanan verilere referans vermek üzere kullanılan ad, sistem tanımlı bir değişkenle çakışırsa API proxy'sinin dağıtımı başarısız olur. Bilinen sistem tanımlı değişkenlerden bazıları organization ve environment'dir.
DatatypeMissing İstatistik Toplayıcı politikasının <Statistic> öğesindeki ref özelliği tarafından belirtilen değişken türü eksikse API proxy'sinin dağıtımı başarısız olur.

Hata değişkenleri

Yok.

Şema

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

İlgili konular

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