İstatistiklerToplayıcı politikası

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri.
bilgi

Ne?

Bir mesajdaki ürün kimliği, fiyat, REST gibi verilere ilişkin istatistikleri toplamanızı sağlar işlem, istemci ve hedef URL ve mesaj uzunluğu. Veriler, akış değişkenlerinden gelebilir Apigee veya sizin tanımladığınız özel değişkenler tarafından önceden tanımlanmıştır.

İstatistik verileri analiz sunucusuna iletilir. Bu sunucu da istatistikleri ve rapor oluşturur. Raporları Edge yönetim kullanıcı arayüzünü veya Edge API'yi kullanarak görüntüleyebilirsiniz.

Örnekler

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. Her istekte İstatistik Toplayıcı politikası, bu iki değişkenin değerini analize yazar sunucu.

Bu örnekte ayrıca, her değişken için isteğe bağlı bir varsayılan değer ayarlanır. Varsayılan değer product.id değeri 999999'dur ve varsayılan product.price 0'dır. Bir değişken tanımsızsa ve varsayılan değer belirtmezseniz hiçbir veri kaydedilmektedir. Varsayılan bir değer belirtirseniz varsayılan değer değişken tanımsız olduğunda kaydedilir.

İstatistiksel verileri topladıktan sonra Edge yönetim kullanıcı arayüzünü veya API'yi kullanabilirsiniz kullanabilirsiniz. İstatistikleri alırken, belirli bir müşteri için toplanan verilere başvurursunuz. bu değişkenlere productID ve price olarak gösterilir.

İstatistiklere erişme

Bu örnekte, productID adlı koleksiyon. Bu istek şunun için özel bir rapor oluşturur: Her bir ürün kimliği için gönderilen mesaj sayısının toplamını temel alan ürün kimlikleri değer. {org_name} değişkeni yerine kuruluşunuzun adını girin ve Apigee Edge'deki hesabınızın e-posta ve şifresini email:password.

timeRange parametresini, verilerinizin geçerli olduğu zaman aralığını içerecek şekilde ayarlayın toplanıyor. Geçerli tarihten itibaren altı aydan eski verilere varsayılan olarak erişilemez. Eğer Altı aydan 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 ve değer, her bir güne ilişkin 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"
  }
}

Toplama 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 tarafından veya sizin tanımladığınız özelleştirilebilen değişkenler tarafından önceden tanımlanmış olabilir.

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

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

Ardından, her kullanıcı için yararlı veriler toplamak üzere İstatistik Toplayıcı politikasını değişkenlerini aşağıda gösterildiği gibi bulabilirsiniz:

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

Dosya için XML yükünden nasıl veri çıkarılacağını gösteren İstatistik Toplayıcı politikası, bkz. Analiz API'sı mesaj içeriğini inceleyin.


İstatistik Toplayıcı politikası hakkında

Yürütüldüğünde, İstatistik Toplayıcı politikası bir veya daha fazla öğenin geçerli değerini kaydeder. değişkenlerine karşılık gelir. Bu değişkenler, Apigee tarafından önceden tanımlanmış akış değişkenleri veya her şeyi kapsıyor. Bu veriler, Edge analiz sunucusuna yazılır.

Politika tarafından toplanan istatistiksel verilere erişmek için Edge API veya Edge kullanırsınız yönetim arayüzü. Örneğin, uç nokta yönetimi kullanıcı arayüzünü kullanarak toplanan verileri çeşitli biçimlerde gösterir.

İstatistik Toplayıcı politikasını kullanan tam bir eğitim için bkz. Analiz API'sı mesaj içeriğini inceleyin.

Bu politika nereye uygulanmalıdır?

Bir API'nin istek veya yanıt akışına İstatistik Toplayıcı politikası yerleştirebilirsiniz temsil eder. Ancak, bir proxy'ye birden fazla İstatistik Toplayıcı politikası yerleştirirseniz son birini çalıştıracaksanız, analiz sunucusuna yazılan verileri ve herhangi bir sunucu tarafından yazılan verileri önceki İstatistik Toplayıcı politikaları kaybolur.

Bir API proxy'sinde birden fazla İstatistik Toplayıcı politikasına sahip olabileceğiniz bir senaryo: bulunacağından emin olun. Hata hata işleyicisindeki İstatistik Toplayıcısı verileri belirleyip toplanıyor. O İstatistik Toplayıcıyı kullanarak arıza hakkında bilgi kaydedebilir veya gerekli olduğunu düşündüğünüz diğer bilgileri de not edebilirsiniz. Hatadaki İstatistik Toplayıcısı işleyici, İstatistik Toplayıcısı'nın mevcut olup olmadığına bakılmadan toplanan verileri belirler zaten yürütülmüş olması gerekir.

Daha fazla bilgi için bkz. Kullanım hata ayıklaması gerekir.

Öğe referansı

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

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

&lt;StatisticsCollector&gt; özellikler

<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çermelidir. Bu değer, 255 karakteri aşmalıdır.

İsteğe bağlı olarak, politikayı<DisplayName> yönetim arayüzü proxy düzenleyicisinde farklı bir doğal dil adı kullanabilir.

Yok Zorunlu
continueOnError

Bir politika başarısız olduğunda hata döndürmesi için false olarak ayarlayın. Bu beklenen bir durumdur çoğu politika için geçerli olur.

Akış yürütmenin bir politikadan sonra bile devam etmesi için true olarak ayarlayın başarısız olur.

false İsteğe bağlı
enabled

Politikayı uygulamak için true olarak ayarlayın.

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

true İsteğe bağlı
async

Bu özelliğin desteği sonlandırıldı.

false Kullanımdan kaldırıldı

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

&lt;Statistics&gt;/&lt;Statistic&gt; öğe

<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 referansta bulunmak amacıyla kullanılan ad. Görüntülerken Analytics verileri varsa, değişken hakkında toplanan verilere referans vermek için bu adı kullanın. ref tarafından belirtilir özelliğini gönderin.

ref tarafından belirtilen değişken bir istekte tanımlanmamışsa veya yanıtıyla birlikte defaultStatValue, değeri belirtir toplanmasını sağlar. Varsayılan değeri çıkarırsanız değişkeni tanımlanamaz.

Adlandırma kısıtlamaları

Özel analiz değişkenlerine aşağıdaki adlandırma kısıtlamaları uygulanır:

Yok Zorunlu
referans

İstatistik topladığınız akış değişkeni. Bu değişken bir akış olabilir değişkeni veya API proxy'nizde tanımladığınız özel bir değişken tarafından tanımlanabilir.

ref özelliği genellikle Extract Değişkenleri tarafından tanımlanan bir özelleştirilebilen değişkeni politikası. Değişkenleri Ayıklama konusuna bakın politika hakkında daha fazla bilgi edinin.

Yok Zorunlu
tür

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

Dize türü verileri için istatistiksel verileri Boyut olarak özel rapor. Sayısal veri türleri (tam sayı/kayan/uzun/çift) için Özel bir rapordaki istatistiksel veriler Boyut veya Metrik olarak. Daha fazla bilgi için Özel raporları yönetme başlıklı makaleyi inceleyin.

type değeri yalnızca ref önceden tanımlanmış bir terime işaret ediyorsa atlanabilir Apigee akış değişkeni veya tür, Çıkarma Değişkenlerinin XML yükünde belirtilmiş politikası.

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ıyla (.xsd) tanımlanır. Referans olması amacıyla politika şemaları GitHub'da bulabilirsiniz.

İlgili konular

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