Referencia sobre las métricas, las dimensiones y los filtros de Analytics

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Este tema es una referencia para las métricas, las dimensiones y los filtros de estadísticas. Para obtener más contexto sobre su uso, consulta la descripción general de las estadísticas de API.

En este tema, se muestran los nombres de las métricas y las dimensiones a medida que aparecen en la IU y que debes usarlas en las llamadas a la API.

Métricas

A continuación, se muestran las métricas de la API que puedes recuperar en los informes personalizados y las llamadas a la API de Apigee.

Métrica Nombre para usar en la API de Apigee Funciones Descripción
Transacciones promedio por segundo tps Ninguna

Cantidad promedio de transacciones, es decir las solicitudes de proxy de API, que se realizan por segundo. Ten en cuenta que si tienes una cantidad relativamente baja de transacciones durante el período, la cantidad promedio de transacciones por segundo podría parecer de cero en los informes personalizados de la IU si la cantidad es inferior a dos decimales.

Sintaxis de la API: tps

Acierto de caché cache_hit suma

Cantidad de solicitudes a la API correctas que usan ResponseCache en lugar de la respuesta del servicio de destino.

Sintaxis de la API: sum(cache_hit)

Recuento de elementos de la caché L1 ax_cache_l1_count promedio, mínimo, máximo

Cantidad de elementos en caché L1 (en memoria) por transacción durante un período determinado. Por ejemplo, si eliges max para el período de un día y durante ese día la cantidad más alta de elementos en la caché es de 12 para una transacción específica, entonces el conteo será 12. Para avg, si hay tres transacciones en el período que consultas y sus recuentos de caché son 5, 6 y 7, el promedio será 6. La caché de L1 es la caché en la memoria, en lugar de la caché de la base de datos de L2, como se describe en Aspectos internos de la caché.

Sintaxis de la API: avg(ax_cache_l1_count)

Errores de política policy_error suma

La cantidad total de errores de políticas durante el período especificado.

Por lo general, los errores de políticas suceden de forma intrínseca. Por ejemplo, la política VerifyApiKey genera un error cuando se pasa una clave de API no válida en la solicitud y una política SpikeArrest muestra un error si la cantidad de llamadas a la API supera el límite definido en la política. Por lo tanto, esta métrica es útil para encontrar posibles problemas en las API. Por ejemplo, las métricas policy_error, que agrupa la dimensión developer_app, pueden ayudarte a descubrir que una clave de API o un token de OAuth venció para una app determinada o a descubrir que un proxy de API específico genera muchos errores de política SpikeArrest, lo que te ayuda a descubrir que el límite de aumento de tráfico del proxy no toma en cuenta un aumento del tráfico de un feriado.

Se registra un error de política en las estadísticas solo si genera un error en el proxy de API. Por ejemplo, si el atributo continueOnError de una política se configura como true, el proxy de la API continuará procesando una solicitud, incluso si la política falla. En ese caso, no se registrará un error de política en las estadísticas.

La dimensión del nombre de la política del error (ax_execution_fault_policy_name) es útil para agrupar errores de políticas por nombre de política.

Una falla en el destino (como 404 o 503) no se cuenta como una falla en la política. Estas se cuentan como fallas en el proxy de la API (is_error).

Sintaxis de la API: sum(policy_error)

Errores del proxy is_error suma

La cantidad total de veces que los proxies de API fallaron durante el período especificado. El error de proxy puede ocurrir cuando falla una política o cuando se produce una falla en el entorno de ejecución, como 404 o 503 del servicio de destino.

La dimensión de proxy (apiproxy) es útil para agrupar fallas de proxy de API por proxy.

Sintaxis de la API: sum(is_error)

Latencia de procesamiento de solicitudes request_processing_latency promedio, mínimo, máximo

La cantidad de tiempo (promedio, mínimo o máximo) en milisegundos que tarda Apigee en procesar las solicitudes entrantes. El tiempo comienza cuando la solicitud llega a Apigee y finaliza cuando Apigee la reenvía al servicio de destino.

Si usas dimensiones diferentes, puedes examinar las latencias de procesamiento de solicitudes por proxy de API, app de desarrollador y región, entre otros.

