Referenz zu Analysemesswerten, -dimensionen und -filtern

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Dieses Thema dient als Referenz für Analysemesswerte, Dimensionen und Filter. Weitere Informationen zur Verwendung finden Sie in der Übersicht über API Analytics.

In diesem Thema werden die Namen für Metriken und Dimensionen aufgeführt, wie sie in der Benutzeroberfläche angezeigt werden und in API-Aufrufen verwendet werden müssen.

• Sie sehen die Namen der Benutzeroberfläche, wenn Sie benutzerdefinierte Berichte erstellen und verwalten.
• Verwenden Sie die API-spezifischen Namen, wenn Messwerte abrufen, Bericht erstellen Definition oder Bericht aktualisieren Definition.

Messwerte

Im Folgenden finden Sie die API-Messdaten, die Sie in benutzerdefinierten Berichten und Apigee API-Aufrufen abrufen können.

Messwert	Name, der in der Apigee API verwendet werden soll	Functions	Beschreibung
Durchschnittliche Transaktionen pro Sekunde	tps	–	Die durchschnittliche Anzahl von Transaktionen, also API-Proxy-Anfragen, pro Sekunde. Beachten Sie, dass die durchschnittliche Anzahl der Transaktionen pro Sekunde in benutzerdefinierten Berichten der Benutzeroberfläche null sein kann, wenn die Anzahl kleiner als zwei Dezimalstellen ist. API-Syntax: tps
Cache-Treffer	cache_hit	Summe	Anzahl erfolgreicher API-Anfragen, die ResponseCache anstelle der Antwort des Zieldienstes verwenden. API-Syntax: sum(cache_hit)
Anzahl der L1-Cache-Elemente	ax_cache_l1_count	avg, min, max	Anzahl der Elemente im L1-Cache (im Arbeitsspeicher) pro Transaktion über einen bestimmten Zeitraum. Wenn Sie beispielsweise max für den Zeitraum eines Tages auswählen und innerhalb dieses Tages die höchste Anzahl von Elementen im Cache für eine bestimmte Transaktion 12 ist, beträgt die Anzahl 12. Wenn für avg in dem von Ihnen abgefragten Zeitraum drei Transaktionen vorhanden sind und die Cache-Anzahl 5, 6 und 7 beträgt, beträgt der Durchschnitt 6. Der L1-Cache befindet sich im Cache statt im L2-Datenbankcache, wie unter Cache-Interna beschrieben. API-Syntax: avg(ax_cache_l1_count)
Verstöße gegen Richtlinien	policy_error	Summe	Die Gesamtzahl der Richtlinienfehler im angegebenen Zeitraum. Richtlinienfehler treten normalerweise konstruktionsbedingt auf. Die VerifyApiKey-Richtlinie gibt beispielsweise einen Fehler aus, wenn ein ungültiger API-Schlüssel in der Anfrage übergeben wird. Eine SpikeArrest-Richtlinie gibt einen Fehler aus, wenn die Anzahl der API-Aufrufe das in der Richtlinie angegebene Limit überschreiten. Daher ist diese Metrik hilfreich, um potenzielle Problemstellen in Ihren APIs zu finden. Beispielsweise können Sie anhand von policy_error-Messwerten, gruppiert nach der developer_app-Dimension, feststellen, dass ein API-Schlüssel oder ein OAuth-Token für eine bestimmte Anwendung abgelaufen ist. Oder Sie können feststellen, dass ein bestimmter API-Proxy viele SpikeArrest-Richtlinienfehler ausgibt, was darauf hinweist, dass das Spike Arrest-Limit des Proxys nicht für eine Zunahme des Feiertagstraffics verantwortlich ist. Ein Richtlinienfehler wird nur in der Analyse protokolliert, wenn der Fehler zum Ausfall des API-Proxys führt. Beispiel: Wenn das continueOnError-Attribut einer Richtlinie auf true festgelegt wird, enthält der API-Proxy eine Anfrage auch dann weiter, wenn die Richtlinie fehlschlägt. In diesem Fall wird in Analytics kein Richtlinienfehler protokolliert. Die Dimension „Richtlinienname bei Fehler“ (ax_execution_fault_policy_name) ist hilfreich, um Richtlinienfehler nach Richtliniennamen zu gruppieren. Ein Zielfehler (z. B. 404 oder 503) zählt nicht als Richtlinienfehler. Diese zählen als API-Proxy-Fehler (is_error). API-Syntax: sum(policy_error)
Proxy-Fehler	is_error	Summe	Die Gesamtzahl, wie oft API-Proxys im angegebenen Zeitraum fehlgeschlagen sind. Ein Proxy-Fehler kann auftreten, wenn eine Richtlinie fehlschlägt oder ein Laufzeitfehler auftritt, z. B. 404 oder 503 des Zieldienstes. Die Proxy-Dimension (apiproxy) ist hilfreich, um API-Proxy-Fehler nach Proxy zu gruppieren. API-Syntax: sum(is_error)
Anfrageverarbeitungslatenz	request_processing_latency	avg, min, max	Die Zeit (Durchschnitt, Minimum oder Maximum) in Millisekunden, die Apigee zur Verarbeitung eingehender Anfragen benötigt. Die Zeit beginnt, wenn die Anforderung Apigee erreicht, und endet, wenn Apigee die Anforderung an den Zieldienst weiterleitet. Mithilfe verschiedener Dimensionen können Sie Latenzen für die Anforderungsverarbeitung nach API-Proxy, Entwickler-App, Region usw. prüfen. API-Syntax: max(request_processing_latency)
Größe der Anfrage	request_size	sum, avg, min, max	Die Größe der von Apigee empfangenen Anforderungsnutzlast in Byte. API-Syntax: avg(request_size)
Antwort-Cache ausgeführt	ax_cache_executed	Summe	Gibt an, wie oft eine ResponseCache-Richtlinie im angegebenen Zeitraum ausgeführt wurde. Da die ResponseCache-Richtlinie an zwei Stellen in einem API-Proxy angehängt ist (einmal in der Anfrage und einmal in der Antwort), wird sie normalerweise zweimal in einem API-Aufruf ausgeführt. Ein Cache-GET und ein Cache-PUT zählen jeweils als eine Ausführung. Die Ausführung des Antwort-Caches ist jedoch 0, wenn das <SkipCacheLookup>-Element in der Richtlinie "true" (in der Anfrage) lautet, und 0, wenn das Element <SkipCachePopulation> in der Richtlinie als "true" eingestuft wird. wird mit "true" (in der Antwort) ausgewertet. Klicken Sie im Debugging-Tool auf das Symbol ResponseCache in einem ausgeführten API-Aufruf und sehen Sie sich die Ablaufvariable responsecache.executed an. Sie gibt an, ob eine Cache-Ausführung (Wert 1) aufgetreten ist. API-Syntax: sum(ax_cache_executed)
Antwortverarbeitungslatenz	response_processing_latency	avg, min, max	Die Zeit (Durchschnitt, Minimum oder Maximum) in Millisekunden, die Apigee zur Verarbeitung von API-Antworten Apigee benötigt. Die Zeit beginnt, wenn der API-Proxy die Zieldienstantwort erhält, und endet, wenn Apigee die Antwort an den ursprünglichen Anrufer weiterleitet. Mithilfe verschiedener Dimensionen können Sie die Latenz der Antwortverarbeitung nach API-Proxy, -Region usw. prüfen. API-Syntax: min(response_processing_latency)
Größe der Antwort	response_size	sum, avg, min, max	Die Größe der an den Client zurückgegebenen Antwortnutzlast in Byte. API-Syntax: max(response_size)
Zielfehler	target_error	Summe	Gesamtzahl der 5xx-Antworten des Zieldienstes. Dies sind Zieldienstfehler, die nicht von Apigee verursacht werden. API-Syntax: sum(target_error)
Zielantwortzeit	target_response_time	sum, avg, min, max	Die Zeit (Summe, Durchschnitt, Minimum oder Maximum) in Millisekunden, in der der Zielserver auf einen Anruf antwortet. Diese Metrik gibt an, wie die Zielserver arbeiten. Die Zeit beginnt, wenn Apigee eine Anfrage an den Zieldienst weiterleitet, und endet, wenn Apigee die Antwort empfängt. Wenn ein API-Aufruf eine Antwort aus dem Cache zurückgibt (z. B. mit der Richtlinie ResponseCache), wird der Aufruf niemals den Zieldienst erreichen. Außerdem werden keine Messwerte für die Zielantwortzeit erfasst. API-Syntax: avg(target_response_time)
Gesamtantwortzeit	total_response_time	sum, avg, min, max	Der Zeitraum (Summe, Durchschnitt, Minimum oder Maximum) in Millisekunden, nachdem Apigee eine Anfrage von einem Client empfangen hat und bis Apigee die Antwort an den Client zurück sendet. Die Zeit beinhaltet den Netzwerkaufwand (z. B. die Zeit, die Load-Balancer und Router benötigen, um ihre Arbeit zu erledigen), die Verarbeitungslatenz, die Antwortverarbeitungslatenz und die Zielantwortzeit (wenn die Antwort statt des Caches vom Zieldienst bereitgestellt wird). Mithilfe verschiedener Dimensionen können Sie Latenzen für die Anfrageverarbeitung nach API-Proxy, Entwickler-App, Region usw. prüfen. API-Syntax: avg(total_response_time)
Traffic	message_count	Summe	Die Gesamtzahl der von Apigee im angegebenen Zeitraum verarbeiteten API-Aufrufe. Verwenden Sie Dimensionen, um die Anzahl der Zugriffe so zu gruppieren, wie es für Sie am aussagekräftigsten ist. API-Syntax: sum(message_count)
Monetarisierung
Gebühren	fees	sum, avg, min, max	Betrag, der für die Einrichtungsgebühr, wiederkehrende Gebühren oder die Vorauszahlungen steht. API-Syntax: sum(fees)
Umsatzanteil des Entwicklers	x_apigee_mintng_dev_share	sum, avg, min, max	Anteil des Entwicklers am Umsatz einer Transaktion. Apigee berechnet den Anteil des Entwicklers nur, wenn Sie die Umgebungsvariable in Ihrem Tarif aktiviert haben. Der Anteil des Entwicklers wird mit der folgenden Formel berechnet: x_apigee_mintng_dev_share = revShareGrossPrice * (share percentage) Der Wert des Anteilprozentsatzes wird aus Ihrem Tarif abgerufen. API-Syntax: sum(x_apigee_mintng_dev_share)
Monetarisierungspreis	x_apigee_mintng_price	sum, avg, min, max	Gesamtumsatz einer Transaktion. Der Umsatz einer Transaktion wird auf den Wert der Monetarisierungsvariable revShareGrossPrice gesetzt, die in Ihrer DataCapture-Richtlinie erfasst wird. API-Syntax: sum(x_apigee_mintng_price)
API-Preismultiplikator	x_apigee_mintng_price_multiplier	sum, avg, min, max	Der Faktor (Multiplikator), mit dem die Kosten pro Transaktion multipliziert werden. Die Kosten pro Transaktion werden in den nutzungsbasierten Gebühren des Tarifs angegeben. API-Syntax: avg(x_apigee_mintng_price_multiplier)
Monetarisierungsraten	x_apigee_mintng_rate	sum, avg, min, max	Preis für eine Transaktion. Der für eine Transaktion berechnete Preis wird mithilfe der folgenden Formel berechnet: x_apigee_mintng_rate = (consumption-based pricing rate) * perUnitPriceMultiplier value Der Wert des nutzungsbasierten Preises wird aus Ihrem Tarif abgerufen und der perUnitPriceMultiplier-Wert wird nur multipliziert, wenn die Variable von der DataCapture-Richtlinie erfasst wird. API-Syntax: sum(x_apigee_mintng_rate)

