Norme di Statisticscollector

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, raccogli 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 nel server di analisi.

Questo esempio imposta anche un valore predefinito facoltativo per ogni variabile, dove il valore predefinito di product.id è 999999 e il valore predefinito di product.price è 0. Se una variabile non è definita e non specifichi un valore predefinito, per questa variabile non vengono registrati dati. Se specifichi un valore predefinito, quest'ultimo viene registrato 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 per queste variabili come productID e price, rispettivamente.

Accesso alle statistiche

In questo esempio, utilizzerai l'API Edge Management per visualizzare i dati statistici per la raccolta denominata productID. Questa richiesta crea un report personalizzato per gli ID prodotto in base alla somma del numero di messaggi inviato per ogni ID prodotto ogni giorno. Sostituisci il nome della tua organizzazione con la variabile {org_name} e l'indirizzo email e la password del tuo account su Apigee Edge con email:password.

Imposta il parametro timeRange per includere l'intervallo di tempo in cui sono stati raccolti i dati. Per impostazione predefinita, non sono accessibili dati che risalgono a più di sei mesi prima della data corrente. Se desideri accedere a dati risalenti a più di sei mesi fa, 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, mentre il valore mostra 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 vengano archiviati in variabili. Queste variabili possono essere predefinite da Apigee o variabili personalizzate da te definite.

In questo esempio, utilizzerai il criterio Estrai variabili per estrarre i dati da un payload XML che contiene informazioni meteo. Queste norme:

• Estrae il nome della città e lo scrive in una variabile denominata weather.location
• Estrae le condizioni correnti e le scrive in una variabile denominata weather.condition

Puoi quindi utilizzare il criterio del raccoglitore delle statistiche per raccogliere informazioni sulle variabili, 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 del raccoglitore delle statistiche, vedi Analizzare i contenuti dei messaggi dell'API utilizzando dati e analisi personalizzati.