Sintaxis de la API: max(request_processing_latency)

Tamaño de la solicitud request_size suma, promedio, mínimo, máximo

El tamaño de la carga útil de la solicitud que recibió Apigee, en bytes.

Sintaxis de la API: avg(request_size)

Ejecuciones de la caché de respuesta ax_cache_executed suma

Cantidad total de veces que se ejecutó una política ResponseCache durante el período determinado.

Debido a que la política ResponseCache se adjunta en dos lugares de un proxy de API (una vez en la solicitud y una vez en la respuesta), por lo general, se ejecuta dos veces en una llamada a la API. Un GET de caché y un PUT de caché se cuentan como una ejecución.

Sin embargo, la ejecución de la caché de respuesta es 0 si el elemento <SkipCacheLookup> de la política se evalúa como verdadero (en la solicitud) y 0 si el elemento <SkipCachePopulation> de la política se evalúa como verdadero (en la respuesta).

En la Herramienta de depuración, puedes hacer clic en el ícono ResponseCache en una llamada a la API ejecutada y ver la variable de flujo responsecache.executed para ver si hubo o no una ejecución de la caché (un valor de 1).

Sintaxis de la API: sum(ax_cache_executed)

Latencia de procesamiento de respuestas response_processing_latency promedio, mínimo, máximo

La cantidad de tiempo (promedio, mínimo o máximo) en milisegundos que tarda Apigee en procesar las respuestas de API. El tiempo comienza cuando el proxy de API recibe la respuesta del servicio de destino y finaliza cuando Apigee reenvía la respuesta al emisor original.

Si usas diferentes dimensiones, puedes examinar las latencias de procesamiento de respuesta por proxy de API y región, entre otros.

Sintaxis de la API: min(response_processing_latency)

Tamaño de la respuesta response_size suma, promedio, mínimo, máximo

El tamaño de la carga útil de la respuesta que se muestra al cliente, en bytes.

Sintaxis de la API: max(response_size)

Errores del destino target_error suma

Cantidad total de respuestas 5xx del servicio de destino. Apigee no genera estos son errores del servicio de destino.

Sintaxis de la API: sum(target_error)

Tiempo de respuesta del destino target_response_time suma, promedio, mínimo, máximo

La cantidad de tiempo (suma, promedio, mínimo o máximo) en milisegundos que el servidor de destino tarda en responder a una llamada. Esta métrica te indica el rendimiento de los servidores de destino. El tiempo comienza cuando Apigee reenvía una solicitud al servicio de destino y finaliza cuando Apigee recibe la respuesta.

Ten en cuenta que si una llamada a la API muestra una respuesta de la caché (por ejemplo, con la política ResponseCache), la llamada nunca alcanzará el servicio de destino y no se registrarán métricas de tiempo de respuesta de destino.

Sintaxis de la API: avg(target_response_time)

Tiempo total de respuesta total_response_time suma, promedio, mínimo, máximo

La cantidad de tiempo (suma, promedio, mínimo o máximo) en milisegundos desde que Apigee recibe una solicitud de un cliente hasta que Apigee envía la respuesta al cliente. En el tiempo, se incluye la sobrecarga de red (como el tiempo que tardan los balanceadores de cargas y los routers para realizar su trabajo) y solicitar la latencia de procesamiento, la latencia de procesamiento de respuestas y el tiempo límite del destino (si la respuesta se entrega desde el servicio de destino, en lugar de desde la caché).

Si usas dimensiones diferentes, puedes examinar las latencias de procesamiento por proxy de API, app de desarrollador y región, entre otros.

Sintaxis de la API: avg(total_response_time)

Tráfico message_count suma

La cantidad total de llamadas a la API que procesa Apigee en el período especificado.

Usa dimensiones para agrupar recuentos de tráfico de formas que sean más significativas para ti.

Sintaxis de la API: sum(message_count)

Monetización
Tarifas fees suma, promedio, mínimo, máximo

Importe que representa la tarifa de configuración, las tarifas recurrentes o las recargas de prepago.

Sintaxis de la API: sum(fees)

Porcentaje de ingresos del desarrollador x_apigee_mintng_dev_share suma, promedio, mínimo, máximo

Porcentaje del desarrollador en los ingresos de una transacción. Apigee calcula el porcentaje del desarrollador solo si habilitaste el porcentaje de ingresos en tu plan de tarifas.

El porcentaje del desarrollador se calcula con la siguiente fórmula:

x_apigee_mintng_dev_share = revShareGrossPrice * (share percentage)

El valor del porcentaje compartido se obtiene de tu plan de tarifas.

Sintaxis de la API: sum(x_apigee_mintng_dev_share)

Precio de la monetización x_apigee_mintng_price suma, promedio, mínimo, máximo

Los ingresos totales de una transacción. Los ingresos de una transacción se establecen en el valor de la variable de monetización revShareGrossPrice capturada en la política de DataCapture.

Sintaxis de la API: sum(x_apigee_mintng_price)

Multiplicador de precios de la API x_apigee_mintng_price_multiplier suma, promedio, mínimo, máximo

El factor (multiplicador) por el que se multiplica el costo por transacción. El costo por transacción se especifica en los precios de las tarifas basadas en el consumo del plan de tarifas.

Sintaxis de la API: avg(x_apigee_mintng_price_multiplier)

Tasas de monetización x_apigee_mintng_rate suma, promedio, mínimo, máximo

Tarifa cobrada por una transacción. La tarifa que se cobra por una transacción se calcula con la siguiente fórmula:

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

El valor de la tarifa según el consumo se obtiene de tu plan de tarifas y el valor perUnitPriceMultiplier se multiplica solo si la política DataCapture captura la variable.

Sintaxis de la API: sum(x_apigee_mintng_rate)

Dimensiones

Las dimensiones te permiten ver las métricas en agrupaciones significativas. Por ejemplo, ver los recuentos totales de tráfico tiene mucho más impacto cuando los visualizas para cada app de desarrollador o proxy de API.

A continuación, se muestran las dimensiones listas para usar que proporciona Apigee.

Dimensión Nombre para usar en la API de Apigee Descripción
Token de acceso access_token El token de acceso de OAuth del usuario final de la app.
Producto de API api_product
  • Nombre del producto de API que contiene los proxies de API a los que se llamará. Para obtener esta dimensión, las apps de desarrolladores que realizan las llamadas deben estar asociadas con uno o más productos de API que contengan los proxies de API y los proxies a los que se llama deben verificar que se haya enviado una clave de API o un token de OAuth con la llamada a la API. La clave o el token están asociados con un producto de API. Para obtener más información, consulta ¿Cómo puedo generar datos de estadísticas completos?.

    Si no se cumplen los criterios anteriores, verás el valor (not set). Consulta también ¿Qué significa un valor de entidad de las estadísticas “(no configurado)”?.

  • En el contexto de la métrica de tarifas, será el producto de API que corresponda al plan de tarifas al que se debe aplicar la tarifa de configuración o la tarifa recurrente. El valor estará vacío para recargas de prepago.

Clave de caché ax_cache_key

Clave que contiene el valor ResponseCache al que se accedió. Si deseas obtener más información sobre cómo se construye la clave para la caché de respuestas, consulta Política ResponseCache.

En la herramienta de depuración, cuando seleccionas una política de ResponseCache que lee o escribe en la caché, puedes ver este valor en la variable de flujo responsecache.cachekey.

Nombre de la caché ax_cache_name

Nombre de la caché que contiene las claves o los valores usados por la política ResponseCache, con el prefijo orgName__envName__. Por ejemplo, si la organización es myorgf, el entorno es test y el nombre de la caché es myCache, ax_cache_name es foo__test__myCache.

En la herramienta de depuración, cuando seleccionas una política de ResponseCache, puedes ver este valor en la variable de flujo responsecache.cachename.

Origen de la caché ax_cache_source

Nivel de caché (en la memoria de L1 o de la base de datos de L2) desde la que se recuperó ResponseCache. Esta dimensión también muestra CACHE_MISS cuando la respuesta se entregó desde el destino en lugar de la caché (y la caché de respuesta se actualizó con la respuesta de destino), o cuando una clave de caché en la solicitud no es válida. Las claves de caché tienen un límite de tamaño de 2 KB.

En la herramienta de depuración, cuando seleccionas la política de ResponseCache, puedes ver este valor en la variable de flujo responsecache.cachesource.

Para obtener más información sobre los niveles de la caché, consulta Aspectos internos de la caché.

ID de cliente client_id

La clave de consumidor (clave de API) de la aplicación de desarrollador que realiza las llamadas a la API, ya sea que se pasen en la solicitud como claves de API o que se incluyan en los tokens de OAuth.

A fin de obtener esta dimensión, los proxies que reciben llamadas se deben configurar para buscar una clave de API o un token de OAuth válidos. Las apps de desarrollador obtienen claves de API, que se pueden usar para generar tokens de OAuth, cuando las apps se registran en Apigee. Para obtener más información, consulta ¿Cómo puedo generar datos de estadísticas completos?.

Si no se cumplen los criterios anteriores, verás el valor (not set). Consulta también ¿Qué significa un valor de entidad de las estadísticas "(no configurado)"?.

App de desarrollador developer_app

La aplicación para desarrollador registrada en Apigee que realiza llamadas a la API.

Para obtener esta dimensión, las apps deben estar asociadas con uno o más productos de API que contengan los proxies de API a los que se llama y los proxies deben verificar que se envíe una clave de API o un token de OAuth con la llamada a la API. La clave o el token identifican la app de desarrollador. Para obtener más información, consulta ¿Cómo puedo generar datos de estadísticas completos?.

Si no se cumplen los criterios anteriores, verás el valor (not set). Consulta también ¿Qué significa un valor de entidad de las estadísticas "(no configurado)"?.

Correo electrónico del desarrollador developer_email
  • El correo electrónico de los desarrolladores registrados en Apigee cuya app realizó las llamadas a la API o el ID de AppGroup en el caso de un AppGroup.

    Para obtener esta dimensión, los desarrolladores o AppGroups deben tener apps asociadas con uno o más productos de API que contengan los proxies de API a los que se llama, y los proxies deben verificar que se envíe una clave de API o un token de OAuth con la llamada a la API. La clave o el token identifican la app de desarrollador. Para obtener más información, consulta ¿Cómo puedo generar datos de estadísticas completos?.

    Si no se cumplen los criterios anteriores, verás el valor (not set). Consulta también ¿Qué significa un valor de entidad de las estadísticas "(no configurado)"?.

  • En el contexto de la métrica de tarifas, será el desarrollador al que se le debe cobrar una tarifa de configuración, tarifas recurrentes o recargas de prepago.
ID de desarrollador developer

ID único de desarrollador que genera Apigee en el formato de org_name@@@unique_id.

Para obtener esta dimensión, los desarrolladores deben tener apps asociadas con uno o más productos de API que contengan los proxies de API a los que se llama y los proxies deben verificar que se envíe una clave de API o un token de OAuth con las llamadas a la API. La clave o el token identifican el desarrollador. Para obtener más información, consulta ¿Cómo puedo generar datos de estadísticas completos?.

Si no se cumplen los criterios anteriores, verás el valor (not set). Consulta también ¿Qué significa un valor de entidad de las estadísticas "(no configurado)"?.

Entorno environment El entorno de Apigee en el que se implementan los proxies de API. Por ejemplo, test o prod.
Código de falla del error ax_edge_execution_fault_code

El código de falla del error. Por ejemplo: messaging.adaptors.http.flow.GatewayTimeout

Nombre del flujo en el error ax_execution_fault
  _flow_name

El flujo con nombre en un proxy de API que generó un error. Por ejemplo, PreFlow, PostFlow o el nombre de un flujo condicional que creaste.

Ten en cuenta que el nombre completo que se debe usar en la API de Apigee es ax_execution_fault_flow_name, sin salto de línea.

Si no ocurrió ningún error, verás el valor (not set).

Recurso de flujo flow_resource Solo para su uso con Apigee. Si te interesa, consulta cómo usar la dimensión "Flujo de recursos" en Analytics.
Estado del flujo que generó errores ax_execution_fault
  _flow_state

El nombre del flujo de proxy de la API indica que se produjeron errores, como PROXY_REQ_FLOW o TARGET_RESP_FLOW.

Ten en cuenta que el nombre completo que se debe usar en la API de Apigee es ax_execution_fault_flow_state, sin salto de línea.

ID del flujo de la puerta de enlace gateway_flow_id A medida que las llamadas a la API se mueven a través de Apigee, cada llamada obtiene su propio ID del flujo de la puerta de enlace. Ejemplo: rrt329ea-12575-114653952-1. El ID del flujo de la puerta de enlace es útil para distinguir métricas en situaciones de TPS alto en las que otras dimensiones, como la organización, el entorno y la marca de tiempo, son idénticas en las llamadas.
Organización organization La organización de Apigee en la que se implementan los proxies de API.
Nombre de política que genera errores ax_execution_fault
  _policy_name

El nombre de la política que muestra un error y provocó un error en la llamada a la API.

Ten en cuenta que el nombre completo que se debe usar en la API de Apigee es ax_execution_fault_policy_name, sin salto de línea.

Si una política genera un error, pero el atributo raíz de la política continueOnError se configura como true, el flujo del proxy de API continúa sin fallas y la falla en la política no se cuenta en esta dimensión.

Proxy apiproxy El nombre de la máquina (no el nombre visible) de un proxy de API.
Ruta base del proxy proxy_basepath

La BasePath configurada en el ProxyEndpoint del proxy de API. En la ruta base no se incluye la porción del dominio y el puerto de la URL del proxy de API. Por ejemplo, si la URL base de un proxy de API es https://apigeedocs-test.apigee.net/releasenotes/, la ruta base es /releasenotes.

El valor también se almacena en la variable de flujo proxy.basepath.

Tipo de implementación de proxy proxy_deployment_type

El tipo de proxy de API para los proxies implementados. Especificar un tipo de proxy limita los resultados a ese tipo de proxy. Los valores posibles son STANDARD, EXTENSIBLE o sin configurar.

Sufijo de la ruta del proxy proxy_pathsuffix

La ruta del recurso agregada a la ruta base del proxy de API. Por ejemplo, si la URL base de un proxy de API es https://apigeedocs-test.apigee.net/hello/ y se hace una llamada a https://apigeedocs-test.apigee.net/hello/json, pathsuffix es /json.

Si no se usa un pathsuffix, el valor estará vacío.

El valor también se almacena en la variable de flujo proxy.pathsuffix.

Revisión del proxy apiproxy_revision El número de revisión del proxy de API que manejó las llamadas a la API. Esto no necesariamente significa que es la última revisión de un proxy de API. Si un proxy de API tiene 10 revisiones, puede que la octava revisión se esté implementando en el momento. Además, una API puede tener varias revisiones implementadas siempre que las revisiones tengan diferentes rutas base, como se describe en Implementa proxies.
IP de cliente resuelta ax_resolved_client_ip

Es la dirección IP de cliente de origen. El valor de la dimensión ax_resolved_client_ip se calcula a partir de los valores de las dimensiones ax_true_client_ip y x_forwarded_for_ip.

Ten en cuenta que, cuando se usan productos de enrutamiento como Akamai con el fin de capturar las direcciones IP reales de clientes, la IP de cliente se pasa a Apigee en el encabezado HTTP True-Client-IP, que luego se usa para configurar la dimensión ax_true_client_ip.

El valor de la dimensión ax_resolved_client_ip se calcula de la siguiente manera:

  1. Si ax_true_client_ip no es nulo y no contiene una dirección IP local, configura ax_resolved_client_ip como ax_true_client_ip.
  2. De lo contrario, configura ax_resolved_client_ip como la primera dirección IP que no sea local en x_forwarded_for_ip.
  3. Si ax_true_client_ip y x_forwarded_for_ip contienen solo IP locales, configura ax_resolved_client_ip como la última IP local en x_forwarded_for_ip.
  4. Si ax_true_client_ip y x_forwarded_for_ip son nulos, configura ax_resolved_client_ip como (not set).
  5. Si ax_true_client_ip es una IP local y x_forwarded_for_ip es nulo, configura ax_resolved_client_ip como (not set).
Código de estado de la respuesta response_status_code Código de estado de respuesta HTTP reenviado desde Apigee al cliente, como 200, 404, 503, etcétera. En Apigee, el código de estado de respuesta de destino se puede reemplazar por políticas como Política AssignMessage y Política RaiseFault, por lo que esta dimensión puede diferir del Código de respuesta de destino (target_response_code).
Host virtual virtual_host El nombre del host virtual al que se realizó la llamada a la API. Para obtener más información, consulta Información acerca de los entornos y grupos de entornos.
Entrada/cliente
Dirección IP de cliente client_ip La dirección IP del sistema que accede al router, como el cliente original (proxy_client_ip) o un balanceador de cargas. Cuando hay varias IP en el encabezado X-Forwarded-For, esta es la última IP que aparece en la lista.
Categoría del dispositivo ax_ua_device_category Tipo de dispositivo desde el que se realizó la llamada a la API, como Tablet o Smartphone.
Familia del SO ax_ua_os_family La familia del sistema operativo del dispositivo que realiza la llamada, como Android o iOS.
Versión del SO ax_ua_os_version

La versión del sistema operativo del dispositivo que realiza la llamada.

Es útil usar esto como una segunda dimensión de desglose de la familia del SO (ax_ua_os_family) para ver las versiones de los sistemas operativos.

IP de cliente del proxy proxy_client_ip

Dirección IP del cliente que realiza la llamada, almacenada en la variable de flujo proxy.client.ip. Por lo general, es la dirección X-Forwarded-For de la llamada entrante, que es la dirección IP que Apigee recibió del último protocolo de enlace de TCP externo. Puede ser el cliente que realiza la llamada o un balanceador de cargas. Cuando hay varias IP en el encabezado X-Forwarded-For, esta es la última IP que aparece en la lista.

IP de cliente referida ax_true_client_ip

Cuando se usan productos de enrutamiento como Akamai con el fin de capturar las direcciones IP reales de clientes, las IP de cliente se pasan a Apigee en el encabezado HTTP True-Client-IP. Esta dimensión captura esas IP de cliente reales de ese encabezado.

Para determinar la dirección IP de cliente original, a la que se accede a través de la dimensión ax_resolved_client_ip, Apigee usa las dimensiones ax_true_client_ip y x_forwarded_for_ip.

Ruta de la solicitud request_path

La ruta del recurso (sin incluir el dominio) al servicio de destino, sin incluir los parámetros de consulta.

Por ejemplo, en la dirección http://mocktarget.apigee.net de destino de muestra de Apigee, se incluyen varios recursos, incluido /user, que muestra un saludo. Sin importar cómo el proxy de API llame a http://mocktarget.apigee.net/user, la ruta de la solicitud es /user.

URI de solicitud request_uri

La ruta del recurso (sin incluir el dominio) al servicio de destino, incluidos los parámetros de consulta.

Por ejemplo, en la dirección http://mocktarget.apigee.net de destino de muestra de Apigee, se incluyen varios recursos, incluido el recurso /user?user={name} y el parámetro de consulta con el fin de mostrar un saludo personalizado al nombre proporcionado. Sin importar cómo el proxy de API llame a http://mocktarget.apigee.net/user?user=Dude, el request_uri es /user?user=Dude.

Verbo de la solicitud request_verb El verbo de la solicitud HTTP en las solicitudes a la API, como GET, POST, PUT y DELETE.
Usuario-agente useragent

Nombre del usuario-agente, o agente de software, que se usa para realizar la llamada a la API. Ejemplos:

  • Un Pixel XL que realiza una llamada mediante 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 que realiza una llamada mediante 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 desde una terminal: curl/7.51.0
Familia del usuario-agente ax_ua_agent_family Familia del usuario-agente, como Chrome Mobile o curl.
Tipo del usuario-agente ax_ua_agent_type El tipo de usuario-agente, como Browser, Mobile Browser, Library, etcétera.
Versión del usuario-agente ax_ua_agent_version

Versión del usuario-agente.

Es útil usarla como una segunda dimensión de desglose con la familia usuario-agente (ax_ua_agent_family) para obtener la versión de la familia del agente.

Salida/Destino
Destino target Extremo de destino que manejó la solicitud. Por ejemplo, default.
Ruta base del destino target_basepath

