Zasada Statystyki Statystyki

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Co

Umożliwia zbieranie statystyk dotyczących danych w wiadomości, takich jak identyfikator produktu, cena, działanie REST , adres URL klienta i docelowy oraz długość wiadomości. Dane mogą pochodzić ze zmiennych przepływu zdefiniowanych przez Apigee lub ze zmiennych niestandardowych zdefiniowanych przez Ciebie.

Dane statystyczne są przekazywane na serwer Analytics, który analizuje statystyki i generuje raporty. Raporty możesz wyświetlać za pomocą interfejsu zarządzania Edge lub interfejsu 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 Statistics Collector

Po wykonaniu zasada Statistics Collector rejestruje bieżącą wartość co najmniej 1 zmiennej. Te zmienne mogą być zmiennymi przepływu zdefiniowanymi przez Apigee lub zmiennymi niestandardowymi zdefiniowanymi przez Ciebie. Te dane są zapisywane na serwerze Analytics Edge.

Aby uzyskać dostęp do danych statystycznych zebranych przez zasadę, użyj interfejsu Edge API lub interfejsu zarządzania Edge. Możesz na przykład użyć interfejsu zarządzania Edge, aby utworzyć raport niestandardowy, który będzie wyświetlać zebrane dane w różnych formatach.

Pełny samouczek dotyczący korzystania z zasady Statistics Collector znajdziesz w artykule Analizowanie treści wiadomości interfejsu API za pomocą niestandardowych statystyk.

Gdzie umieścić zasadę

Zasadę Statistics Collector możesz umieścić w przepływie żądania lub odpowiedzi proxy interfejsu API. Jeśli jednak w proxy umieścisz kilka zasad Statistics Collector, o danych zapisywanych na serwerze Analytics decyduje ostatnia z nich, a dane zapisane przez poprzednie zasady Statistics Collector zostaną utracone.

Możesz mieć kilka zasad Statistics Collector w proxy interfejsu API, jeśli masz jedną w przepływie żądania lub odpowiedzi, a drugą w obsłudze błędów. Jeśli w proxy interfejsu API wystąpi błąd, o zebranych danych decyduje zasada Statistics Collector w obsłudze błędów. Możesz użyć tej zasady Statistics Collector, aby zarejestrować informacje o błędzie lub zarejestrować inne informacje, które uznasz za niezbędne. Zasada Statistics Collector w obsłudze błędów decyduje o zebranych danych niezależnie od tego, czy zasada Statistics Collector w żądaniu lub odpowiedzi została już wykonana.

Więcej informacji znajdziesz w artykule Obsługa błędów.

Dokumentacja elementów

Dokumentacja elementów zawiera opis elementów i atrybutów zasady Statistics Collector policy.

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

Atrybuty elementu <StatisticsCollector>

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

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

&lt;DisplayName&gt; 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>

Element <Statistics>/<Statistic>

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

Dokumentacja błędów

W tej sekcji opisaliśmy komunikaty o błędach i zmienne przepływu, które są ustawiane, gdy ta zasada powoduje błąd. Te informacje są ważne, jeśli tworzysz reguły błędów dla serwera proxy. Więcej informacji znajdziesz w artykułach Więcej informacji o błędach związanych z naruszeniem zasad i Rozwiązywanie problemów.

Błędy w czasie wykonywania

Brak.

Błędy wdrażania

Zmienne błędów

Brak.

Schemat

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

Powiązane artykuły

Więcej informacji znajdziesz w tych artykułach:

• Analizowanie treści wiadomości interfejsu API za pomocą niestandardowych statystyk
• Zarządzanie raportami niestandardowymi
• Mierzenie skuteczności programu interfejsu API za pomocą interfejsów API danych