Documentation de référence sur les métriques, les dimensions et les filtres d'Analytics

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Cet article est une documentation de référence sur les métriques, les dimensions et les filtres d'analyse. Pour obtenir plus de contexte sur leur utilisation, voir Présentation des données analytiques sur l'API.

Cette page présente les noms des métriques et des dimensions tels qu'ils apparaissent dans l'interface utilisateur et leur utilisation dans des appels d'API.

Métriques

Vous trouverez ci-dessous les métriques d'API que vous pouvez récupérer dans les rapports personnalisés et les appels d'API Apigee.

Métrique Nom à utiliser dans l'API Apigee Functions Description
Nombre moyen de transactions par seconde tps Aucun

Nombre moyen de transactions, c'est-à-dire de requêtes de proxy d'API, par seconde. Sachez que si vous comptez un nombre relativement faible de transactions sur la période, le nombre moyen de transactions par seconde peut sembler égal à zéro dans les rapports personnalisés d'interface utilisateur lorsque le nombre est inférieur à deux décimales.

Syntaxe de l'API : tps

Succès de cache (hit) cache_hit sum (somme)

Nombre de requêtes d'API réussies utilisant le ResponseCache au lieu de la réponse du service cible.

Syntaxe de l'API : sum(cache_hit)

Nombre d'éléments de cache L1 ax_cache_l1_count moy, min, max

Nombre d'éléments dans le cache L1 (en mémoire) par transaction sur une période donnée. Par exemple, si vous choisissez max pour la période d'une journée et que le nombre d'éléments en cache le plus élevé est de 12 pour une transaction spécifique, le nombre sera de 12. Pour avg, s'il y a trois transactions dans la période que vous interrogez et que leur nombre de caches est de 5, 6 et 7, la moyenne est de 6. Le cache L1 est un cache en mémoire, contrairement au cache de base de données L2, comme décrit dans la section Composants internes du cache.

Syntaxe de l'API : avg(ax_cache_l1_count)

Erreurs liées aux règles policy_error sum (somme)

Nombre total d'erreurs liées aux règles sur la période spécifiée.

Les erreurs liées aux règles se produisent généralement en raison de leur conception. Par exemple, la règle VerifyApiKey génère une erreur lorsqu'une clé API non valide est transmise dans la requête, et une règle SpikeArrest génère une erreur si le nombre d'appels d'API dépasse la limite définie dans la règle. Cette métrique est donc utile pour détecter les éventuels problèmes dans vos API. Par exemple, les métriques policy_error, regroupées par dimension developer_app, peuvent vous aider à découvrir l'expiration d'une clé API ou d'un jeton OAuth pour une application donnée. Vous constaterez peut-être qu'un proxy d'API génère de nombreuses erreurs SpikeArrest, et réaliserez donc que la limite de ce proxy ne tient pas compte d'une augmentation du trafic en période de vacances.

Une erreur liée aux règles est uniquement journalisée dans les analyses si elle entraîne un échec du proxy de l'API. Par exemple, si l'attribut continueOnError d'une stratégie est défini sur true, le proxy d'API continue à traiter une requête, même en cas d'échec de la règle. Dans ce cas, les erreurs liées aux règles ne sont pas journalisées dans les analyses.

La dimension du nom de la règle produisant une erreur (ax_execution_fault_policy_name) sert à regrouper les erreurs liées aux règles par nom.

Une défaillance de cible (telle que 404 ou 503) ne compte pas pour un échec de règle, mais plutôt comme un échec de proxy d'API (is_error).

Syntaxe de l'API : sum(policy_error)

Erreurs de proxy is_error sum (somme)

Nombre total de fois où les proxys d'API ont échoué sur la période spécifiée. L'échec de proxy peut survenir en cas d'échec d'une règle ou d'exécution, telle qu'un code 404 ou 503 renvoyé par le service cible.

La dimension Proxy (apiproxy) est utile pour regrouper les erreurs de proxy d'API par proxy.

Syntaxe de l'API : sum(is_error)

Latence de traitement des requêtes request_processing_latency moy, min, max

Durée (moyenne, minimale ou maximale) en millisecondes nécessaires à Apigee pour prendre en charge le traitement des requêtes entrantes. Cette durée commence lorsque la demande est soumise à Apigee et se termine lorsque Apigee transmet la demande au service cible.