La ruta del recurso (sin incluir el dominio) al servicio de destino, sin incluir los parámetros de consulta, que se define en el <TargetEndpoint> del proxy.

Por ejemplo, supongamos que un proxy de API llama al siguiente destino:

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

En este ejemplo, la target_basepath es /user.

Si el objetivo fuera el siguiente:

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

target_basepath sería nulo.

En la herramienta de depuración, cuando seleccionas el ícono de AX al final del diagrama de flujo, la variable de flujo target.basepath se mapea a la dimensión target_basepath.

Nombre del servicio de gRPC x_apigee_grpc_service_name Solo se aplica cuando el servicio de destino es gRPC. El nombre del servicio de gRPC. Para obtener información sobre los proxies de gRPC, consulta Crea proxies de API de gRPC.
Estado de gRPC x_apigee_grpc_status Solo se aplica cuando el servicio de destino es gRPC. El estado de la solicitud de gRPC. Para obtener información sobre los proxies de gRPC, consulta Crea proxies de API de gRPC.
Host del destino target_host Host del servicio de destino. Por ejemplo, si un proxy de API llama a http://mocktarget.apigee.net/help, el target_host es mocktarget.apigee.net.
Dirección IP del destino target_ip La dirección IP del servicio de destino que reenvía la respuesta al proxy de API.
Código de respuesta del destino target_response_code

Código de estado de respuesta HTTP que muestra el servicio de destino al proxy de API, como 200, 404, 503, etcétera.

Un valor de null significa que la solicitud nunca llegó al servicio de destino. Esto ocurre cuando la política ResponseCache entrega la respuesta o cuando existe una falla en el procesamiento de la solicitud.

Es diferente a la dimensión de código de estado de respuesta (response_status_code).

Nombre de RPC de gRPC x_apigee_grpc_rpc_name Solo se aplica cuando el servicio de destino es gRPC. El nombre de la RPC. Para obtener información sobre los proxies de gRPC, consulta Crea proxies de API de gRPC.
URL del destino target_url

La URL completa del servicio de destino que se definió en el TargetEndpoint de un proxy de API.

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

En este ejemplo, la target_url es http://mocktarget.apigee.net/user?user=Dude.

Ten en cuenta que la URL también se puede anular durante el procesamiento del proxy de API mediante la variable de flujo target.url.

En el encadenamiento de proxy, la target_url del proxy que realiza la llamada es nula.

IP de X-Forwarded-For x_forwarded_for_ip

La lista de direcciones IP en el encabezado X-Forwarded-For.

Para determinar la dirección IP de cliente original, a la que se accede a través de la dimensión ax_resolved_client_ip, Apigee usa las dimensiones ax_true_client_ip y x_forwarded_for_ip.

Protocolo de X-Forwarded-For x_forwarded_proto

El protocolo que el cliente usó para conectarse al router. Entre los valores válidos, se incluyen http o https.

Hora
Día de la semana ax_day_of_week La abreviatura de tres letras del día de la semana en la que se realizaron las llamadas a la API. Por ejemplo, lun, mar o mié.
Mes ax_month_of_year El numero del mes en el que se realizaron las llamadas a la API. Por ejemplo, 03 para marzo.
Hora del día ax_hour_of_day

En función de un reloj de 24 horas, es la hora de 2 dígitos en que se realizaron las llamadas a la API. Por ejemplo, para las llamadas a la API realizadas entre las 10 p.m. y las 11 p.m., la x_hour_of_day sería 22.

El valor de la hora está en UTC.

Zona horaria ax_geo_timezone Nombres comunes de las zonas horarias desde las que se realizaron las llamadas a la API, como America/New_York y Europe/Dublin.
Semana del mes ax_week_of_month Semana numérica del mes Por ejemplo, para las llamadas a la API realizadas durante la tercera semana de un mes, ax_week_of_month es 3.
Ubicación
Ciudad ax_geo_city La ciudad desde la que se realizaron las llamadas a la API.
Continente ax_geo_continent El código de dos letras del continente desde el cual se hicieron las llamadas a la API. Por ejemplo, NA para Norteamérica.
País ax_geo_country El código de dos letras del país desde el cual se hicieron las llamadas a la API. Por ejemplo, US para Estados Unidos.
Región geográfica ax_geo_region El código con guiones de la región geográfica, como STATE-COUNTRY. Por ejemplo, WA-US para Washington-Estados Unidos.
Región ax_dn_region Nombre del centro de datos de Apigee en el que se implementan los proxies de API, como us-east-1.
Monetización
Creada created

