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

The following table describes attributes that are common to all policy parent elements:

Attribute Description Default Presence
name

The internal name of the policy. The value of the name attribute can contain letters, numbers, spaces, hyphens, underscores, and periods. This value cannot exceed 255 characters.

Optionally, use the <DisplayName> element to label the policy in the management UI proxy editor with a different, natural-language name.

N/A Required
continueOnError

Set to false to return an error when a policy fails. This is expected behavior for most policies.

Set to true to have flow execution continue even after a policy fails.

false Optional
enabled

Set to true to enforce the policy.

Set to false to turn off the policy. The policy will not be enforced even if it remains attached to a flow.

true Optional
async

This attribute is deprecated.

false Deprecated

<DisplayName> element

Use in addition to the name attribute to label the policy in the management UI proxy editor with a different, natural-language name.

<DisplayName>Policy Display Name</DisplayName>
Default

N/A

If you omit this element, the value of the policy's name attribute is used.

Presence Optional
Type String

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

This section describes the error messages and flow variables that are set when this policy triggers an error. This information is important to know if you are developing fault rules for a proxy. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

None.

Deployment errors

Error name Cause Fix
UnsupportedDatatype If the type of the variable specified by the ref attribute in the <Statistic> element of the Statistics Collector policy is unsupported, then the deployment of the API proxy fails. The supported data types are string, integer, float, long, double, and boolean.
InvalidName If the name used to reference the data collected for the specified variable defined within the <Statistic> element of the Statistics Collector policy conflicts with a system-defined variable, then the deployment of the API proxy fails. Some of the known system-defined variables are organization and environment.
DatatypeMissing If the type of the variable specified by the ref attribute in the <Statistic> element of the Statistics Collector policy is missing, then the deployment of the API proxy fails.

Fault variables

None.

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