À l'aide des différentes dimensions, vous pouvez examiner les latences de traitement des requêtes par proxy d'API, application de développeur, région, etc.

Syntaxe de l'API : max(request_processing_latency)

Taille d'une requête request_size somme, moyenne, min, max

Taille de la charge utile de la demande reçue par Apigee, en octets.

Syntaxe de l'API : avg(request_size)

Cache de réponse exécuté ax_cache_executed sum (somme)

Nombre total d'exécutions d'une règle ResponseCache au cours de la période donnée.

Étant donné que la règle ResponseCache est associée à deux emplacements d'un proxy d'API (une fois dans la demande et une fois dans la réponse), elle s'exécute généralement deux fois dans un appel d'API. Un cache GET et un cache PUT comptent chacun pour une exécution.

Toutefois, l'exécution du cache de réponse est égale à 0 si l'élément <SkipCacheLookup> de la règle renvoie la valeur true (dans la requête) et 0 si l'élément <SkipCachePopulation> de la règle renvoie valeur true (dans la réponse).

Dans l'outil Debug, vous pouvez cliquer sur l'icône ResponseCache dans un appel d'API exécuté et afficher la variable de flux responsecache.executed pour vérifier si l'exécution de cache a bien eu lieu (valeur de 1).

Syntaxe de l'API : sum(ax_cache_executed)

Latence de traitement des réponses response_processing_latency moy, min, max

Durée (moyenne, minimale ou maximale) en millisecondes nécessaire à Apigee pour traiter les réponses de l'API. Cette durée commence lorsque le proxy d'API reçoit la réponse du service cible et se termine lorsque Apigee transmet la réponse à l'appelant d'origine.

À l'aide des différentes dimensions, vous pouvez examiner les latences de traitement de réponse par proxy d'API, région, etc.

Syntaxe de l'API : min(response_processing_latency)

Taille d'une réponse response_size somme, moyenne, min, max

Taille de la charge utile de réponse renvoyée au client, en octets.

Syntaxe de l'API : max(response_size)

Erreurs de cible target_error sum (somme)

Nombre total de réponses 5xx du service cible. Ce sont des erreurs de service cible non causées par Apigee.

Syntaxe de l'API : sum(target_error)

Temps de réponse cible target_response_time somme, moyenne, min, max

Durée (somme, moyenne, minimale ou maximale) en millisecondes, pendant laquelle le serveur cible répond à un appel. Cette métrique vous indique les performances des serveurs cibles. Cette durée commence lorsqu'Apigee transmet une requête au service cible et se termine lorsque Apigee reçoit la réponse.

Sachez que si un appel d'API renvoie une réponse du cache (à l'aide de la règle ResponseCache, par exemple), l'appel n'atteindra jamais le service cible et aucune métrique de temps de réponse cible n'est journalisée.

Syntaxe de l'API : avg(target_response_time)

Temps de réponse total total_response_time somme, moyenne, min, max

Durée (somme, moyenne, minimale ou maximale ) en millisecondes entre la réception de la requête par Apigee et le renvoi de la réponse au client. La durée comprend la surcharge du réseau (temps nécessaire aux équilibreurs de charge et aux routeurs), la latence de traitement des requêtes, la latence de traitement des réponses et le temps de réponse cible (si la réponse est émise par le service cible au lieu du cache).

À l'aide des différentes dimensions, vous pouvez examiner les latences de traitement par proxy d'API, application de développeur, région, etc.

Syntaxe de l'API : avg(total_response_time)

Trafic message_count sum (somme)

Nombre total d'appels d'API traités par Apigee au cours de la période spécifiée.

Utilisez les dimensions pour regrouper le comptage du trafic de la manière qui vous convient le mieux.

Syntaxe de l'API : sum(message_count)

Monétisation
Frais fees somme, moyenne, min, max

Montant représentant les frais de configuration, les frais récurrents ou les crédits prépayés.

Syntaxe de l'API : sum(fees)

Part des revenus du développeur x_apigee_mintng_dev_share somme, moyenne, min, max

Part du développeur dans les revenus associés à une transaction. Apigee ne calcule la part du développeur que si vous avez activé le partage des revenus dans votre plan tarifaire.

La part du développeur est calculée à l'aide de la formule suivante :