Actualmente, está disponible en organizaciones de Apigee, no en organizaciones híbridas de Apigee.

Marca de tiempo de Unix cuando se agregó la lista de tarifas para el desarrollador de apps y el producto de la API.

Tipo de tarifa fees_type Tipo de tarifa. Puede ser una tarifa de configuración, una tarifa recurrente o una recarga de prepago. Este valor solo se propaga si seleccionaste la métrica Fees.
Moneda de los ingresos x_apigee_mintng_currency
  • La moneda de los ingresos de la transacción se establece en el valor de la variable de monetización currency que se captura en tu política de DataCapture. Esta moneda está asociada con la moneda de revShareGrossPrice.
  • En el contexto de la métrica de tarifas, será la moneda de la tarifa de configuración, la tarifa recurrente o la recarga de prepago.
ID de plan de tarifa x_apigee_mintng_rate_plan_id

Actualmente, está disponible en organizaciones de Apigee, no en organizaciones de Apigee Hybrid.

El plan de tasa de monetización del desarrollador de apps.

Éxito de la transacción x_apigee_mintng_tx_success El estado de monetización de la transacción se establece en el valor de la variable de monetización transactionSuccess que se captura en tu política de DataCapture.

Filtros

Los filtros te permiten limitar los resultados a las métricas con características específicas. A continuación, se muestran algunos filtros de ejemplo. Usa nombres de métricas y dimensiones con el estilo de API cuando definas filtros.

Muestra métricas para los proxies de API con nombres de libros o música:

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

Muestra métricas para proxies de API con nombres que comienzan con m:

filter=(apiproxy like 'm%')

Muestra métricas para proxies de API con nombres que no comienzan con m:

filter=(apiproxy not like 'm%')

Muestra métricas para las llamadas a la API con códigos de estado de respuesta entre 400 y 599:

filter=(response_status_code ge 400 and response_status_code le 599)

Muestra métricas para las llamadas a la API con un código de estado de respuesta de 200 y un código de respuesta de destino de 404:

filter=(response_status_code eq 200 and target_response_code eq 404)

Muestra métricas para las llamadas a la API con un código de estado de respuesta de 500:

filter=(response_status_code eq 500)

Muestra métricas para las llamadas a la API que no generaron errores:

filter=(is_error eq 0)

Muestra métricas para las llamadas a la API que no generaron respuestas null:

filter=(response_status_code isnot null)

A continuación, se enumeran los operadores que puedes usar para compilar filtros de informe.

Operador Descripción
in Incluir en la lista
notin Excluir de la lista
is Usa response_status_code is null para filtrar las respuestas cuyo código de estado es null.
isnot Usa response_status_code isnot null para filtrar las respuestas cuyo código de estado no sea null.
eq Es igual a ==
ne No es igual, !=
gt Es mayor, >
lt Es menor, <
ge Es mayor o igual, >=
le Es menor o igual, <=
like Muestra verdadero si el patrón de string coincide con el patrón proporcionado.
not like Muestra falso si el patrón de string coincide con el patrón proporcionado.
similar to Muestra verdadero o falso en función de si su patrón coincide con la string proporcionada. Es similar a like, excepto que interpreta el patrón mediante la definición de una expresión regular del estándar de SQL.
not similar to Muestra falso o verdadero en función de si su patrón coincide con la string proporcionada. Es similar a not like, excepto que interpreta el patrón mediante la definición de una expresión regular del estándar de SQL.
and Te permite usar la lógica AND para incluir más de una expresión de filtro. El filtro incluye los datos que cumplen con todas las condiciones.
or Te permite usar la lógica OR para evaluar diferentes expresiones de filtro posibles. El filtro incluye los datos que cumplen con al menos una de las condiciones.