分析指标、维度和过滤器参考文档

平均事务数，即每秒的 API 代理请求数。请注意，如果相应时间段内事务量相对较少，且界面定制报告中的每秒平均事务数小于两位小数，则每秒平均事务数可能为零。

API 语法：tps

使用响应缓存而不是来自目标服务的响应的成功 API 请求数。

API 语法：sum(cache_hit)

返回指定时间段内每个事务的 L1（内存）缓存中的元素数量。例如，如果您为一天选择了 max，而当天特定事务缓存中的最高元素数为 12，那么计数将为 12。对于 avg，如果您查询的时间段中有 3 笔事务，并且其缓存计数分别为 5、6 和 7，则平均值为 6。如缓存内部说明中所述，L1 缓存是内存缓存，与 L2 数据库缓存不同。

API 语法：avg(ax_cache_l1_count)

在指定时间段内的政策错误总数。

政策错误通常是由设计引起的。例如，如果在请求中传递了无效的 API 密钥，Verify API Key 政策会抛出错误；如果 API 调用次数超过该政策中定义的限制，则 Spike Arrest 政策会抛出错误。因此，此指标可用于找出 API 中的潜在问题。例如，通过 developer_app 维度分组的 policy_error 指标，您可能会发现指定应用的 API 密钥或 OAuth 令牌已过期；或者，您可能会发现某个特定 API 代理抛出大量的 Sprike Arrest 错误，使您发现代理的峰值控制限制并不能限制假日流量的增加。

仅当错误导致 API 代理故障时，才会在分析中记录政策错误。例如，如果政策的 continueOnError 特性设置为 true，则API 代理会继续处理请求，即使政策失败也是如此。在这种情况下，分析中不会记录政策错误。

The Policy Name on Error (ax_execution_fault_policy_name) 维度有助于按政策名称对政策错误进行分组。

目标故障（例如 404 或 503）不会被视为政策故障。这些会被视为 API 代理故障 (is_error)。

API 语法：sum(policy_error)

API 代理在指定时间段内失败的总次数。当政策失败或发生运行时故障（例如目标服务出现 404 或 503）时，会发生代理故障。

代理 (apiproxy) 维度有助于按代理对 API 代理故障进行分组。

API 语法：sum(is_error)

时间（平均、最小或最长），以毫秒为单位， Edge 处理传入请求。请求达到 Edge 并在 Edge 将请求转发给目标服务时结束。

使用不同的维度，您可以通过 API 代理、开发者应用、地区等检查请求处理延迟时间。

API 语法：max(request_processing_latency)

Edge 收到的请求载荷的大小（以字节为单位）。

API 语法：avg(request_size)

响应缓存政策在给定时间段内执行的总次数。

由于响应缓存政策附加在 API 代理请求中的两个位置（一次在请求中，一次在响应中），所以其通常在 API 调用中执行两次。每次缓存“get”和缓存“put”都会计为一次执行。

不过，如果政策中的 <SkipCacheLookup> 元素评估为 true，则响应缓存执行为 0；如果政策中的 <SkipCachePopulation> 元素评估为 true（在响应中），则响应缓存执行为 0。

在 Trace 工具中，您可以点击已执行 API 调用中的“响应缓存”图标，并查看 responsecache.executed 流变量查看是否存在缓存执行（值为 1）。

API 语法：sum(ax_cache_executed)

时间（平均、最小或最长），以毫秒为单位， Edge 需要处理 API 响应。计时从 API 代理收到目标服务响应时开始，到 Apigee 将响应转发给原始调用者时结束。

使用不同的维度，您可以通过 API 代理、地区等来检查响应处理延迟时间。

API 语法：min(response_processing_latency)

返回客户端的响应负载的大小（以字节为单位）。

API 语法：max(response_size)

来自目标服务的 5xx 响应总数。这些目标服务错误不是由 Apigee 引起的。

API 语法：sum(target_error)

目标服务器响应调用的时长（总值、平均值、最小值或最大值），以毫秒为单位。此指标可帮助您了解目标服务器的性能。Edge 转发请求后即开始计时 发送到目标服务，并在 Edge 收到响应时结束。

请注意，如果 API 调用从缓存返回响应（例如，使用响应缓存政策），则调用永远不会到达目标服务，并且不会记录目标响应时间指标。

API 语法：avg(target_response_time)

输入的时间间隔（总和、平均值、最小值或最大值） 毫秒，即从 Edge 收到客户端请求到发出 Edge 将响应发送回客户端。该时间包括网络开销（例如，负载均衡器和路由器完成工作所需的时间）、请求处理延迟时间、响应处理延迟时间以及目标响应时间（如果响应是来自目标服务，而不是缓存）。

使用不同的维度，您可以通过 API 代理、开发者应用、地区等检查处理延迟时间。

API 语法：avg(total_response_time)

Edge 在指定时间段内处理的 API 调用总数。

使用维度以对您最有意义的方式对流量计数进行分组。

API 语法：sum(message_count)

包含正在调用的 API 代理的 API 产品的名称。为了获取此维度，进行调用的开发者应用必须与包含 API 代理的一个或多个 API 产品相关联，并且正在被调用的代理必须检查 API 密钥或随 API 调用一起发送的 OAuth 令牌。密钥或令牌与 API 产品相关联。如需了解详情，请参阅 首要事项：如何生成完整的分析数据。

如果不符合上述条件，您会看到值“（未设置）”。另请参阅分析实体值“（未设置）”是什么意思？。

包含已访问的响应缓存值的键。如需详细了解如何为响应缓存构建键，请参阅响应缓存政策。

如您想在 responsecache.cachekey 流变量中查看此值，请在Trace 工具中，选择可从缓存中读取或写入缓存的响应缓存政策。

包含响应缓存政策所使用的键/值的缓存的名称，以 orgName__envName__ 为前缀。例如，如果组织为“foo”，环境为“test”，缓存名称为“myCache”，则 ax_cache_name 为 foo__test__myCache。

如您想在 responsecache.cachename 流变量中查看此值，请在Trace 工具中，选择响应缓存政策。

从中检索缓存响应的缓存级别（“L1”内存或“L2”数据库）。当从目标（而非缓存）传送响应（并且响应缓存使用目标响应刷新）或请求中缓存键无效时，该维度还会显示“CACHE_MISS”。缓存键的大小限制为 2 KB。

如您想在 responsecache.cachesource 流变量中查看此值，请在Trace 工具中，选择响应缓存政策。

如需详细了解缓存级别，请参阅缓存内部说明。

进行 API 调用的开发者应用的使用方密钥（API 密钥），可以作为 API 密钥传入请求也可以包含在 OAuth 令牌中。

若要获取此维度，必须配置接收调用的代理，使其可以检查是否存在有效的 API 密钥或 OAuth 令牌。开发者应用会获取 API 密钥， 当应用在 Edge 中注册时生成 OAuth 令牌。如需了解详情，请参阅 首要事项：如何生成完整的分析数据。

如果不符合上述条件，您会看到值“（未设置）”。另请参阅分析实体值“（未设置）”是什么意思？。

进行 API 调用的 Edge 注册开发者应用。

要获得此维度，应用必须与包含正被调用的 API 代理的一个或多个 API 产品关联，并且代理必须检查 API 密钥或随 API 调用一起发送的 OAuth 令牌。此密钥或令牌用于标识开发者应用。对于 有关详情，请参阅首要任务：如何生成完整的分析数据。

如果不符合上述条件，您会看到值“（未设置）”。另请参阅分析实体值“（未设置）”是什么意思？。

应用进行 API 调用的 Edge 注册开发者的电子邮件地址。

为了获取此维度，开发者必须拥有与一个或多个包含正被调用的 API 代理的 API 产品相关联的应用，并且代理必须检查 API 密钥或随 API 调用一起发送的 OAuth 令牌。密钥或令牌用于标识开发者 应用。如需了解详情，请参阅首要事项：如何生成完整的分析数据。

如果不符合上述条件，您会看到值“（未设置）”。另请参阅分析实体值“（未设置）”是什么意思？。

Edge 生成的唯一开发者 ID，格式为 org_name@@org_name。

为了获取此维度，开发者必须拥有与一个或多个包含正被调用的 API 代理的 API 产品相关联的应用，并且代理必须检查 API 密钥或随 API 调用一起发送的 OAuth 令牌。密钥或令牌用于标识开发者。如需了解详情，请参阅首要事项：如何生成完整的分析数据。

如果不符合上述条件，您会看到值“（未设置）”。另请参阅分析实体值“（未设置）”是什么意思？。

错误的故障代码。例如：messaging.adaptors.http.flow.GatewayTimeout

API 代理中引发错误的指定 flow。例如，“PreFlow”、“PostFlow”或您创建的条件流的名称。

请注意，Management API 中使用的全名是 ax_execution_fault_flow_name， 不换行。

如果无错误发生，您将会看到值“（未设置）”。

API 代理流名称表明引发错误，例如“PROXY_REQ_FLOW”或“TARGET_RESP_FLOW”。

请注意，Management API 中使用的全名是 ax_execution_fault_flow_state， 不换行。

抛出错误并使 API 调用失败的政策名称。

请注意，Management API 中使用的全名是 ax_execution_fault_policy_name， 不换行。

如果政策抛出错误，但将政策根属性 continueOnError 设置为 true，则 API 代理流不会发生任何故障，并且政策故障不会计入此维度。

在 API 代理 ProxyEndpoint 中配置的 BasePath。基本路径不包括 API 代理网址的网域和端口部分。例如，如果 API 代理的基准网址为 https://apigeedocs-test.apigee.net/releasenotes/，基本路径为 /releasenotes。

该值也存储在 proxy.basepath 流变量中。

添加到 API 代理基本路径的资源路径。例如，如果 API 代理的基本网址为 https://apigeedocs-test.apigee.net/hello/，且调用 https://apigeedocs-test.apigee.net/hello/json，则路径后缀为 /json。