x_apigee_mintng_dev_share = revShareGrossPrice * (share percentage)

La valeur correspondant au pourcentage de sa part est extraite de votre plan tarifaire.

Syntaxe de l'API : sum(x_apigee_mintng_dev_share)

Prix de monétisation x_apigee_mintng_price somme, moyenne, min, max

Revenu total d'une transaction. Le revenu d'une transaction est défini sur la valeur de la variable de monétisation revShareGrossPrice capturée dans votre règle DataCapture.

Syntaxe de l'API : sum(x_apigee_mintng_price)

Multiplicateur de prix d'API x_apigee_mintng_price_multiplier somme, moyenne, min, max

Facteur (multiplicateur) par lequel le coût par transaction est multiplié. Le coût par transaction est spécifié dans les frais basés sur la consommation du plan tarifaire.

Syntaxe de l'API : avg(x_apigee_mintng_price_multiplier)

Taux de monétisation x_apigee_mintng_rate somme, moyenne, min, max

Taux facturé pour une transaction. Le taux facturé pour une transaction est calculé à l'aide de la formule suivante :

x_apigee_mintng_rate = (consumption-based pricing rate) * perUnitPriceMultiplier value

La valeur du taux de tarification basée sur la consommation est extraite de votre plan tarifaire. La valeur perUnitPriceMultiplier n'est multipliée que si la variable est capturée par la règle DataCapture.

Syntaxe de l'API : sum(x_apigee_mintng_rate)

Variables

Les dimensions vous permettent d'afficher les métriques dans des groupes pertinents. Par exemple, le comptage total du trafic devient bien plus efficace lorsque vous l'affichez pour chaque application de développeur ou proxy d'API.

Voici les dimensions prêtes à l'emploi qu'Apigee fournit.

Dimension Nom à utiliser dans l'API Apigee Description
Jeton d'accès access_token Jeton d'accès OAuth de l'utilisateur final de l'application.
Produit d'API api_product
  • Nom du produit d'API contenant les proxys d'API appelés. Pour obtenir cette dimension, les applications de développeur qui effectuent les appels doivent être associées à un ou plusieurs produits d'API contenant les proxys d'API, et les proxys appelés doivent rechercher une clé API ou un jeton OAuth transmis avec l'appel d'API. La clé ou le jeton est associé à un produit d'API. Pour en savoir plus, consultez l'article Générer des données d'analyse complètes.

    Si les critères ci-dessus ne sont pas remplis, la valeur (not set) s'affiche. Voir également la section Signification d'une valeur d'entité d'analyse "(not set)".

  • Dans les métriques associées aux frais, il s'agira d'un produit d'API correspondant au plan tarifaire pour lequel des frais de configuration ou des frais récurrents doivent être appliqués. La valeur sera vide pour les crédits prépayés.

Clé du cache ax_cache_key

Clé contenant la valeur du ResponseCache consulté. Pour plus d'informations sur la construction de la clé pour le cache de réponse, consultez l'article Règle ResponseCache.

Dans l'outil de débogage, lorsque vous sélectionnez une règle ResponseCache qui lit ou écrit dans le cache, vous pouvez voir cette valeur dans la variable de flux responsecache.cachekey.

Nom du cache ax_cache_name

Nom du cache contenant les clés/valeurs utilisées par la règle ResponseCache, précédé du préfixe orgName__envName__. Par exemple, si l'organisation est myorgf, l'environnement est test, et le nom du cache est myCache, ax_cache_name est foo__test__myCache.

Dans l'outil de débogage, lorsque vous sélectionnez une règle ResponseCache, vous pouvez voir cette valeur dans la variable de flux responsecache.cachename.

Source du cache ax_cache_source

Niveau de cache (base de données L1 ou L2 en mémoire) à partir duquel ResponseCache a été récupéré. Cette dimension indique également CACHE_MISS lorsque la réponse a été envoyée par la cible au lieu du cache (le cache de la réponse a été actualisé avec la réponse de la cible) ou lorsqu'une clé de cache de la requête n'est pas valide. Les clés de cache sont limitées à 2 Ko.

Dans l'outil de débogage, lorsque vous sélectionnez la règle ResponseCache, vous pouvez voir cette valeur dans la variable de flux responsecache.cachesource.

Pour plus d'informations sur les niveaux de cache, reportez-vous à la section Composants internes du cache.

ID client client_id

Clé client (clé API) de l'application de développeur qui effectue les appels d'API, qu'elle soit transmise dans la requête en tant que clé API ou incluse dans les jetons OAuth.

Pour obtenir cette dimension, les proxys recevant des appels doivent être configurés pour rechercher une clé API ou un jeton OAuth valide. Les applications de développeur obtiennent des clés API, qui peuvent être utilisées pour générer des jetons OAuth, lorsque les applications sont enregistrées dans Apigee. Pour en savoir plus, consultez l'article Générer des données d'analyse complètes.

Si les critères ci-dessus ne sont pas remplis, la valeur (not set) s'affiche. Voir également la section Signification d'une valeur d'entité d'analyse "(not set)".

Application de développeur developer_app

Application de développeur enregistrée dans Apigee effectuant des appels d'API.

Pour obtenir cette dimension, les applications doivent être associées à un ou plusieurs produits d'API contenant les proxys d'API appelés, puis les proxys doivent rechercher une clé API ou un jeton OAuth envoyé avec l'appel d'API. La clé ou le jeton identifie l'application de développeur. Pour plus d'informations, consultez l'article Générer des données d'analyse complètes.

Si les critères ci-dessus ne sont pas remplis, la valeur (not set) s'affiche. Voir également la section Signification d'une valeur d'entité d'analyse "(not set)".

Adresse e-mail du développeur developer_email
  • Adresse e-mail des développeurs enregistrés par Apigee dont l'application a effectué les appels d'API.

    Pour obtenir cette dimension, les développeurs doivent associer les applications à un ou plusieurs produits d'API contenant les proxys d'API appelés, puis les proxys doivent rechercher une clé API ou un jeton OAuth envoyé avec l'appel d'API. La clé ou le jeton identifie l'application de développeur. Pour plus d'informations, consultez l'article Générer des données d'analyse complètes.

    Si les critères ci-dessus ne sont pas remplis, la valeur (not set) s'affiche. Voir également la section Signification d'une valeur d'entité d'analyse "(not set)".

  • Concernant les métriques associées aux frais, la facturation des frais de configuration, des frais récurrents ou des crédits prépayés est imputée au développeur.
ID de développeur developer

ID de développeur unique généré par Apigee sous la forme org_name@@@unique_id.

Pour obtenir cette dimension, les développeurs doivent associer les applications à un ou plusieurs produits d'API qui contiennent les proxys d'API appelés, puis les proxys doivent rechercher une clé API ou un jeton OAuth envoyé avec les appels d'API. La clé ou le jeton identifie le développeur. Pour en savoir plus, consultez l'article Générer des données d'analyse complètes.

Si les critères ci-dessus ne sont pas remplis, la valeur (not set) s'affiche. Voir également la section Signification d'une valeur d'entité d'analyse "(not set)".

Environnement environment Environnement Apigee de déploiement des proxys API. Par exemple, test ou prod.
Code d'erreur de l'erreur ax_edge_execution_fault_code

Le code d'erreur de l'erreur. Par exemple : messaging.adaptors.http.flow.GatewayTimeout

Nom du flux en cas d'erreur ax_execution_fault
  _flow_name

Nom du flux dans un proxy d'API qui a généré une erreur. Par exemple, PreFlow, PostFlow, ou le nom d'un flux conditionnel que vous avez créé.

Notez que le nom complet à utiliser dans l'API Apigee est ax_execution_fault_flow_name, sans saut de ligne.

Si aucune erreur ne s'est produite, la valeur (not set) s'affiche.

Ressource de flux flow_resource Utilisation avec Apigee uniquement. Consultez l'article Comment utiliser la dimension "Flux de ressources" dans Analytics si vous êtes curieux.
État du flux en cas d'erreur ax_execution_fault
  _flow_state

Non des états de flux de proxy d'API qui ont généré des erreurs, comme PROXY_REQ_FLOW ou TARGET_RESP_FLOW.

Notez que le nom complet à utiliser dans l'API Apigee est ax_execution_fault_flow_state, sans saut de ligne.

ID de flux de passerelle gateway_flow_id Lorsque les appels d'API passent par Apigee, chaque appel reçoit son propre ID de flux de passerelle. Exemple : rrt329ea-12575-114653952-1. L'ID de flux de passerelle est utile pour distinguer les métriques en cas de nombre élevé de tâches par seconde, lorsque d'autres dimensions telles que l'organisation, l'environnement et l'horodatage sont identiques entre les appels.
Organisation organization Organisation Apigee de déploiement des proxys d'API.
Nom de la règle en cas d'erreur ax_execution_fault
  _policy_name

Nom de la règle qui a généré une erreur et entraîné l'échec de l'appel d'API.

Notez que le nom complet à utiliser dans l'API Apigee est ax_execution_fault_policy_name, sans saut de ligne.

Si une règle génère une erreur, mais que l'attribut racine de la règle continueOnError est défini sur true, le flux du proxy d'API se poursuit sans échec, et l'échec de la règle n'est pas comptabilisé dans cette dimension.

Proxy apiproxy Nom de la machine (et non le nom à afficher) d'un proxy d'API.
Chemin de base du proxy proxy_basepath

Chemin de base configuré sur le proxy d'API ProxyEndpoint. Le chemin de base n'inclut pas la partie correspondant au domaine et au port de l'URL du proxy d'API. Par exemple, si l'URL de base d'un proxy d'API est https://apigeedocs-test.apigee.net/releasenotes/, le chemin de base est /releasenotes.

La valeur est également stockée dans la variable de flux proxy.basepath.

Type de déploiement du proxy proxy_deployment_type

Type de proxy d'API pour les proxys déployés. La spécification d'un type de proxy limite les résultats à ce type de proxy. Cette dimension ne s'applique qu'aux utilisateurs du paiement à l'usage et de l'abonnement 2024, qui utilisent des types de proxys. Les valeurs potentielles sont STANDARD, EXTENSIBLE, ou non définies.

Suffixe du chemin de proxy proxy_pathsuffix

Chemin d'accès à la ressource ajouté au chemin de base du proxy d'API. Par exemple, si l'URL de base d'un proxy d'API est https://apigeedocs-test.apigee.net/hello/ et qu'un appel est effectué à https://apigeedocs-test.apigee.net/hello/json, le pathsuffix est /json.

Si aucun pathsuffix n'est utilisé, la valeur est vide.

La valeur est également stockée dans la variable de flux proxy.pathsuffix.

Révision du proxy apiproxy_revision Numéro de révision du proxy d'API ayant géré les appels d'API. Cela ne signifie pas nécessairement la dernière révision d'un proxy d'API. Si un proxy d'API comporte 10 révisions, la 8e révision peut actuellement être déployée. En outre, une API peut compter plusieurs révisions déployées tant que les révisions disposent chemins de base différents, comme décrit dans la section Déployer des proxys.
Adresse IP client résolue ax_resolved_client_ip

Adresse IP du client d'origine. La valeur de la dimension ax_resolved_client_ip est calculée à partir des valeurs des dimensions ax_true_client_ip et x_forwarded_for_ip.

Sachez que lorsque vous utilisez des produits de routage tels qu'Akamai pour capturer les adresses IP réelles des clients, l'adresse IP du client est transmise à Apigee dans l'en-tête HTTP True-Client-IP, qui est ensuite utilisée pour définir la dimension ax_true_client_ip.

La valeur de la dimension ax_resolved_client_ip est calculée comme suit :

  1. Si ax_true_client_ip n'est pas nul et ne contient pas d'adresse IP locale, définissez ax_resolved_client_ip sur ax_true_client_ip.
  2. Sinon, définissez ax_resolved_client_ip sur la première adresse IP non locale de x_forwarded_for_ip.
  3. Si ax_true_client_ip et x_forwarded_for_ip ne contiennent que des adresses IP locales, définissez ax_resolved_client_ip sur la dernière adresse IP locale dans x_forwarded_for_ip.
  4. Si ax_true_client_ip et x_forwarded_for_ip sont tous deux nuls, définissez ax_resolved_client_ip sur (not set).
  5. Si ax_true_client_ip est une adresse IP locale et que x_forwarded_for_ip est nul, définissez ax_resolved_client_ip sur (not set).
