Zasada Statystyki Statystyki

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Co

Umożliwia gromadzenie statystyk dotyczących danych zawartych w wiadomości, np. identyfikatora produktu, ceny czy REST. działania, klienta i docelowego adresu URL oraz długość wiadomości. Dane mogą pochodzić ze zmiennych przepływu wstępnie zdefiniowane przez Ciebie przez Apigee lub niestandardowe zmienne.

Dane statystyczne są przekazywane do serwera analitycznego, który analizuje statystyki i raportów. Raporty możesz wyświetlać za pomocą interfejsu Edge Management UI lub Edge API.

Przykłady

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

$ 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

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

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

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

Informacje o zasadzie kolektora statystyk

Po wykonaniu zasada kolektora statystyk rejestruje bieżącą wartość co najmniej jednego zmiennych. Mogą to być zmienne procesu wstępnie zdefiniowane przez Apigee lub zmienne niestandardowe, które zdefiniowanych przez reklamodawcę. Te dane są zapisywane na serwerze analizy brzegowej.

Aby uzyskać dostęp do danych statystycznych zebranych przez zasadę, używasz interfejsu Edge API lub Edge za pomocą prostego interfejsu zarządzania. Możesz na przykład użyć interfejsu zarządzania brzegiem, aby utworzyć raport niestandardowy, który pokazuje zebrane dane w różnych formatach.

Pełny samouczek dotyczący korzystania z zasady kolektora statystyk znajdziesz w artykule Analizuj API za pomocą niestandardowych statystyk.

Gdzie umieścić zasadę

Możesz umieścić zasadę kolektora statystyk w przepływie żądań lub odpowiedzi interfejsu API serwera proxy. Jeśli jednak na serwerze proxy umieścisz wiele zasad kolektora statystyk, ostatni który ma zostać uruchomiony, wskazuje dane zapisane na serwerze analiz i dane zapisane przez poprzednie zasady kolektora statystyk zostaną utracone.

Jednym ze scenariuszy, w którym na serwerze proxy interfejsu API może być wiele zasad kolektora statystyk, jest gdy jeden występuje w procesie żądania lub odpowiedzi, a drugi w module obsługi błędów. Jeśli błąd ma miejsce na serwerze proxy interfejsu API, dane są określane przez kolektor statystyk w module obsługi błędów zgromadzone dane. Może on służyć do rejestrowania informacji o błędzie lub rejestrować wszelkie inne informacje, które Twoim zdaniem są niezbędne. Błąd kolektora statystyk Moduł obsługi określa zbierane dane niezależnie od tego, czy kolektor statystyk już wykonano żądanie/odpowiedzi.

Więcej informacji znajdziesz w sekcji Obsługa .

Odwołanie do elementu

Odniesienie do elementu opisuje elementy i atrybuty kolektora statystyk .

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Statistics-Collector-1">
    <DisplayName>Statistics Collector 1</DisplayName>
    <Statistics>
        <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
    </Statistics>
</StatisticsCollector>

<StatisticsCollector> atrybuty

<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Stats-1">

W tej tabeli opisano atrybuty wspólne dla wszystkich elementów nadrzędnych zasad:

<DisplayName> element

Używaj oprócz atrybutu name do oznaczania zasady w edytor proxy interfejsu zarządzania z inną nazwą w języku naturalnym.

<DisplayName>Policy Display Name</DisplayName>

<Statistics>/<Statistic> element

<Statistics>
    <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
</Statistics>

Informacje o błędzie

This section describes the error messages and flow variables that are set when this policy triggers an error. This information is important to know if you are developing fault rules for a proxy. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

None.

Deployment errors

Fault variables

None.

Schemat

Każdy typ zasad jest definiowany przez schemat XML (.xsd). Schematy zasad są dostępne na GitHubie.

Powiązane artykuły

Aby dowiedzieć się więcej, zobacz:

• Interfejs API analiz treść wiadomości za pomocą niestandardowych statystyk.
• Zarządzanie raportami niestandardowymi
• Stosowanie interfejsów API do pomiarów skuteczności w programie dotyczącym interfejsów API