如果未使用路径后缀，则该值为空。

该值也存储在 proxy.pathsuffix 流变量中。

包含原始客户端 IP 地址。ax_resolved_client_ip 维度的值是根据 ax_true_client_ip 和 x_forwarded_for_ip 维度的值计算得出的。

请注意，在使用 Akamai 等路由产品捕获客户端的真实 IP 地址时， 客户端 IP 通过 HTTP 标头 True-Client-IP 传递给 Edge， 然后用于设置 ax_true_client_ip 维度。

ax_resolved_client_ip 维度的值以如下方式计算：

1. 如果 ax_true_client_ip 不为 null 且不包含本地 IP 地址，请将 ax_resolved_client_ip 设置为 ax_true_client_ip。
2. 或者，将 ax_resolved_client_ip 设置为 x_forwarded_for_ip 中第一个非本地 IP 地址。
3. 如果 ax_true_client_ip 和 x_forwarded_for_ip 都包含 然后将 ax_resolved_client_ip 设置为 x_forwarded_for_ip 中的第一个本地 IP 地址。
4. 如果 ax_true_client_ip 和 x_forwarded_for_ip 都为 null，请将 ax_resolved_client_ip 设置为 (not set)。
5. 如果 ax_true_client_ip 是本地 IP 地址且 x_forwarded_for_ip 为 null，则将 ax_resolved_client_ip 设置为 (not set)。

拨打电话的设备的操作系统版本。

将此版本用作 OS 系列 (ax_ua_os_family) 的第二个“展开细目”维度有助于查看操作系统版本。

调用客户端的 IP 地址，存储在 proxy.client.ip 流变量中。这通常是呼入电话的 X-Forwarded-For 地址， 这是 Edge 在上次外部 TCP 握手中收到的 IP 地址。这可以是调用客户端，也可以是负载均衡器。如果 X-Forwarded-For 标头中有多个 IP，则这是最后列出的 IP。

在使用 Akamai 等路由产品来捕获客户端的真实 IP 地址时， 客户端 IP 通过 HTTP 标头 True-Client-IP 传递给 Edge。此维度会从该标头捕获真实的客户端 IP。

为了确定通过 ax_resolved_client_ip 访问的原始客户端 IP 地址 维度，Edge 使用 ax_true_client_ip 和 x_forwarded_for_ip 维度。

指向目标服务的资源路径（不包括网域），不包括查询参数。

例如，Apigee 示例目标 http://mocktarget.apigee.net 包含若干资源，其中包括可返回问候语的 /user。无论您的 API 代理如何调用 http://mocktarget.apigee.net/user，request_path 都是 /user。

指向目标服务的资源路径（不包括网域），包括查询参数。

例如，Apigee 示例目标 http://mocktarget.apigee.net 包含若干资源，其中包括 /user?user={name} 资源和查询参数，可用于返回对所提供名称的自定义问候语。无论您的 API 代理如何调用 http://mocktarget.apigee.net/user?user=Dude，request_uri 都是 /user?user=Dude。

用于进行 API 调用的用户代理或软件代理的名称。示例：

• 通过 Chrome 拨打电话的 Pixel XL：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
• 通过 Chrome 拨打电话的 iPad：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：curl/7.51.0

用户代理的版本。

将此版本用作“用户代理系列”(ax_ua_agent_family) 的第二个“展开细目”维度有助于获取代理系列的版本。

已在代理的 <TargetEndpoint> 中定义的指向目标服务的资源路径（不包括网域），不包括查询参数。

例如，假设 API 代理调用以下目标：

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

在此示例中，target_basepath 为 /user。

如果目标为：

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

target_basepath 将为 null。

在 Trace 工具中，当您在流程图末尾选择 AX 图标时，target.basepath 流变量会映射到 target_basepath 维度。

目标服务向 API 代理返回的 HTTP 响应状态代码，例如 200、404、503 等。

值为“null”表示请求从未到达目标服务。由响应缓存政策处理响应或请求处理中出现故障，便会发生这种情况。

这与响应状态代码 (response_status_code) 维度不同。

在 API 代理的 TargetEndpoint 中定义的目标服务的完整网址。

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

在此示例中，target_url 为 http://mocktarget.apigee.net/user?user=Dude。

请注意，您还可以在 API 代理处理期间使用 target.url 流变量替换此网址。

在代理中 链接以及使用 script 代码时 目标 (Node.js) 中，调用代理中的 target_url 为 null。

X-Forwarded-For 标头中的 IP 地址列表。

为了确定通过 ax_resolved_client_ip 访问的原始客户端 IP 地址 维度，Edge 使用 ax_true_client_ip 和 x_forwarded_for_ip 维度。

根据 24 小时制，进行 API 调用的 2 位数小时。例如，在晚上 10 点到 11 点之间进行 API 调用，则 ax_hour_of_day 为 22。

时间值采用 UTC 格式。