Code d'état de la réponse response_status_code Code d'état de la réponse HTTP transmis d'Apigee au client, tel que 200, 404, 503, etc. Dans Apigee, le code d'état de la réponse de la cible peut être écrasé par des règles telles que la règle d'attribution de message et celle de génération d'erreur, et c'est pourquoi cette dimension peut différer du code de réponse cible (target_response_code).
Hôte virtuel virtual_host Nom de l'hôte virtuel auquel l'appel d'API a été effectué. Pour en savoir plus, consultez la section À propos des environnements et des groupes d'environnements.
Entrant/client
Adresse IP du client client_ip Adresse IP du système qui atteint le routeur, tel que le client d'origine (proxy_client_ip) ou un équilibreur de charge. Lorsqu'il existe plusieurs adresses IP dans l'en-tête X-Forwarded-For, il s'agit de la dernière adresse IP répertoriée.
Catégorie d'appareil ax_ua_device_category Type d'appareil à partir duquel l'appel API a été effectué, tel que Tablet ou Smartphone.
Famille d'OS ax_ua_os_family Famille de système d'exploitation de l'appareil effectuant l'appel, telle que Android ou iOS.
Version d'OS ax_ua_os_version

Version du système d'exploitation de l'appareil effectuant l'appel.

Il est utile de l'utiliser comme deuxième dimension détaillée avec la famille du système d'exploitation (ax_ua_os_family) pour afficher les versions des systèmes d'exploitation.

Adresse IP du client proxy proxy_client_ip

Adresse IP du client à l'origine de l'appel, stockée dans la variable de flux proxy.client.ip. Il s'agit souvent de l'adresse X-Forwarded-For de l'appel entrant, qui correspond à l'adresse IP reçue par Apigee lors du dernier handshake TCP externe. Il peut s'agir du client à l'origine de l'appel ou d'un équilibreur de charge. Lorsqu'il existe plusieurs adresses IP dans l'en-tête X-Forwarded-For, il s'agit de la dernière adresse IP répertoriée.

Adresse IP du client référée ax_true_client_ip

Lorsque vous utilisez des produits de routage tels qu'Akamai pour capturer les adresses IP réelles des clients, les adresses IP client sont transmises à Apigee dans l'en-tête HTTP True-Client-IP. Cette dimension capture les adresses IP réelles à partir de cet en-tête.

Pour déterminer l'adresse IP du client d'origine, accessible via la dimension ax_resolved_client_ip, Apigee utilise les dimensions ax_true_client_ip et x_forwarded_for_ip.

Chemin de requête request_path

Chemin d'accès à la ressource (hors domaine) du service cible, à l'exclusion des paramètres de requête.

Par exemple, l'exemple de cible Apigee http://mocktarget.apigee.net comprend plusieurs ressources, dont /user, qui renvoie un message d'accueil. Quelle que soit la manière dont votre proxy d'API appelle http://mocktarget.apigee.net/user, le chemin de requête est /user.

URI de la requête request_uri

Chemin d'accès à la ressource (hors domaine) du service cible, y compris les paramètres de requête.

Par exemple, l'exemple de cible http://mocktarget.apigee.net Apigee comprend plusieurs ressources, telles que la ressource /user?user={name} et le paramètre de requête, qui permettent de renvoyer un message d'accueil personnalisé au nom spécifié. Quelle que soit la manière dont votre proxy d'API appelle http://mocktarget.apigee.net/user?user=Dude, l'URI de la demande est /user?user=Dude.

Demander un verbe request_verb Verbe de requête HTTP dans les requêtes d'API, tel que GET, POST, PUT, DELETE.
User-agent useragent

Nom de l'user-agent ou du software-agent utilisé pour effectuer l'appel d'API. Par exemple :

  • Un pixel XL effectuant un appel via Chrome : 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
  • Un iPad effectuant un appel via Chrome : 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 depuis un terminal : curl/7.51.0
Famille d'user-agent ax_ua_agent_family Famille de l'user-agent, tel que Chrome Mobile ou curl.
Type d'user-agent ax_ua_agent_type Type d'user-agent, tel que Browser, Mobile Browser, Library, etc.
Version d'user-agent ax_ua_agent_version

Version de l'user-agent.

Il est utile d'utiliser cet élément comme deuxième dimension détaillée avec la famille d'user-agent (ax_ua_agent_family) pour afficher la version de la famille d'agent.

