Average number of transactions, meaning API proxy requests, per second. Note that if you have a relatively low number of transactions over the time period, the average number of transactions per second could appear to be zero in UI custom reports if the number is smaller than two decimal places.

API syntax:tps

Number of successful API requests that use theResponseCache instead of the response from the target service.

API syntax:sum(cache_hit)

Number of elements in L1 (in-memory) cache per transaction over a given time period. For example, if you choosemax for the period of a day, and within that day the highest number of elements in cache is 12 for a specific transaction, then the count will be 12. Foravg, if there are three transactions in the time period you're querying, and their cache counts are 5, 6, and 7, the average is 6. L1 cache is in-memory cache as opposed to L2 database cache, as described inCache internals.

API syntax:avg(ax_cache_l1_count)

Total number of policy errors over the specified time period.

Policy errors usually occur by design. For example, theVerifyApiKey policy throws an error when an invalid API key is passed in the request, and aSpikeArrest policy throws an error if the number of API calls exceeds the limit defined in the policy. So this metric is useful for finding potential trouble spots in your APIs. For example,policy_error metrics, grouped by thedeveloper_app dimension, might help you discover that an API key or OAuth token has expired for a given app; or you might find that a specific API proxy is throwing a lot ofSpikeArrest policy errors, leading you to discover that the proxy's spike arrest limit doesn't account for an increase in holiday traffic.

A policy error is logged in analytics only if the error results in API proxy failure. For example, if a policy'scontinueOnError attribute is set totrue, the API proxy continues processing a request even if the policy fails. In that case, a policy error is not logged in analytics.

The Policy Name on Error (ax_execution_fault_policy_name) dimension is useful for grouping policy errors by policy name.

A target failure (such as a404 or503) does not count as a policy failure. Those count as API proxy failures (is_error).

API syntax:sum(policy_error)

Total number of times API proxies failed over the specified time period. Proxy failure can occur when a policy fails or when there's a runtime failure, such as a404 or503 from the target service.

The Proxy (apiproxy) dimension is useful for grouping API proxy failures by proxy.

API syntax:sum(is_error)

Amount of time (average, minimum, or maximum), inmilliseconds, that it takes Apigee to process incoming requests. The time starts when the request reaches Apigee and ends when Apigee forwards the request to the target service.

Using different dimensions, you can examine request processing latencies by API proxy, developer app, region, and so on.

API syntax:max(request_processing_latency)

Size of the request payload received by Apigee, inbytes.

API syntax:avg(request_size)

Total number of times aResponseCache policy was executed over the given time period.

Since theResponseCache policy is attached in two places in an API proxy (once in the request and once in the response), it usually executes twice in an API call. A cacheGET and a cachePUT each count as one execution.

However, response cache execution is 0 if the<SkipCacheLookup> element in the policy evaluates to true (in the request), and 0 if the<SkipCachePopulation> element in the policy evaluates to true (in the response).

In theDebug tool, you can click theResponseCache icon in an executed API call and view theresponsecache.executedflow variable to see whether or not there was a cache execution (a value of 1).

API syntax:sum(ax_cache_executed)

Amount of time (average, minimum, or maximum), inmilliseconds, that it takes Apigee to process API responses. The time starts when the API proxy receives the target service response and ends when Apigee forwards the response to the original caller.

Using different dimensions, you can examine response processing latencies by API proxy, region, and so on.

API syntax:min(response_processing_latency)

Size of the response payload returned to the client, inbytes.

API syntax:max(response_size)

Total number of5xx responses from the target service. These are target service errors not caused by Apigee.

API syntax:sum(target_error)

Amount of time (sum, average, minimum, or maximum), inmilliseconds, for the target server to respond to a call. This metric tells you how target servers are performing. The time starts when Apigee forwards a request to the target service and ends when Apigee receives the response.

Note that if an API call returns a response from cache (using theResponseCache policy, for example), the call will never reach the target service, and no target response time metrics are logged.