Dimensionen

Mit Dimensionen können Sie Messwerte in sinnvollen Gruppierungen anzeigen. Beispielsweise ist es möglich, sich die Gesamtzahl der Zugriffe anzeigen zu lassen, wenn Sie sie für jede Entwickler-App oder jeden API-Proxy aufrufen.

Im Folgenden sind die Dimensionen aufgeführt, die Apigee standardmäßig bietet.

Dimension	Name, der in der Apigee API verwendet werden soll	Beschreibung
Access Token (Zugriffstoken)	access_token	Das OAuth-Zugriffstoken des Endnutzers der Anwendung.
API-Produkt	api_product	Name des API-Produkts, das die aufgerufenen API-Proxys enthält. Um diese Dimension zu erhalten, müssen Entwickleranwendungen, die die Aufrufe ausführen, einem oder mehreren API-Produkten zugeordnet sein, die die API-Proxys enthalten, und die aufgerufenen Proxys müssen nach einem API-Schlüssel oder OAuth-Token suchen, das mit dem API-Aufruf gesendet wurde. Der Schlüssel oder das Token ist einem API-Produkt zugeordnet. Weitere Informationen finden Sie unter Wie erstelle ich vollständige Analysedaten?. Wenn die oben genannten Kriterien nicht erfüllt werden, wird der Wert (not set) angezeigt. Siehe auch Was bedeutet ein Analytics-Entity-Wert "(nicht festgelegt)"?. Im Zusammenhang mit dem Messwert für Gebühren ist es ein API-Produkt, das dem Tarif entspricht, für den die Einrichtungsgebühr oder wiederkehrende Gebühr angewendet werden soll. Bei Vorauszahlungen ist der Wert leer.
Cache-Schlüssel	ax_cache_key	Schlüssel mit dem Wert ResponseCache, auf den zugegriffen wurde. Weitere Informationen dazu, wie der Schlüssel für den Antwortcache erstellt wird, finden Sie unter Antwort-Cache-Richtlinie. Wenn Sie im Debugging-Tool eine ResponseCache-Richtlinie auswählen, die aus dem Cache liest oder in den Cache schreibt, können Sie diesen Wert in der Ablaufvariable responsecache.cachekey sehen.
Cache-Name	ax_cache_name	Name des Caches, der die Schlüssel/Werte enthält, die von der ResponseCache-Richtlinie verwendet werden, mit dem Präfix orgName__envName__. Wenn die Organisation beispielsweise myorgf ist, ist die Umgebung test und der Cache-Name ist myCache, dann ist ax_cache_name foo__test__myCache. Wenn Sie im Debugging-Tool eine ResponseCache-Richtlinie auswählen, können Sie diesen Wert in der responsecache.cachename-Ablaufvariablen sehen.
Quelle für Cache	ax_cache_source	Cache-Ebene (L1-In-Mem ory- oder L2-Datenbank), aus der ResponseCache abgerufen wurde. Diese Dimension zeigt auch CACHE_MISS an, wenn die Antwort vom Ziel statt vom Cache gesendet wurde und der Antwortcache mit der Zielantwort aktualisiert wurde, oder wenn ein Cache-Schlüssel in der Anfrage ungültig ist. Cache-Schlüssel sind auf 2 KB begrenzt. Wenn Sie im Debugging-Tool die ResponseCache-Richtlinie auswählen, können Sie diesen Wert in der responsecache.cachesource-Ablaufvariablen sehen. Weitere Informationen zu Cache-Levels finden Sie unter Interne Cashes.
Client-ID	client_id	Der Consumer-Schlüssel (API-Schlüssel) der Entwickler-App, die die API-Aufrufe durchführt, unabhängig davon, ob sie in der Anfrage als API-Schlüssel übergeben oder in OAuth-Tokens enthalten ist. Um diese Dimension zu erhalten, müssen Proxys, die Anrufe empfangen, konfiguriert sein, um nach einem gültigen API-Schlüssel oder OAuth-Token zu suchen. Entwickler-Apps erhalten API-Schlüssel, die zum Generieren von OAuth-Token verwendet werden können, wenn die Apps in Apigee registriert werden. Weitere Informationen finden Sie unter Wie erstelle ich vollständige Analysedaten?. Wenn die oben genannten Kriterien nicht erfüllt werden, wird der Wert (not set) angezeigt. Siehe auch Was bedeutet ein Analytics-Entity-Wert "(nicht festgelegt)"?.
Entwickler-App	developer_app	Die von Apigee registrierte Entwickleranwendung, die API-Aufrufe durchführt. Um diese Dimension zu erhalten, müssen Apps einem oder mehreren API-Produkten zugeordnet sein, die die aufgerufenen API-Proxys enthalten, und die Proxys müssen nach einem mit dem API-Aufruf gesendeten API-Schlüssel oder OAuth-Token suchen. Der Schlüssel oder das Token identifiziert die Entwickler-App. Weitere Informationen finden Sie unter Wie erstelle ich vollständige Analysedaten?. Wenn die oben genannten Kriterien nicht erfüllt werden, wird der Wert (not set) angezeigt. Siehe auch Was bedeutet ein Analytics-Entity-Wert "(nicht festgelegt)"?.
E-Mail-Adresse des Entwicklers	developer_email	Die E-Mail-Adresse der Apigee-registrierten Entwickler, deren App die API-Aufrufe durchgeführt hat. Um diese Dimension zu erhalten, müssen Entwickler-Apps mit einem oder mehreren API-Produkten verbunden sein, die die aufgerufenen API-Proxys enthalten, und die Proxys müssen nach einem mit dem API-Aufruf gesendeten API-Schlüssel oder OAuth-Token suchen. Der Schlüssel oder das Token identifiziert die Entwickler-App. Weitere Informationen finden Sie unter Wie erstelle ich vollständige Analysedaten?. Wenn die oben genannten Kriterien nicht erfüllt werden, wird der Wert (not set) angezeigt. Siehe auch Was bedeutet ein Analytics-Entity-Wert "(nicht festgelegt)"?. Im Zusammenhang mit dem Messwert „Gebühren“ ist es der Entwickler, dem eine Einrichtungsgebühr, wiederkehrende Gebühren oder eine Vorauszahlung berechnet werden muss.
Entwickler-ID	developer	Eindeutige von Apigee generierte Entwickler-ID im Format org_name@@@unique_id. Um diese Dimension zu erhalten, müssen Entwickler-Apps mit einem oder mehreren API-Produkten verbunden sein, die die aufgerufenen API-Proxys enthalten, und die Proxys müssen nach einem mit den API-Aufrufen gesendeten API-Schlüssel oder OAuth-Token suchen. Der Schlüssel oder das Token identifiziert den Entwickler. Weitere Informationen finden Sie unter Wie erstelle ich vollständige Analysedaten?. Wenn die oben genannten Kriterien nicht erfüllt werden, wird der Wert (not set) angezeigt. Siehe auch Was bedeutet ein Analytics-Entity-Wert "(nicht festgelegt)"?.
Umgebung	environment	Die Apigee-Umgebung, in der die API-Proxys bereitgestellt werden. Beispiel: test oder prod.
Fehlercode bei Fehler	ax_edge_execution_fault_code	Der Fehlercode des Fehlers. Zum Beispiel messaging.adaptors.http.flow.GatewayTimeout.
Ablaufname bei Fehler	ax_execution_fault   _flow_name	Der benannte Ablauf in einem API-Proxy, der einen Fehler ausgelöst hat. Beispiel: PreFlow, PostFlow oder der Name eines von Ihnen erstellten bedingten Ablaufs. Beachten Sie, dass der vollständige Name, der in der Apigee API verwendet werden soll, ax_execution_fault_flow_name ohne Zeilenumbruch ist. Wenn keine Fehler aufgetreten sind, wird der Wert (not set) angezeigt.
Ablaufressource	flow_resource	Nur Apigee. Weitere Informationen finden Sie unter So verwenden Sie die Dimension "Ressourcenfluss" in Analytics.
Ablaufstatus bei Fehler	ax_execution_fault   _flow_state	Der Name des API-Proxy-Ablaufs gibt an, dass Fehler ausgelöst wurden, z. B. PROXY_REQ_FLOW oder TARGET_RESP_FLOW. Beachten Sie, dass der vollständige Name, der in der Apigee API verwendet werden soll, ax_execution_fault_flow_state ohne Zeilenumbruch ist.
Gateway-Ablauf-ID	gateway_flow_id	Wenn sich API-Aufrufe durch Apigee bewegen, erhält jeder Aufruf eine eigene Gateway-Ablauf-ID. Beispiel: rrt329ea-12575-114653952-1. Die Gateway-Ablauf-ID ist nützlich, um Messwerte in Situationen mit hohem TPS zu unterscheiden, in denen andere Dimensionen wie Organisation, Umgebung und Zeitstempel bei den Aufrufen identisch sind.
Organisation	organization	Die Apigee-Organisation, in der die API-Proxys bereitgestellt werden.
Richtlinienname bei Fehler	ax_execution_fault   _policy_name	Name der Richtlinie, die einen Fehler verursachte und zum Fehlschlagen des API-Aufrufs führte. Beachten Sie, dass der vollständige Name, der in der Apigee API verwendet werden soll, ax_execution_fault_policy_name ohne Zeilenumbruch ist. Wenn eine Richtlinie einen Fehler ausgibt, aber das Richtlinienstammattribut continueOnError auf true festgelegt ist, wird der API-Proxy-Ablauf ohne Fehler fortgesetzt, und der Richtlinienfehler wird in dieser Dimension nicht gezählt.
Proxy	apiproxy	Der Computername (nicht der Anzeigename) eines API-Proxys.
Proxy-Basispfad	proxy_basepath	BasePath, der auf dem API-Proxy-ProxyEndpoint konfiguriert wurde. Der Basispfad enthält nicht die Domain und den Portteil der API-Proxy-URL. Wenn der Basis-URL eines API-Proxys beispielsweise https://apigeedocs-test.apigee.net/releasenotes/ lautet, ist der Basispfad /releasenotes. Der Wert wird auch in der Ablaufvariablen proxy.basepath gespeichert.
Proxy-Bereitstellungstyp	proxy_deployment_type	Der API-Proxytyp für bereitgestellte Proxys. Wenn Sie einen Proxytyp angeben, werden die Ergebnisse auf diesen Proxytyp beschränkt. Diese Dimension gilt nur für „Pay as you go“-Nutzer und Abo 2024-Nutzer, die Proxytypen verwenden. Mögliche Werte sind STANDARD, EXTENSIBLE oder nicht festgelegt.
Suffix des Proxy-Pfads	proxy_pathsuffix	Ressourcenpfad zum API-Proxy-Basispfad hinzugefügt. Wenn die Basis-URL eines API-Proxys beispielsweise https://apigeedocs-test.apigee.net/hello/ lautet und ein Aufruf an https://apigeedocs-test.apigee.net/hello/json erfolgt, ist pathsuffix der /json. Wenn kein pathsuffix verwendet wird, ist der Wert leer. Der Wert wird auch in der Ablaufvariablen proxy.pathsuffix gespeichert.
Proxy-Revision	apiproxy_revision	Die Revisionsnummer des API-Proxys, der API-Aufrufe verarbeitet hat. Dies bedeutet nicht unbedingt die neueste Revision eines API-Proxys. Wenn ein API-Proxy 10 Revisionen hat, kann die 8. Revision derzeit bereitgestellt werden. Außerdem kann eine API mehrere Revisionen bereitgestellt haben, solange die Revisionen unterschiedliche Basispfade haben, wie unter Proxys bereitstellen beschrieben.
Aufgelöste Client-IP-Adresse	ax_resolved_client_ip	Ausgangs-IP-Adresse des Clients. Der Wert der Dimension ax_resolved_client_ip wird aus den Werten in der Dimension ax_true_client_ip und x_forwarded_for_ip berechnet. Wenn Sie Routing-Produkte wie Akamai verwenden, um die echten IP-Adressen von Clients zu erfassen, wird die Client-IP im HTTP-Header True-Client-IP an Apigee übergeben, mit dem dann die Dimension ax_true_client_ip festgelegt wird. Der Wert der Dimension ax_resolved_client_ip wird so berechnet: Wenn ax_true_client_ip nicht null ist und keine lokale IP-Adresse enthält, setzen Sie ax_resolved_client_ip auf ax_true_client_ip. Andernfalls legen Sie ax_resolved_client_ip auf die erste nicht lokale IP-Adresse in x_forwarded_for_ip fest. Wenn sowohl ax_true_client_ip als auch x_forwarded_for_ip nur lokale IP-Adressen enthalten, setzen Sie ax_resolved_client_ip auf die letzte lokale IP-Adresse in x_forwarded_for_ip. Wenn sowohl ax_true_client_ip als auch x_forwarded_for_ip null sind, setzen Sie ax_resolved_client_ip auf (not set). Wenn ax_true_client_ip eine lokale IP-Adresse und x_forwarded_for_ip null ist, setzen Sie ax_resolved_client_ip auf (not set).
Antwort-Statuscode	response_status_code	HTTP-Antwortstatuscode, der von Apigee zum Client weitergeleitet wird, z. B. 200, 404, 503 usw. In Apigee kann der Antwortstatuscode des Ziels mit Richtlinien wie AssignMessage-Richtlinie und RaiseFault-Richtlinie überschrieben werden. Aus diesem Grund kann diese Dimension vom Zielantwortcode (target_response_code) abweichen.
Virtueller Host	virtual_host	Der Name des virtuellen Hosts, für den der API-Aufruf durchgeführt wurde, Weitere Informationen finden Sie unter Umgebungen und Umgebungsgruppen.
Eingehend/Client
IP-Adresse des Clients	client_ip	IP-Adresse des Systems, das den Router erreicht, z. B. der ursprüngliche Client (proxy_client_ip) oder ein Load-Balancer. Wenn die IP-Adresse X-Forwarded-For Header enthält die letzte aufgeführte IP-Adresse.
Gerätekategorie	ax_ua_device_category	Typ des Geräts, von dem aus der API-Aufruf durchgeführt wurde, z. B. Tablet oder Smartphone.
OS Family	ax_ua_os_family	Betriebssystemfamilie des Geräts, das den Aufruf durchführt, z. B. Android oder iOS.
Version des Betriebssystems	ax_ua_os_version	Die Betriebssystemversion des Geräts, das den Aufruf durchführt. Es ist nützlich, diese Option als zweite Aufschlüsselungsdimension mit der Betriebssystemfamilie (ax_ua_os_family) zu verwenden, um die Versionen der Betriebssysteme anzuzeigen.
Proxy-Client-IP	proxy_client_ip	IP-Adresse des aufrufenden Clients, die in die Ablaufvariable proxy.client.ip gespeichert ist. Dies ist häufig die X-Forwarded-For-Adresse des eingehenden Anrufs. Hierbei handelt es sich um die IP-Adresse, die Apigee vom letzten externen TCP-Handshake empfangen hat. Dies kann der aufrufende Client oder ein Load Balancer sein. Wenn die IP-Adresse X-Forwarded-For Header enthält die letzte aufgeführte IP-Adresse.
Weitergeleitete Client-IP-Adresse	ax_true_client_ip	Wenn Sie Routingprodukte wie Akamai verwenden, um die wahren IP-Adressen von Clients zu erfassen, werden die Client-IPs im HTTP-Header True-Client-IP an Apigee übergeben. Diese Dimension erfasst die echten Client-IPs aus diesem Header. Zur Ermittlung der ursprünglichen Client-IP-Adresse, auf die über die Dimension ax_resolved_client_ip zugegriffen wird, verwendet Apigee die Dimensionen ax_true_client_ip und x_forwarded_for_ip.
Anfragepfad	request_path	Der Ressourcenpfad (nicht die Domain) zum Zieldienst, mit Ausnahme der Abfrageparameter. Das Apigee-Beispielziel http://mocktarget.apigee.net enthält beispielsweise mehrere Ressourcen, einschließlich /user, die eine Begrüßung zurückgeben. Unabhängig davon, wie Ihr API-Proxy http://mocktarget.apigee.net/user aufruft, lautet der request_path /user.
Anfrage-URI	request_uri	Der Ressourcenpfad (nicht die Domain) zum Zieldienst, mit Ausnahme der Abfrageparameter. Das Apigee-Beispielziel http://mocktarget.apigee.net enthält beispielsweise mehrere Ressourcen, einschließlich /user?user={name}-Ressource und Abfrageparameter, um eine benutzerdefinierte Begrüßung an den angegebenen Namen zurückzugeben. Unabhängig davon, wie Ihr API-Proxy http://mocktarget.apigee.net/user?user=Dude aufruft, lautet der request_uri /user?user=Dude.
Verb anfordern	request_verb	Das HTTP-Anforderungs-Verb in den API-Anforderungen, z. B. GET, POST, PUT, DELETE.
User-Agent	useragent	Name des User-Agents oder Software-Agents, der für den API-Aufruf verwendet wird. Beispiele: Ein Pixel XL, das über Chrome telefoniert: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36 Ein iPad, das über Chrome anruft: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1 cURL von einem Terminal: curl/7.51.0
User-Agent-Familie.	ax_ua_agent_family	Familie des User-Agents, z. B. Chrome Mobile oder curl
User-Agent-Typ	ax_ua_agent_type	Der Useragent-Typ, z. B. Browser, Mobile Browser, Library usw.
User-Agent-Version	ax_ua_agent_version	Version des User-Agents. Es ist nützlich, diese Option als zweite Aufschlüsselungsdimension mit der User-Agent-Familie (ax_ua_agent_family) zu verwenden, um die Version der Agent-Familie abzurufen.
Ausgehend/Ziel
Logo: Target	target	Zielendpunkt, der die Anfrage bearbeitet hat. z. B. default
Zielbasispfad	target_basepath	Der Ressourcenpfad (mit Ausnahme der Domain) zum Zieldienst ohne Abfrageparameter, der in den <TargetEndpoint> des Proxys definiert ist. Angenommen, ein API-Proxy ruft das folgende Ziel auf: <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> In diesem Beispiel lautet der target_basepath /user. Wenn das Ziel dies wäre: <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net</URL> </HTTPTargetConnection> Der target_basepath wäre null. Wenn Sie im Debugging-Tool das AX-Symbol am Ende des Ablaufdiagramms auswählen, wird die target.basepath Ablaufvariable der Dimension "target_basepath" zugeordnet.
gRPC-Dienstname	x_apigee_grpc_service_name	Gilt nur, wenn der Zieldienst gRPC ist. Der Name des gRPC-Dienstes. Informationen zu gRPC-Proxys finden Sie unter gRPC API-Proxys erstellen.
gRPC-Status	x_apigee_grpc_status	Gilt nur, wenn der Zieldienst gRPC ist. Der gRPC-Anfragestatus. Informationen zu gRPC-Proxys finden Sie unter gRPC API-Proxys erstellen.
Zielhost	target_host	Host des Zieldienstes. Wenn ein API-Proxy beispielsweise http://mocktarget.apigee.net/help aufruft, ist der target_host mocktarget.apigee.net.
Ziel-IP-Adresse	target_ip	Die IP-Adresse des Zieldienstes, die die Antwort an den API-Proxy zurückgibt.
Zielantwortcode	target_response_code	HTTP-Antwortstatuscode, der vom Zieldienst an den API-Proxy zurückgegeben wird, z. B. 200, 404, 503 usw. Der Wert null bedeutet, dass die Anfrage den Zieldienst nie erreicht hat. Dies tritt auf, wenn die Antwort von der ResponseCache-Richtlinie bereitgestellt wird oder wenn bei der Anfrageverarbeitung ein Fehler auftritt. Dies unterscheidet sich von der Dimension Antwortstatuscode (response_status_code).
gRPC-RPC-Name	x_apigee_grpc_rpc_name	Gilt nur, wenn der Zieldienst gRPC ist. Der RPC-Name. Informationen zu gRPC-Proxys finden Sie unter gRPC API-Proxys erstellen.
Ziel-URL	target_url	Die vollständige URL des Zieldienstes, der im TargetEndpoint eines API-Proxys definiert ist. <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> In diesem Beispiel lautet target_url http://mocktarget.apigee.net/user?user=Dude. Beachten Sie, dass die URL auch während der API-Proxy-Verarbeitung mit der target.url Ablaufvariablen überschrieben werden kann. Bei der Proxy-Verkettung ist die Ziel-URL im aufrufenden Proxy null.
X-Forwarded-For IP	x_forwarded_for_ip	Die Liste der IP-Adressen im X-Forwarded-For-Header. Zur Ermittlung der ursprünglichen Client-IP-Adresse, auf die über die Dimension ax_resolved_client_ip zugegriffen wird, verwendet Apigee die Dimensionen ax_true_client_ip und x_forwarded_for_ip.
X-Forwarded-For Proto	x_forwarded_proto	Protokoll, mit dem der Client eine Verbindung zum Router hergestellt hat. Gültige Werte sind http und https.
Zeit
Wochentag	ax_day_of_week	Die aus zwei Buchstaben bestehende Wochentag-Abkürzung, an der die API-Aufrufe vorgenommen wurden. Beispiel: Mo, Di, Mi.
Monat	ax_month_of_year	Der numerische Monat, in dem die API-Aufrufe ausgeführt wurden. Beispiel: 03 für März.
Tageszeit	ax_hour_of_day	Basierend auf einem 24-Stunden-Format die zweistellige Stunde, in der API-Aufrufe getätigt wurden. Beispiel: API-Aufrufe, die in der Stunde zwischen 22:00 Uhr und 23:00 Uhr durchgeführt werden, wären ax_hour_of_day 22. Der Zeitwert ist in UTC.
Zeitzone	ax_geo_timezone	Allgemeine Namen der Zeitzonen, aus denen die API-Aufrufe durchgeführt wurden, z. B. America/New_York und Europe/Dublin.
Woche des Monats	ax_week_of_month	Numerische Woche des Monats. Für API-Aufrufe, die in der 3. Woche eines Monats durchgeführt werden, ist der ax_week_of_month beispielsweise 3.
Standorte
Ort	ax_geo_city	Die Stadt, von der aus die API-Aufrufe ausgeführt wurden.
Kontinent	ax_geo_continent	Der aus zwei Buchstaben bestehende Code des Landes, von dem aus die API-Aufrufe getätigt wurden. Zum Beispiel NA für Nordamerika.
Land	ax_geo_country	Der aus zwei Buchstaben bestehende Code des Landes, von dem aus die API-Aufrufe getätigt wurden. Zum Beispiel US für die USA.
Region	ax_geo_region	Codierter Code für die geografische Region, z. B. STATE-COUNTRY. Beispiel: WA-US für Washington-USA.
Region	ax_dn_region	Name des Apigee-Rechenzentrums, in dem API-Proxys bereitgestellt werden, z. B. us-east-1.
Monetarisierung
Erstellt	created	Derzeit in Apigee-Organisationen verfügbar, nicht in Apigee Hybrid-Organisationen. Unix-Zeitstempel, wenn der Gebührenzeitplan für den Anwendungsentwickler und das API-Produkt hinzugefügt wurde.
Gebührentyp	fees_type	Art der Gebühr. Dabei kann es sich um eine Einrichtungsgebühr, eine wiederkehrende Gebühr oder eine Vorauszahlung handeln. Dieser Wert wird nur ausgefüllt, wenn Sie den Messwert Fees ausgewählt haben.
Währung des Umsatzes	x_apigee_mintng_currency	Die Währung des Transaktionsumsatzes wird auf den Wert der in Ihrer DataCapture-Richtlinie erfassten currency-Monetarisierungsvariable gesetzt. Diese Währung ist mit der Währung von revShareGrossPrice verknüpft. Bei dem Messwert „Gebühren“ handelt es sich um die Währung für die Einrichtungsgebühr, die wiederkehrende Gebühr oder die Vorauszahlungen.
Tarifpaket-ID	x_apigee_mintng_rate_plan_id	Derzeit in Apigee-Organisationen verfügbar, nicht in Apigee Hybrid-Organisationen. Der Monetarisierungstarif für den Anwendungsentwickler.
Transaktionserfolg	x_apigee_mintng_tx_success	Der Monetarisierungsstatus der Transaktion wird auf den Wert der Monetarisierungsvariable transactionSuccess festgelegt, die in Ihrer DataCapture-Richtlinie erfasst wird.

