Política do StatisticsCollector

Exemplo básico

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

Neste exemplo, você coleta informações estatísticas sobre duas variáveis personalizadas: product.id e product.price. Em cada solicitação, a política do coletor de estatísticas grava o valor dessas duas variáveis no servidor de análise.

Este exemplo também define um valor padrão opcional para cada variável, em que o valor padrão de product.id é 999999 e o product.price padrão é 0. Se uma variável não for definida e você não especificar um valor padrão, nenhum dado será registrado para ela. Se você especificar um valor padrão, ele será registrado quando a variável for indefinida.

Depois de coletar dados estatísticos, use a API ou a IU de gerenciamento do Edge para recuperar as estatísticas. Ao recuperar estatísticas, faça referência aos dados coletados para essas variáveis como productID e price, respectivamente.

Como acessar estatísticas

Neste exemplo, você usa a API Edge Management para visualizar os dados estatísticos da coleção chamada productID. Essa solicitação cria um relatório personalizado para IDs de produto com base na soma das contagens de mensagens enviadas para cada ID de produto em cada dia. Substitua o nome da sua organização pela variável {org_name} e o e-mail e a senha da sua conta no Apigee Edge por email:password.

Defina o parâmetro timeRange para incluir o intervalo de tempo em que os dados foram coletados. Dados anteriores a seis meses antes da data atual não podem ser acessados por padrão. Se você quiser acessar dados com mais de seis meses, entre em contato com o suporte do 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

Na resposta, o campo name contém o ID do produto e o valor mostra o número de solicitações de cada dia:

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

Extraindo dados para coleta

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

A política do Coletor de estatísticas exige que os dados coletados sejam armazenados em variáveis. Essas variáveis podem ser predefinidas pela Apigee ou por variáveis personalizadas definidas por você.

Neste exemplo, você usa a política "Extract Variables" para extrair dados de um payload XML que contém informações meteorológicas. Ela serve para:

• Extrai o nome da cidade e o grava em uma variável chamada weather.location
• Extrai as condições atuais e as grava em uma variável chamada weather.condition

Em seguida, use a política do coletor de estatísticas para coletar informações sobre as variáveis, conforme mostrado abaixo:

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

Para ver um tutorial completo que mostra como extrair dados de um payload XML para a política do Coletor de estatísticas, consulte Analisar o conteúdo da mensagem da API usando análises personalizadas.