API syntax:avg(target_response_time)

Amount of time (sum, average, minimum, or maximum), inmilliseconds, from when Apigee receives a request from a client to when Apigee sends the response back to the client. The time includes network overhead (such as the time it takes load balancers and routers to do their work), request processing latency, response processing latency, and target response time (if the response is served from the target service instead of cache).

Using different dimensions, you can examine processing latencies by API proxy, developer app, region, and so on.

API syntax:avg(total_response_time)

Total number of API calls processed by Apigee in the specified time period.

Use dimensions to group traffic counts in ways that are most meaningful to you.

API syntax:sum(message_count)

Fee amount.

API syntax:sum(fees)

Developer's share in a transaction's revenue. Apigee calculates the developer's share only if you have enabled revenue sharing in your rate plan.

The developer's share is calculated using the following formula:

The value of the share percentage is fetched from your rate plan.

API syntax:sum(x_apigee_mintng_dev_share)

Total revenue of a transaction. The revenue of a transaction is set to the value of therevShareGrossPrice monetization variable captured in your DataCapture policy.

API syntax:sum(x_apigee_mintng_price)

The factor (multiplier) by which the per-transaction cost is multiplied. The per-transaction cost is specified in the rate plan'sConsumption-based fees pricing.

API syntax:avg(x_apigee_mintng_price_multiplier)

Rate charged for a transaction. The rate charged for a transaction is calculated using the following formula:

The value of the consumption-based pricing rate is fetched from your rate plan and theperUnitPriceMultiplier value is multiplied only if the variable is captured by the DataCapture policy.

API syntax:sum(x_apigee_mintng_rate)

• Name of the API product containing the API proxies being called. In order to get this dimension, developer apps making the calls must be associated with one or more API products that contain the API proxies, and the proxies being called must check for an API key or OAuth token sent with the API call. The key or token is associated with an API product. For more information, seeHow do I generate complete analytics data?.

  If the above criteria aren't met, you'll see the value(not set). See alsoWhat does an analytics entity value "(not set)" mean?.

• In the context of the fees metric, it contains the API product corresponding to the rate plan. The value is empty for some fee types, such as prepaid topup.

Key containing theResponseCache value that was accessed. For more information on how the key is constructed for response cache, seeResponseCache policy.

In theDebug tool, when you select aResponseCache policy that reads from or writes to the cache, you can see this value in theresponsecache.cachekeyflow variable.

Name of the cache containing the keys/values used by theResponseCache policy, prefixed withorgName__envName__. For example, if the org ismyorgf, the environment istest, and the cache name ismyCache theax_cache_name isfoo__test__myCache.

In theDebug tool, when you select aResponseCache policy, you can see this value in theresponsecache.cachenameflow variable.

Cache level (L1 in-memory or L2 database) from which theResponseCache was retrieved. This dimension also showsCACHE_MISS when the response was delivered from the target instead of cache (and response cache was refreshed with the target response); or when a cache key in the request is invalid. Cache keys are limited to 2 KB in size.

In theDebug tool, when you select theResponseCache policy, you can see this value in theresponsecache.cachesourceflow variable.

For more information on cache levels, seeCache internals.

Consumer key (API key) of the developer app making the API calls, whether passed in the request as API keys or included in OAuth tokens.

In order to get this dimension, proxies receiving calls must be configured to check for a valid API key or OAuth token. Developer apps get API keys, which can be used to generate OAuth tokens, when the apps are registered in Apigee. For more information, seeHow do I generate complete analytics data?.

If the above criteria aren't met, you'll see the value(not set). See alsoWhat does an analytics entity value "(not set)" mean?.

Apigee-registered developer app making API calls.

In order to get this dimension, apps must be associated with one or more API products that contain the API proxies being called, and the proxies must check for an API key or OAuth token sent with the API call. The key or token identifies the developer app. For more information, seeHow do I generate complete analytics data?.