Sortant/cible
Cible target Point de terminaison cible qui a traité la requête. Par exemple, default.
Chemin de base cible target_basepath

Chemin d'accès à la ressource (hors domaine) du service cible, à l'exclusion des paramètres de requête, défini dans le <TargetEndpoint> du proxy.

Par exemple, supposons qu'un proxy d'API appelle la cible suivante :

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

Dans cet exemple, la valeur du chemin de base cible est /user.

Si la cible était la suivante :

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

la valeur du chemin de base serait nulle.

Dans l'outil de débogage, lorsque vous sélectionnez l'icône AX à la fin du schéma de flux, la variable de flux target.basepath est mappée sur la dimension "target_basepath".

Nom du service gRPC x_apigee_grpc_service_name Applicable uniquement lorsque le service cible est un service gRPC. Nom du service gRPC. Pour en savoir plus sur les proxys gRPC, consultez la page Créer des proxys d'API gRPC.
État gRPC x_apigee_grpc_status Applicable uniquement lorsque le service cible est un service gRPC. État de la requête gRPC. Pour en savoir plus sur les proxys gRPC, consultez la page Créer des proxys d'API gRPC.
Hôte cible target_host Hôte du service cible. Par exemple, si un proxy d'API appelle http://mocktarget.apigee.net/help, l'hôte cible est mocktarget.apigee.net.
Adresse IP cible target_ip Adresse IP du service cible renvoyant la réponse au proxy d'API.
Code de réponse cible target_response_code

Code d'état de la réponse HTTP renvoyé par le service cible au proxy d'API, tel que 200, 404, 503, etc.

Une valeur null signifie que la requête n'a jamais atteint le service cible. Cela se produit lorsque la réponse est diffusée par la règle ResponseCache ou en cas d'échec du traitement de la requête.

Cette méthode est différente de la dimension Code d'état de la réponse (response_status_code).

Nom du RPC gRPC x_apigee_grpc_rpc_name Applicable uniquement lorsque le service cible est un service gRPC. Nom du RPC. Pour en savoir plus sur les proxys gRPC, consultez la page Créer des proxys d'API gRPC.
URL cible target_url

URL complète du service cible défini dans le TargetEndpoint d'un proxy d'API.

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

Dans cet exemple, l'url cible est http://mocktarget.apigee.net/user?user=Dude.

Notez que l'URL peut également être remplacée lors du traitement du proxy d'API avec la variable de flux target.url.

Dans Chaînage de proxy, l'URL cible du proxy appelant est nulle.

X-Forwarded-For IP x_forwarded_for_ip

Liste des adresses IP de l'en-tête X-Forwarded-For.

Pour déterminer l'adresse IP du client d'origine, accessible via la dimension ax_resolved_client_ip, Apigee utilise les dimensions ax_true_client_ip et x_forwarded_for_ip.

X-Forwarded-For Proto x_forwarded_proto

Protocole utilisé par le client pour se connecter au routeur. Les valeurs valides incluent http ou https.

Time
Jour de la semaine ax_day_of_week Abréviation à trois lettres du jour durant lequel les appels d'API ont été effectués. Par exemple, lun., mar., mer.
Mois ax_month_of_year Mois numérique durant duquel les appels d'API ont été effectués. Par exemple, 03 pour le mois de mars.
Heure de la journée ax_hour_of_day

Heure (format 24 heures) à 2 chiffres à laquelle les appels d'API ont été effectués. Par exemple, pour les appels d'API effectués entre 22h00 et 23h00, ax_hour_of_day indique 22.

La valeur temporelle est exprimée en UTC.

Fuseau horaire ax_geo_timezone Noms communs des fuseaux horaires d'appels d'API, tels que America/New_York et Europe/Dublin.
Semaine du mois ax_week_of_month Semaine numérique du mois. Par exemple, pour les appels d'API effectués au cours de la troisième semaine d'un mois, ax_week_of_month est égal à 3.
Location (Emplacement)
Ville ax_geo_city Ville à partir de laquelle les appels d'API ont été effectués.
Continent ax_geo_continent Code à deux lettres du continent à partir duquel les appels API ont été effectués. Par exemple, NA pour l'Amérique du Nord.
Country (Pays) ax_geo_country Code à deux lettres du pays à partir duquel les appels API ont été effectués. Par exemple, US pour les États-Unis.
Région géographique ax_geo_region Le code composé pour la région géographique, sous le format STATE-COUNTRY. Par exemple, WA-US pour Washington-États-Unis.
Region (Région) ax_dn_region Nom du centre de données Apigee sur lequel des proxys d'API sont déployés, tel que us-east-1.
Monétisation
Création created

