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 concernant deux variables personnalisées: product.id et product.price. À chaque demande, le La stratégie du collecteur de statistiques écrit la valeur de ces deux variables dans l'analyse Google Cloud.

Cet exemple définit également une valeur par défaut facultative pour chaque variable, où la valeur par défaut valeur de product.id est 999999 et l'attribut product.price par défaut est de 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 faites référence aux données collectées pour ces variables sous la forme productID et price, respectivement.

Accéder aux statistiques

Dans cet exemple, vous utilisez l'API de gestion Edge pour afficher les données statistiques pour le appelée productID. Cette demande crée un rapport personnalisé en fonction de la somme des messages envoyés pour chaque ID produit 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 au cours duquel 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, la valeur name contient l'ID produit et sa valeur indique le nombre de requêtes par 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 des 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
• Il 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 , 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 expliquant comment extraire des données d'une charge utile XML pour stratégie du collecteur de statistiques, voir Analyser l'API le contenu du message à l'aide d'analyses personnalisées.