Règle StatisticsCollector

Exemple de 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>

Dans cet exemple, vous collectez des informations statistiques sur deux variables personnalisées : product.id et product.price. À chaque requête, la stratégie du collecteur de statistiques écrit la valeur de ces deux variables sur le serveur d'analyse.

Cet exemple définit également une valeur par défaut facultative pour chaque variable : la valeur par défaut de product.id est 999999 et celle de product.price par défaut est 0. Si une variable n'est pas définie et que vous ne spécifiez pas de valeur par défaut, aucune donnée n'est enregistrée pour la variable. Si vous spécifiez une valeur par défaut, la valeur par défaut est enregistrée lorsque la variable n'est pas définie.

Après avoir collecté des données statistiques, vous pouvez utiliser l'interface utilisateur ou l'API de gestion Edge pour récupérer les statistiques. Lorsque vous récupérez des statistiques, vous référencez les données collectées pour ces variables en tant que productID et price, respectivement.

Accéder aux statistiques

Dans cet exemple, vous utilisez l'API de gestion Edge pour afficher les données statistiques de la collection appelée productID. Cette demande crée un rapport personnalisé pour les ID produit en fonction de la somme du nombre de messages soumis pour chaque ID produit pour chaque jour. Remplacez le nom de votre organisation par la variable {org_name}, puis remplacez l'adresse e-mail et le mot de passe de votre compte sur Apigee Edge par email:password.

Définissez le paramètre timeRange pour inclure l'intervalle de temps pendant lequel vos données ont été collectées. Les données datant de plus de six mois à compter de la date du jour ne sont pas accessibles par défaut. Si vous souhaitez accéder à des données datant de plus de six mois, contactez l'assistance 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

Dans la réponse, le champ name contient l'ID produit, et la valeur indique le nombre de requêtes pour chaque jour:

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

Extraction des données pour la collecte...

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

La stratégie du collecteur de statistiques exige que les données collectées soient stockées dans des variables. Ces variables peuvent être prédéfinies par Apigee ou des variables personnalisées que vous définissez.

Dans cet exemple, vous utilisez la règle Extract Variables pour extraire les données d'une charge utile XML contenant des informations météorologiques. Il permet de:

• Extrait le nom de la ville et l'écrit dans une variable nommée weather.location
• Elle extrait les conditions actuelles et les écrit dans une variable nommée weather.condition

Vous pouvez ensuite utiliser la stratégie du collecteur de statistiques pour recueillir des informations sur les variables, comme indiqué ci-dessous:

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

Pour accéder à un tutoriel complet qui montre comment extraire des données d'une charge utile XML pour la stratégie du collecteur de statistiques, voir Analyser le contenu des messages de l'API à l'aide d'analyses personnalisées.