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">
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ı. İsteğe bağlı olarak, politikayı |
Yok | Zorunlu |
continueOnError |
Bir politika başarısız olduğunda hata döndürmesi için Akış yürütmenin bir politikadan sonra bile devam etmesi için |
false | İsteğe bağlı |
enabled |
Politikayı uygulamak için Politikayı devre dışı bırakmak için |
true | İsteğe bağlı |
async |
Bu özelliğin desteği sonlandırıldı. |
false | Kullanımdan kaldırıldı |
<DisplayName> öğ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 |
---|---|
Varlık | İsteğe bağlı |
Tür | Dize |
<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ı
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 . |
build |
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. |
build |
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. |
build |
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: