StatisticsCollector-Richtlinie

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Was

Ermöglicht das Erfassen von Statistiken für Daten in einer Nachricht, z. B. Produkt-ID, Preis, REST Aktion, Client- und Ziel-URL und Nachrichtenlänge. Die Daten können aus Flussvariablen stammen, oder benutzerdefinierten Variablen, die Sie definieren.

Die Statistikdaten werden an den Analyseserver übergeben, der die Statistiken analysiert und erstellt Berichte. Sie können die Berichte mithilfe der Edge-Verwaltungsbenutzeroberfläche oder der Edge API anzeigen.

Beispiele

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

Informationen zur Statistics Collector-Richtlinie

Bei der Ausführung zeichnet die Statistics Collector-Richtlinie den aktuellen Wert eines oder mehrerer Variablen. Diese Variablen können von Apigee vordefinierte Flussvariablen oder benutzerdefinierte Variablen sein, die die Sie definieren. Diese Daten werden auf den Edge-Analyseserver geschrieben.

Um auf die von der Richtlinie erfassten statistischen Daten zuzugreifen, verwenden Sie die Edge API oder den Edge auf der Benutzeroberfläche. Sie können beispielsweise mit der Edge-Management-Benutzeroberfläche einen benutzerdefinierten Bericht erstellen, der zeigt die gesammelten Daten in verschiedenen Formaten.

Ein vollständiges Tutorial zur Verwendung der Statistics Collector-Richtlinie finden Sie unter Analysieren Sie die API . Nachrichteninhalt mit benutzerdefinierten Analysen.

Wo die Richtlinie eingefügt werden soll

Sie können eine Statistik-Collector-Richtlinie in den Anforderungs- oder Antwortablauf einer API aufnehmen. Proxy. Wenn Sie jedoch mehrere Statistics Collector-Richtlinien in einen Proxy stellen, dann ist die letzte die auf den Analyseserver geschrieben werden, und die Daten, die von einem beliebigen gehen vorherige Statistics Collector-Richtlinien verloren.

Ein Szenario, in dem Sie möglicherweise mehrere Statistics Collector-Richtlinien in einem API-Proxy haben, ist wenn es eine im Anforderungs- oder Antwortfluss und ein anderes in einem Fehlerbehandlungsprogramm gibt. Wenn ein Fehler im API-Proxy erfolgt, bestimmt der Statistics Collector im Fehlerbehandlungsprogramm die Daten gesammelt. Sie können diesen Statistics Collector verwenden, um Informationen über den Fehler aufzuzeichnen oder um und alle anderen Informationen aufzuzeichnen, die Sie für notwendig halten. Der Statistics Collector in der Fehlermeldung Handler ermittelt die erfassten Daten unabhängig davon, ob der Statistics Collector in der Anfrage/Antwort, die bereits ausgeführt wurde.

Weitere Informationen finden sich unter Fehlerbehandlung.

Elementverweis

In der Elementreferenz werden die Elemente und Attribute des Statistics Collectors beschrieben. .

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

&lt;StatisticsCollector&gt; Attribute

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

In der folgenden Tabelle werden Attribute beschrieben, die für alle übergeordneten Richtlinienelemente gelten:

<DisplayName>-Element

Wird zusätzlich zum Attribut name verwendet, um die Richtlinie im Proxy-Editor der Verwaltungs-UI mit einem anderen Namen in einer natürlichen Sprache zu versehen.

<DisplayName>Policy Display Name</DisplayName>

&lt;Statistics&gt;/&lt;Statistic&gt; Unterelement

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

Fehlerreferenz

In diesem Abschnitt werden die Fehlermeldungen und Ablaufvariablen beschrieben, die festgelegt werden, wenn diese Richtlinie einen Fehler auslöst. Dieses Informationen sind wichtig, wenn Sie Fehlerregeln für einen Proxy entwickeln. Weitere Informationen finden Sie unter Was Sie über Richtlinienfehler wissen müssen und Fehler beheben.

Laufzeitfehler

–

Bereitstellungsfehler

Fehlervariablen

Keine.

Schema

Jeder Richtlinientyp wird durch ein XML-Schema (.xsd) definiert. Zu Referenzzwecken sind Richtlinienschemas auf GitHub verfügbar.

Weitere Informationen

Weitere Informationen finden Sie unter:

• Analyse-API Nachrichteninhalte mit benutzerdefinierten Analysen
• Benutzerdefinierte Berichte verwalten
• Verwenden Sie die Metrik-APIs, um die API-Programmleistung zu messen