StatisticsCollector-Richtlinie

Einfaches Beispiel

<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 diesem Beispiel erfassen Sie statistische Informationen über zwei benutzerdefinierte Variablen: product.id und product.price. Bei jeder Anfrage schreibt die Statistics Collector-Richtlinie den Wert dieser beiden Variablen an den Analyseserver.

In diesem Beispiel wird auch ein optionaler Standardwert für jede Variable festgelegt, wobei der Standardwert für product.id 999999 ist und der Standardwert product.price 0 ist. Wenn eine Variable nicht definiert ist und Sie keinen Standardwert angeben, werden für die Variable keine Daten aufgezeichnet. Wenn Sie einen Standardwert angeben, wird der Standardwert aufgezeichnet, wenn die Variable nicht definiert ist.

Nachdem Sie statistische Daten erfasst haben, können Sie die Statistiken über die Edge-Verwaltungs-UI oder -API abrufen. Beim Abrufen der Statistiken verweisen Sie auf die für diese Variablen erfassten Daten als productID bzw. price .

Zugriff auf Statistiken

In diesem Beispiel verwenden Sie die Edge-Verwaltungs-API, um die statistischen Daten für die Sammlung namens productID anzusehen. Durch diese Anfrage wird ein benutzerdefinierter Bericht für Produkt-IDs erstellt, der auf der Summe der für jede Produkt-ID eingereichten Nachrichtenanzahl pro Tag basiert. Ersetzen Sie die Variable {org_name} durch Ihren Organisationsnamen und email:password durch Apigee durch die E-Mail-Adresse und das Passwort für Ihr Konto.

Legen Sie den Parameter timeRange so fest, dass er das Zeitintervall enthält, in dem Ihre Daten erfasst wurden. Daten, die älter als sechs Monate ab dem aktuellen Datum sind, sind standardmäßig nicht verfügbar. Wenn Sie auf Daten zugreifen möchten, die älter als sechs Monate sind, wenden Sie sich an den Apigee Edge-Support.

$ 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

In der Antwort enthält das Feld Name die Produkt-ID und den Wert für die Anzahl der Anfragen pro Tag.

{
  "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"
  }
}

Daten für die Sammlung extrahieren

<?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>

Die Statistik-Collector-Richtlinie verlangt, dass die erhobenen Daten in Variablen gespeichert werden. Diese Variablen können von Apigee vordefiniert oder von Ihnen definierte benutzerdefinierte Variablen sein.

In diesem Beispiel verwenden Sie die Richtlinie „Variablen extrahieren“, um Daten aus einer XML-Nutzlast zu extrahieren, die Wetterinformationen enthalten. Sie erfahren darin,

• Extrahiert den Namen der Stadt und schreibt ihn in eine Variable namens wetter.location
• Extrahiert die aktuellen Bedingungen und schreibt sie in eine Variable namens weather.condition

Mit der Richtlinie „Statistics Collector“ können Sie dann Informationen zu den Variablen erfassen, wie unten dargestellt:

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="weatherLocation" ref="weather.location" type="string"></Statistic>
    <Statistic name="weatherCondition" ref="weather.condition" type="string"></Statistic>
  </Statistics>
</StatisticsCollector>

Ein vollständiges Tutorial zum Extrahieren von Daten aus einer XML-Nutzlast für die Statistik-Collector-Richtlinie finden Sie unter API-Nachrichteninhalte mit benutzerdefinierten Analysen analysieren.