Actuellement disponible dans les organisations Apigee, mais pas dans les organisations Apigee hybrid.

Horodatage Unix lorsque le barème des frais a été ajouté pour le développeur d'applications et le produit d'API.

Type de frais fees_type Type de frais. Il peut s'agir de frais de configuration, de frais récurrents ou de crédits prépayés. Cette valeur n'est renseignée que si vous avez sélectionné la métrique Fees.
Devise du revenu x_apigee_mintng_currency
  • La devise du revenu de la transaction est définie sur la valeur de la variable de monétisation currency capturée dans votre règle DataCapture. Cette devise est associée à la devise de revShareGrossPrice.
  • Concernant les métriques associées aux frais, il s'agit de la devise des frais de configuration, des frais récurrents ou des crédits prépayés.
Identifiant du plan tarifaire x_apigee_mintng_rate_plan_id

Actuellement disponible dans les organisations Apigee, mais pas dans les organisations Apigee hybrid

Plan de taux de monétisation pour le développeur d'applications.

Réussite de la transaction x_apigee_mintng_tx_success L'état de monétisation de la transaction est défini sur la valeur de la variable de monétisation transactionSuccess capturée dans votre règle DataCapture.

Filtres

Les filtres vous permettent de limiter les résultats à des métriques présentant des caractéristiques spécifiques. Voici quelques exemples de filtres. Utilisez des noms de type API et de dimension lors de la définition des filtres

Renvoie les métriques des proxys d'API avec le nom du livre ou de la musique :

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

Renvoie les métriques des proxys d'API dont le nom commence par m :

filter=(apiproxy like 'm%')

Renvoie les métriques des proxys d'API dont le nom ne commence pas par m :

filter=(apiproxy not like 'm%')

Renvoie des métriques pour les appels d'API avec un code d'état de réponse compris entre 400 et 599 :

filter=(response_status_code ge 400 and response_status_code le 599)

Renvoie des métriques pour les appels d'API avec un code d'état de réponse de 200 et un code de réponse cible de 404 :

filter=(response_status_code eq 200 and target_response_code eq 404)

Renvoie des métriques pour les appels d'API avec un code d'état de réponse de 500 :

filter=(response_status_code eq 500)

Renvoie les métriques des appels d'API qui n'ont pas entraîné d'erreur :

filter=(is_error eq 0)

Renvoie les métriques des appels d'API qui n'ont pas renvoyé de réponses null :

filter=(response_status_code isnot null)

Vous trouverez ci-dessous des opérateurs que vous pouvez utiliser pour créer des filtres de rapport.

Opérateur Description
in Inclure dans la liste
notin Exclure de la liste
is Utilisez response_status_code is null pour filtrer les réponses dont le code d'état est null.
isnot Utilisez response_status_code isnot null pour filtrer les réponses dont le code d'état est différent de null.
eq Égal à, ==
ne Différent de, !=
gt Supérieur à, >
lt Inférieur à, <
ge Supérieur ou égal à, >=
le Inférieur ou égal à, <=
like Renvoie true si le modèle de chaîne correspond au modèle fourni.
not like Renvoie false si le modèle de chaîne correspond au modèle fourni.
similar to Renvoie true ou false selon la correspondance du modèle à la chaîne donnée. Il est semblable à like, sauf qu'il interprète le modèle à l'aide de la définition d'une expression régulière donnée par le standard SQL.
not similar to Renvoie false ou true selon la correspondance du modèle à la chaîne donnée. Il est semblable à not like, sauf qu'il interprète le modèle à l'aide de la définition d'une expression régulière donnée par le standard SQL.
and Vous permet d'utiliser AND pour inclure plus d'une expression de filtre. Le filtre inclut des données qui répondent à toutes les conditions.
or Vous permet d'utiliser OR pour évaluer différentes expressions de filtre possibles. Le filtre inclut des données qui répondent à au moins une des conditions.