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>
<StatisticsCollector> ö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 Optionally, use the |
N/A | Required |
continueOnError |
Set to Set to |
false | Optional |
enabled |
Set to Set to |
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 |
---|---|
Presence | Optional |
Type | String |
<Statistics>/<Statistic> öğ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.
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 . |
build |
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 . |
build |
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. |
build |
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: