Zasada Statystyki Statystyki

Podstawowy przykład

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

W tym przykładzie zbierasz informacje statystyczne o 2 zmiennych niestandardowych: product.id i product.price. Przy każdym żądaniu zasada kolektora statystyk zapisuje wartości tych 2 zmiennych na serwerze analiz.

W tym przykładzie ustawia się też opcjonalną wartość domyślną każdej zmiennej – domyślna wartość product.id to 999999, a wartość domyślna product.price to 0. Jeśli zmienna jest niezdefiniowana i nie określisz wartości domyślnej, zmienna nie będzie rejestrować żadnych danych. Jeśli podasz wartość domyślną, będzie ona rejestrowana, gdy zmienna będzie niezdefiniowana.

Po zebraniu danych statystycznych możesz je pobrać za pomocą interfejsu użytkownika lub interfejsu API zarządzania urządzeniami brzegowymi. Przy pobieraniu statystyk dane zebrane dla tych zmiennych są oznaczone odpowiednio jako productID i price.

Uzyskiwanie dostępu do statystyk

W tym przykładzie użyjesz interfejsu Edge Management API, aby wyświetlić dane statystyczne dotyczące zbioru o nazwie productID. To żądanie tworzy raport niestandardowy dla identyfikatorów produktów na podstawie sumy liczby wiadomości przesłanych dla każdego identyfikatora produktu z poszczególnych dni. Zastąp nazwę organizacji w zmiennej {org_name}, a adres e-mail i hasło do konta w Apigee Edge zastąp wartością email:password.

Ustaw parametr timeRange, aby uwzględnić przedział czasu, w którym zebrano dane. Dane sprzed ponad 6 miesięcy od bieżącej daty są domyślnie niedostępne. Jeśli chcesz uzyskać dostęp do danych starszych niż 6 miesięcy, skontaktuj się z zespołem pomocy 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

W odpowiedzi pole name zawiera identyfikator produktu, a jego wartość wskazuje liczbę żądań z każdego dnia:

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

Wyodrębnianie danych do zbierania

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

Zasady dotyczące kolektora statystyk wymagają, aby zebrane dane były przechowywane w zmiennych. Te zmienne mogą być wstępnie zdefiniowane przez Apigee lub zmienne niestandardowe zdefiniowane przez Ciebie.

W tym przykładzie użyjesz zasady Wyodrębnianie zmiennych, aby wyodrębnić dane z ładunku XML, który zawiera informacje o pogodzie. Dzięki nim:

• Wyodrębnia nazwę miasta i zapisuje ją w zmiennej o nazwie weather.location
• Wyodrębnia bieżące warunki i zapisuje je w zmiennej o nazwie weather.condition.

Następnie możesz zbierać informacje o zmiennych za pomocą zasady kolektora statystyk, jak pokazano poniżej:

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

Pełny samouczek, który pokazuje, jak wyodrębniać dane z ładunku XML na potrzeby zasady kolektora statystyk, znajdziesz w artykule Analizowanie treści wiadomości interfejsu API przy użyciu statystyk niestandardowych.