Filter

Mit Filtern können Sie die Ergebnisse auf Messwerte mit bestimmten Merkmalen beschränken. Im Folgenden finden Sie einige Beispielfilter. Verwenden Sie bei der Definition von Filtern Namen im Messwert- und Dimensions-API-Stil.

Hinweis: Filtertext muss in einfache Anführungszeichen gesetzt werden, z. B. 'books'. Verwenden Sie keine doppelten Anführungszeichen.

Gibt Messwerte für API-Proxys mit den Namensbüchern oder der Musik zurück:

filter=(apiproxy in 'books','music')

Gibt Messwerte für API-Proxys mit Namen zurück, die mit m beginnen:

filter=(apiproxy like 'm%')

Gibt Messwerte für API-Proxys mit Namen zurück, die nicht mit m beginnen:

filter=(apiproxy not like 'm%')

Gibt Messwerte für API-Aufrufe mit Antwortstatuscodes zwischen 400 und 599 zurück:

filter=(response_status_code ge 400 and response_status_code le 599)

Gibt Messwerte für API-Aufrufe mit dem Antwortstatuscode 200 und dem Zielantwortcode 404 zurück:

filter=(response_status_code eq 200 and target_response_code eq 404)

Gibt Messwerte für API-Aufrufe mit dem Antwortstatuscode 500 zurück:

filter=(response_status_code eq 500)

Gibt Messwerte für API-Aufrufe zurück, die nicht zu Fehlern geführt haben:

filter=(is_error eq 0)

Gibt Messwerte für API-Aufrufe zurück, die nicht zu Fehlern in null-Antworten geführt haben:

filter=(response_status_code isnot null)

Folgende Operatoren können Sie zum Erstellen von Berichtsfiltern verwenden.

Operator	Beschreibung
in	In Liste aufnehmen
notin	Von Liste ausschließen
is	Verwenden Sie response_status_code is null, um nach Antworten zu filtern, deren Statuscode null lautet.
isnot	Verwenden Sie response_status_code isnot null, um nach Antworten zu filtern, deren Statuscode nicht null ist.
eq	Gleich, ==
ne	Ungleich, !=
gt	Größer als, >
lt	Kleiner als, <
ge	Größer als oder gleich, >=
le	Kleiner als oder gleich, <=
like	Gibt "true" zurück, wenn das Zeichenfolgenmuster mit dem angegebenen Muster übereinstimmt.
not like	Gibt "false" zurück, wenn das Zeichenfolgenmuster mit dem angegebenen Muster übereinstimmt.
similar to	Gibt "true" oder "false" zurück, je nachdem, ob das Muster mit der angegebenen Zeichenfolge übereinstimmt. Es ist mit like vergleichbar, es sei denn, es interpretiert das Muster mithilfe der Definition eines regulären Ausdrucks des SQL-Standards.
not similar to	Gibt "false" oder "true" zurück, je nachdem, ob das Muster mit dem angegebenen String übereinstimmt. Es ist ähnlich wie not like, allerdings wird das Muster mit der Definition eines regulären Ausdrucks durch den SQL-Standard interpretiert.
and	Ermöglicht die Verwendung der AND-Logik, um mehr als einen Filterausdruck einzubeziehen. Der Filter enthält Daten, die alle Bedingungen erfüllen.
or	Ermöglicht die Verwendung der OR-Logik, um verschiedene mögliche Filterausdrücke auszuwerten. Der Filter enthält Daten, die mindestens eine der Bedingungen erfüllen.