If the above criteria aren't met, you'll see the value(not set). See alsoWhat does an analytics entity value "(not set)" mean?.

• Email of the Apigee-registered developers whose app made the API calls. This field is not set for AppGroup apps.

  In order to get this dimension, developers or AppGroups must have apps associated with one or more API products that contain the API proxies being called, and the proxies must check for an API key or OAuth token sent with the API call. The key or token identifies the developer app. For more information, seeHow do I generate complete analytics data?.

  If the above criteria aren't met, you'll see the value(not set). See alsoWhat does an analytics entity value "(not set)" mean?.

• In the context of the fees metric, it contains the developer to whom the fee is charged.

Unique Apigee-generated developer ID in the formorg_name@@@unique_id. For AppGroups, theunique_id is the AppGroup name.

In order to get this dimension, developers must have apps associated with one or more API products containing the API proxies being called, and the proxies must check for an API key or OAuth token sent with the API calls. The key or token identifies the developer. For more information, seeHow do I generate complete analytics data?.

If the above criteria aren't met, you'll see the value(not set). See alsoWhat does an analytics entity value "(not set)" mean?.

Thefault code of the error. For example:messaging.adaptors.http.flow.GatewayTimeout

Namedflow in an API proxy that raised an error. For example,PreFlow,PostFlow, or the name of a conditional flow you created.

Note that the full name to use in the Apigee API isax_execution_fault_flow_name, without a line break.

Where no errors occurred, you'll see the value(not set).

Name of the API proxy flow states that raised errors, such asPROXY_REQ_FLOW orTARGET_RESP_FLOW.

Note that the full name to use in the Apigee API isax_execution_fault_flow_state, without a line break.

Name of the policy that threw an error and caused the API call to fail.

Note that the full name to use in the Apigee API isax_execution_fault_policy_name, without a line break.

If a policy throws an error but the policy root attributecontinueOnError is set totrue, the API proxy flow continues without failure, and the policy failure isn't counted in this dimension.

BasePath configured on the API proxy ProxyEndpoint. Base path does not include the domain and port portion of the API proxy URL. For example, if an API proxy's base URL ishttps://apigeedocs-test.apigee.net/releasenotes/, the base path is/releasenotes.

The value is also stored in theproxy.basepathflow variable.

TheAPI proxy type for deployed proxies. Specifying a proxy type limits results to that proxy type. Potential values areSTANDARD,EXTENSIBLE, or unset.

Resource path added to the API proxy base path. For example, if an API proxy's base URL ishttps://apigeedocs-test.apigee.net/hello/, and a call is made tohttps://apigeedocs-test.apigee.net/hello/json, thepathsuffix is/json.

If nopathsuffix is used, the value is empty.

The value is also stored in theproxy.pathsuffixflow variable.

Originating client IP address. This is either derived using the default client ip address resolution or the algorithm configured inconfigured client IP resolution.

With the default behavior, the value of theax_resolved_client_ip dimension is calculated from the values in theax_true_client_ip and thex_forwarded_for_ip dimensions.

Note that when using routing products such as Akamai to capture the true IP addresses of clients, the client IP is passed to Apigee in the HTTP headerTrue-Client-IP, which is then used to set theax_true_client_ip dimension.

The value of theax_resolved_client_ip dimension is calculated as follows:

1. Ifax_true_client_ip is not null and does not contain a local IP address, then setax_resolved_client_ip toax_true_client_ip.
2. Else, setax_resolved_client_ip to the first non-local IP address inx_forwarded_for_ip.
3. If bothax_true_client_ip andx_forwarded_for_ip contain only local IPs, then setax_resolved_client_ip to the last local IP inx_forwarded_for_ip.
4. If bothax_true_client_ip andx_forwarded_for_ip are null, setax_resolved_client_ip to(not set).
5. Ifax_true_client_ip is a local IP andx_forwarded_for_ip is null, setax_resolved_client_ip to(not set).

Operating system version of the device making the call.

It's useful to use this as a second drill-down dimension with OS Family (ax_ua_os_family) to see the versions of the operating systems.

IP address of the calling client, stored in theproxy.client.ipflow variable. This is often theX-Forwarded-For address of the inbound call, which is the IP address Apigee received from the last external TCP handshake. This could be the calling client or a load balancer. When there are multiple IPs in theX-Forwarded-For header, this is the last IP listed.

When using routing products such as Akamai to capture the true IP addresses of clients, the client IPs are passed to Apigee in the HTTP headerTrue-Client-IP. This dimension captures those true client IPs from that header.

To determine the original client IP Address, accessed through theax_resolved_client_ip dimension, Apigee uses theax_true_client_ip and thex_forwarded_for_ip dimensions.

Resource path (not including the domain) to the target service, excluding query parameters.

For example, the Apigee sample targethttp://mocktarget.apigee.net includes several resources, including/user, which returns a greeting. Regardless of how your API proxy callshttp://mocktarget.apigee.net/user, the request_path is/user.

Resource path (not including the domain) to the target service, including query parameters.

For example, the Apigee sample targethttp://mocktarget.apigee.net includes several resources, including/user?user={name} resource and query parameter to return a custom greeting to the name provided. Regardless of how your API proxy callshttp://mocktarget.apigee.net/user?user=Dude, the request_uri is/user?user=Dude.

Name of the user agent, or software agent, used to make the API call. Examples:

• A Pixel XL making a call through 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
• An iPad making a call through 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 from a terminal:curl/7.51.0

Version of the useragent.

It's useful to use this as a second drill-down dimension with User Agent Family (ax_ua_agent_family) to get the version of the agent family.

Resource path (not including the domain) to the target service, excluding query parameters, that is defined in the proxy's<TargetEndpoint>.

For example, say an API proxy calls the following target:

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

In this example, the target_basepath is/user.

If the target were this:

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

the target_basepath would be null.

In theDebug tool, when you select the AX icon at the end of the flow diagram, thetarget.basepathflow variable maps to the target_basepath dimension.

HTTP response status code returned by the target service to the API proxy, such as200,404,503, and so on.

A value ofnull means the request never reached the target service. This occurs when the response is served by theResponseCache policy or when there's a failure in request processing.

This is different from theResponse Status Code (response_status_code) dimension.

Full URL of the target service defined in an API proxy's TargetEndpoint.

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

In this example, the target_url ishttp://mocktarget.apigee.net/user?user=Dude.

Note that the URL can also be overridden during API proxy processing with thetarget.urlflow variable.

Inproxy chaining, the target_url in the calling proxy is null.

The list of IP addresses in theX-Forwarded-For header.

To determine the original client IP Address, accessed through theax_resolved_client_ip dimension, Apigee uses theax_true_client_ip and thex_forwarded_for_ip dimensions.

Protocol that the client used to connect to the router. Valid values includehttp orhttps.

Based on a 24-hour clock, the 2-digit hour in which API calls were made. For example, API calls made in the hour between 10pm and 11pm, the ax_hour_of_day would be 22.

The time value is in UTC.

Unix Timestamp when the fee was added for the app developer and API product. This value is populated only if you have selected theFees metric.

• Currency of the transaction revenue is set to the value of thecurrency monetization variable captured in your DataCapture policy. This currency is associated with the currency ofrevShareGrossPrice.
• In the context of the fees metric, it contains the currency of the fee.

The monetization rate plan for the app developer.

Start of the period for which recurring fees are charged. For example, for a monthly fee this is the first day of the month. This value is populated only if you have selected theFees metric.

End of the period for which recurring fees are charged. For example, for a monthly fee this is the last day of the month. This value is populated only if you have selected theFees metric.