Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione
Documentazione di Apigee X. Informazioni
Cosa
Consente di raccogliere le statistiche relative ai dati di un messaggio, ad esempio ID prodotto, prezzo, REST l'azione, l'URL del client e di destinazione e la lunghezza del messaggio. I dati possono provenire da variabili di flusso predefinite da Apigee o variabili personalizzate da te definite.
I dati statistici vengono trasmessi al server di analisi, che li analizza e genera report. Puoi visualizzare i report utilizzando l'interfaccia utente di gestione perimetrale o l'API Edge.
Esempi
Esempio di base
<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>
In questo esempio, vengono raccolte informazioni statistiche su due variabili personalizzate: product.id e product.price. A ogni richiesta, Il criterio del raccoglitore delle statistiche scrive il valore di queste due variabili nell'analisi server web.
Questo esempio imposta anche un valore predefinito facoltativo per ogni variabile, dove il valore predefinito Il valore di product.id è 999999 e il valore predefinito di product.price è 0. Se una variabile non è definita e non specifichi un valore predefinito, nessun dato sarà registrati per la variabile. Se specifichi un valore predefinito, questo è vengono registrate quando la variabile non è definita.
Dopo aver raccolto i dati statistici, puoi utilizzare l'interfaccia utente o l'API di gestione perimetrale per recuperare le statistiche. Quando recuperi le statistiche, fai riferimento ai dati raccolti queste variabili come productID e price, rispettivamente.
Accesso alle statistiche
In questo esempio viene utilizzata l'API di gestione Edge per visualizzare i dati statistici per
raccolta chiamata productID
. Questa richiesta crea un report personalizzato per
ID prodotto basati sulla somma dei conteggi dei messaggi inviati per ciascun ID prodotto per ogni
giorno. Sostituisci il nome della tua organizzazione con la variabile {org_name}
e
sostituire l'indirizzo email e la password del tuo account su Apigee Edge
email:password
.
Imposta il parametro timeRange
per includere l'intervallo di tempo in cui i dati sono stati
raccolte. I dati più vecchi di sei mesi dalla data corrente non sono accessibili per impostazione predefinita. Se
Se vuoi accedere a dati più vecchi di sei mesi, contatta l'assistenza Apigee Edge.
$ 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
Nella risposta, il campo name contiene l'ID prodotto e il valore indica il numero di richieste per ogni giorno:
{ "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" } }
Estrazione dei dati per la raccolta
<?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>
Il criterio del raccoglitore delle statistiche richiede che i dati raccolti siano archiviati in variabili. Queste variabili possono essere predefinite da Apigee oppure variabili personalizzate da te definite.
In questo esempio, viene utilizzato il criterio Estrai variabili per estrarre i dati da un payload XML. contenenti informazioni meteo. Queste norme:
- Estrae il nome della città e lo scrive in una variabile denominata weather.location
- Estrae le condizioni attuali e le scrive in una variabile denominata weather.condition
In seguito, potrai utilizzare il criterio Raccoglitore delle statistiche per raccogliere informazioni sulla come mostrato di seguito:
<StatisticsCollector name="publishPurchaseDetails"> <Statistics> <Statistic name="weatherLocation" ref="weather.location" type="string"></Statistic> <Statistic name="weatherCondition" ref="weather.condition" type="string"></Statistic> </Statistics> </StatisticsCollector>
Per un tutorial completo che mostra come estrarre i dati da un payload XML per il Criterio di raccolta delle statistiche; consulta API Analyze dei messaggi utilizzando le analisi personalizzate.
Informazioni sul criterio di raccolta delle statistiche
Se eseguito, il criterio Raccoglitore delle statistiche registra il valore corrente di uno o più come la codifica one-hot delle variabili categoriche. Queste possono essere variabili di flusso predefinite da Apigee o variabili personalizzate che definisci. Questi dati vengono scritti nel server di analisi Edge.
Per accedere ai dati statistici raccolti dal criterio, puoi usare l'API Edge o Edge un'interfaccia utente di gestione. Ad esempio, puoi utilizzare l'interfaccia utente di gestione perimetrale per creare un report personalizzato mostra i dati raccolti in vari formati.
Per un tutorial completo sull'utilizzo del criterio Statistics Collector, vedi Analyze API dei messaggi utilizzando le analisi personalizzate.
Dove inserire il criterio
Puoi inserire un criterio del raccoglitore delle statistiche nel flusso di richiesta o risposta di un'API proxy. Tuttavia, se inserisci più criteri del raccoglitore delle statistiche in un proxy, l'ultimo criterio uno da eseguire determina i dati scritti al server di analisi e quelli scritti da I criteri precedenti della raccolta delle statistiche sono andati persi.
Uno scenario in cui potrebbero essere presenti più criteri del raccoglitore delle statistiche in un proxy API è quando ne hai uno nel flusso di richiesta o risposta e un altro in un gestore degli errori. Se si verifica un errore si verifica nel proxy API, il raccoglitore delle statistiche nel gestore degli errori determina i dati raccolte. L'utente può utilizzare il raccoglitore delle statistiche per registrare informazioni sul guasto o per registrare qualsiasi altra informazione che ritieni necessaria. Il raccoglitore delle statistiche è in errore determina i dati raccolti a prescindere dal fatto che l'elemento Statistics Collector nella richiesta/risposta già eseguita.
Per ulteriori informazioni, vedi Gestione di errore.
Riferimento elemento
Il riferimento agli elementi descrive gli elementi e gli attributi del raccoglitore delle statistiche .
<?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> attributi
<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Stats-1">
La tabella seguente descrive gli attributi comuni a tutti gli elementi principali del criterio:
Attributo | Descrizione | Predefinito | Presenza |
---|---|---|---|
name |
Il nome interno del criterio. Il valore dell'attributo Se vuoi, puoi utilizzare l'elemento |
N/D | Obbligatorio |
continueOnError |
Imposta il valore su Imposta su |
falso | Facoltativo |
enabled |
Imposta il valore su Imposta |
true | Facoltativo |
async |
Questo attributo è obsoleto. |
falso | Deprecato |
<DisplayName> elemento
Da utilizzare in aggiunta all'attributo name
per etichettare il criterio in
editor proxy della UI di gestione con un nome diverso e in linguaggio naturale.
<DisplayName>Policy Display Name</DisplayName>
Predefinito |
N/D Se ometti questo elemento, il valore dell'attributo |
---|---|
Presenza | Facoltativo |
Tipo | Stringa |
<Statistics>/<Statistic> elemento
<Statistics> <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic> </Statistics>
Attributo | Descrizione | Predefinito | Presenza |
---|---|---|---|
nome |
Il nome utilizzato per fare riferimento ai dati raccolti per la variabile specificata. Durante la visualizzazione
Analytics, utilizza questo nome per fare riferimento ai dati raccolti sulla variabile
specificato dal Se la variabile specificata da Limitazioni di denominazione Alle variabili di Analytics personalizzate si applicano le seguenti limitazioni di denominazione:
|
N/D | Obbligatorio |
riferimento |
La variabile di flusso per la quale vengono raccolte le statistiche. Questa variabile può essere un flusso variabile predefinita da Apigee o da una variabile personalizzata definita nel proxy API. L'attributo ref spesso fa riferimento a una variabile personalizzata definita dalla funzione Estrai variabili . Vedi Estrarre variabili per saperne di più. |
N/D | Obbligatorio |
tipo |
Specifica il tipo di dati della variabile specificata dall'attributo ref. I valori validi sono: string/integer/float/long/double/boolean. Per i dati di tipo stringa, fai riferimento ai dati statistici come Dimensione in un report personalizzato. Per i tipi di dati numerici (intero/float/long/doppio), fai riferimento al valore Dati statistici in un report personalizzato come Dimensione o Metrica. Per saperne di più, consulta Gestire i report personalizzati. Il valore di type può essere omesso solo se ref fa riferimento a una La variabile di flusso Apigee o il tipo viene dichiarato nel payload XML della funzionalità . |
stringa | Facoltativo |
Messaggi di errore
Questa sezione descrive i messaggi di errore e le variabili di flusso che vengono impostati quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se stai sviluppando regole di errore per un proxy. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.
Errori di runtime
Nessuna.
Errori di deployment
Nome errore | Causa | Correggi |
---|---|---|
UnsupportedDatatype |
Se il tipo di variabile specificato dall'attributo ref nell'elemento <Statistic> del criterio per la raccolta delle statistiche non è supportato, il deployment del proxy API non va a buon fine. I tipi di dati supportati sono string , integer ,
float , long , double e boolean . |
build |
InvalidName |
Se il nome utilizzato per fare riferimento ai dati raccolti per la variabile specificata definita all'interno dell'elemento <Statistic> del criterio del raccoglitore di statistiche è in conflitto con una variabile definita dal sistema, il deployment del proxy API non andrà a buon fine. Alcune delle variabili note definite dal sistema sono organization e environment . |
build |
DatatypeMissing |
Se il tipo di variabile specificato dall'attributo ref nell'elemento <Statistic> del criterio per la raccolta delle statistiche non è presente, il deployment del proxy API non riesce. |
build |
Variabili di errore
Nessuna.
Schema
Ogni tipo di criterio è definito da uno schema XML (.xsd
). Come riferimento, consulta gli schemi dei criteri
sono disponibili su GitHub.
Argomenti correlati
Per ulteriori informazioni, vedi: