數據分析指標、維度和篩選器參考資料

平均交易次數，代表每秒 API Proxy 要求數。 請注意 這段時間內的交易次數 (每次平均交易次數) 秒中如果數值小於 2，在使用者介面自訂報表中就可能顯示為 0 。

API 語法：tps

使用回應快取 (而非 回應。

API 語法：sum(cache_hit)

傳回指定特定交易中每次交易 L1 (記憶體內) 快取的元素數量 時間範圍。舉例來說，如果您選擇 max 做為一天的時間範圍，且 在特定交易中，快取中最多的元素數量為 12 個。 則計數為 12以 avg 來說，如果「 在查詢的時間範圍內，快取計數為 5、6 和 7，則平均為 6。L1 快取是記憶體內快取，而不是 L2 資料庫快取，詳情請參閱「快取內部」。

API 語法：avg(ax_cache_l1_count)

指定時間範圍內的政策錯誤總數。

政策錯誤通常是在設計上發生。例如「Verify API 金鑰」政策擲回 要求中傳遞無效的 API 金鑰，以及尖峰流量防範政策時發生錯誤 如果 API 呼叫數量超過政策所定義的限制，就會發生錯誤。以下內容 這項指標可協助您在 API 中找出潛在問題的位置。例如： 按照 developer_app 維度分組的 policy_error 指標，也許能助您一臂之力 某個應用程式的 API 金鑰或 OAuth 權杖已過期；或者您可能會發現 特定 API Proxy 擲回了大量尖峰流量錯誤，您發現 但 Proxy 的尖峰流量限制不考慮節慶流量增加的情況。

只有在錯誤導致 API Proxy 故障時，數據分析才會記錄政策錯誤。 例如，假設政策的 continueOnError 屬性設為 true，即使政策失敗，API Proxy 仍會繼續處理要求。 那麼數據分析中就不會記錄政策錯誤。

「錯誤政策名稱」(ax_execution_fault_policy_name) 維度可協助您 依政策名稱分組政策錯誤

目標失敗 (例如 404 或 503) 不算是違反政策。這些 計為 API Proxy 失敗 (is_error)。

API 語法：sum(policy_error)

在指定時間範圍內，API Proxy 失敗的總次數。代理 假如政策失敗或執行階段發生錯誤 (例如 404 或 503 錯誤。

您可以透過 Proxy (apiproxy) 維度依 Proxy 將 API Proxy 失敗分組。

API 語法：sum(is_error)

時間長度 (平均值、最小值或最大值)，以毫秒為單位。 要求 Edge 處理傳入要求從要求達到上限時起算 Edge 將要求轉送至目標服務時結束。

使用不同的維度，依 API Proxy 檢查要求處理延遲時間 開發人員應用程式、區域等等

API 語法：max(request_processing_latency)

Edge 接收的要求酬載大小 (以位元組為單位)。

API 語法：avg(request_size)

在指定時間內執行回應快取政策的總次數 。

由於回應快取政策會附加在 API Proxy 中的兩個位置 (在 而在回應中傳回一次)，則通常會在 API 呼叫中執行兩次。快取 「get」快取的「put」則分別計為一次執行

但如果 <SkipCacheLookup> 政策元素評估為 true (在要求中)；如果 <SkipCachePopulation> 政策元素評估為 true (在回應中)。

在追蹤記錄工具中： 您可以按一下已執行 API 呼叫中的「回應快取」圖示，查看 responsecache.executed 流量變數至 查看是否有快取執行作業 (值為 1)。

API 語法：sum(ax_cache_executed)

時間長度 (平均值、最小值或最大值)，以毫秒為單位。 要求 Edge 處理 API 回應API Proxy 收到執行個體的時間起算時間 Apigee 將回應轉送給原始服務後，就會結束於目標服務的回應 呼叫。

使用不同的維度，即可依 API 檢查回應處理延遲時間 Proxy、區域等

API 語法：min(response_processing_latency)

傳回給用戶端的回應酬載大小， 位元組。

API 語法：max(response_size)

目標服務的 5xx 回應總數。這些是目標服務 並非由 Apigee 造成的錯誤

API 語法：sum(target_error)

時間長度 (總和、平均值、最小值或最大值)， 毫秒：供目標伺服器回應呼叫。這個指標 可讓您瞭解目標伺服器的效能Edge 轉寄要求時起算的時間 並在 Edge 收到回應時結束

請注意，如果 API 呼叫從快取傳回回應 (使用 Response Cache 政策)，呼叫一律不會觸及目標服務，也不會成為目標服務之一 會記錄回應時間指標。

API 語法：avg(target_response_time)

時間長度 (總和、平均值、最小值或最大值)， 毫秒，從 Edge 收到用戶端要求到 Edge 將回應傳回用戶端。時間包括網路負擔 (例如 負載平衡器和路由器執行工作所需的時間) 延遲、回應處理延遲時間和目標回應時間 (如有提供回應) 而非快取)。

使用不同的維度 可讓您依 API Proxy 檢查處理延遲時間 開發人員應用程式、區域等等

API 語法：avg(total_response_time)

指定時間範圍內由 Edge 處理的 API 呼叫總數。

使用維度，以對您來說最有意義的流量方式分類流量。

API 語法：sum(message_count)

API 產品名稱 (包含要呼叫的 API Proxy)。為了讓您 這個維度，發出呼叫的開發人員應用程式必須與一或多個 API 建立關聯 ，而且要呼叫的 Proxy 必須檢查 API 。金鑰或權杖已與 API 建立關聯 產品。若需更多資訊，請參閲 首要之務：如何產生完整的數據分析資料。

如果不符合上述條件，畫面會顯示「(not set)」這個值。另請參閱 數據分析實體值「(未設定)」是什麼？是什麼意思？

包含存取之回應快取值的鍵。如要進一步瞭解 如何建構回應快取金鑰，請參閱回應快取政策。

在追蹤記錄工具中： 選取讀取或寫入快取的「回應快取」政策時， 您可以在 responsecache.cachekey 流程變數中查看這個值。

包含回應快取政策所用鍵/值的快取名稱。 前置字串為 orgName__envName__。舉例來說，如果機構是「foo」這個 是「test」快取名稱為「myCache」ax_cache_name 是 foo__test__myCache.

在追蹤記錄工具中： 當您選取回應快取政策時，可以在 responsecache.cachename 流程變數。

回應快取的來源快取等級 (「L1」記憶體內或「L2」資料庫) 擷取。這個維度也會顯示「CACHE_MISS」回應的 目標而非快取 (並依據目標回應重新整理回應快取)； 或是要求中的快取金鑰無效時快取金鑰的上限為 大小為 2 KB。

在追蹤記錄工具中： 當您選取回應快取政策時，可以在 responsecache.cachesource 流程變數。

如要進一步瞭解快取層級，請參閱「快取內部」。

發出 API 呼叫的開發人員應用程式的用戶端金鑰 (API 金鑰) 以 API 金鑰的形式傳送的要求，或包含在 OAuth 權杖中。

如要取得這個維度，您必須將接聽呼叫的 Proxy 設為 取得有效的 API 金鑰或 OAuth 權杖開發人員應用程式會取得 API 金鑰，可用來 當應用程式在 Edge 中註冊時，會產生 OAuth 權杖。若需更多資訊，請參閲 首要之務：如何產生完整的數據分析資料。

如果不符合上述條件，畫面會顯示「(not set)」這個值。另請參閱「Analytics 實體值「(未設定)」是什麼？是什麼意思？

向 Edge 註冊的開發人員應用程式會發出 API 呼叫。

如要取得這項維度，應用程式必須與一或多項 API 產品建立關聯 必須包含要呼叫的 API Proxy，而 Proxy 必須檢查 API 金鑰， 與 API 呼叫一併傳送的 OAuth 權杖。金鑰或權杖可用於識別開發人員應用程式。適用對象 如需更多資訊，請參閱首要之務：如何產生完整的數據分析資料。

如果不符合上述條件，畫面會顯示「(not set)」這個值。另請參閱「Analytics 實體值「(未設定)」是什麼？是什麼意思？

已註冊 Edge 的開發人員並在應用程式發出 API 呼叫時收到的電子郵件。

如要取得這個維度，開發人員必須將應用程式與一或多個建立關聯 包含所呼叫 API Proxy 的 API 產品，而 Proxy 必須檢查 與 API 呼叫一併傳送的 API 金鑰或 OAuth 權杖。金鑰或符記可用來識別開發人員 應用程式。詳情請參閱「首要之務：如何產生完整的數據分析資料」一文。

如果不符合上述條件，畫面會顯示「(not set)」這個值。另請參閱「Analytics 實體值「(未設定)」是什麼？是什麼意思？

由 Edge 產生的專屬開發人員 ID，格式為 org_name@@@org_name。

如要取得這個維度，開發人員必須將應用程式與一或多個建立關聯 包含要呼叫的 API Proxy 的 API 產品，而 Proxy 必須檢查 與 API 呼叫一起傳送的 API 金鑰或 OAuth 權杖。金鑰或符記可用來識別 開發人員。詳情請參閱「首要之務：如何產生完整的數據分析資料」一文。

如果不符合上述條件，畫面會顯示「(not set)」這個值。另請參閱「Analytics 實體值「(未設定)」是什麼？是什麼意思？

錯誤的錯誤程式碼。例如： messaging.adaptors.http.flow.GatewayTimeout

API Proxy 中引發錯誤的名 flow。例如「PreFlow」 「PostFlow」或是您建立的條件式流程名稱

請注意，用於 management API 的完整名稱為 ax_execution_fault_flow_name、 就不用換行

未發生任何錯誤的情況下，畫面會顯示「(未設定)」值。

引發錯誤的 API Proxy 流程狀態名稱，例如「PROXY_REQ_FLOW」或 「TARGET_RESP_FLOW」。

請注意，用於 management API 的完整名稱為 ax_execution_fault_flow_state、 就不用換行

擲回錯誤並導致 API 呼叫失敗的政策名稱。

請注意，用於 management API 的完整名稱為 ax_execution_fault_policy_name、 就不用換行

如果政策擲回錯誤，但政策根屬性 continueOnError 設為 true，API Proxy 流程會繼續不失敗，以及政策 因此不會計入失敗次數

在 API Proxy ProxyEndpoint 上設定的 BasePath。基本路徑不包含 的網域和通訊埠部分。舉例來說，假設 API Proxy 的基準網址為 https://apigeedocs-test.apigee.net/releasenotes/，基本路徑為 /releasenotes。

這個值也會儲存在 proxy.basepath 資料流變數中。

新增至 API Proxy 基本路徑的資源路徑。舉例來說，假設 API Proxy 基準網址為 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 不是空值且不含本機 IP 位址， 然後將 ax_resolved_client_ip 設為 ax_true_client_ip。
2. 否則，請將 ax_resolved_client_ip 設為以下項目的第一個非本機 IP 位址： x_forwarded_for_ip。
3. 如果 ax_true_client_ip 和 x_forwarded_for_ip 都含有 請將 ax_resolved_client_ip 設為 第一個本機 IP 位址 (位於 x_forwarded_for_ip 中)
4. 如果 ax_true_client_ip 和 x_forwarded_for_ip 都是空值， 將 ax_resolved_client_ip 設為 (not set)。
5. 如果 ax_true_client_ip 是本機 IP 位址，且 x_forwarded_for_ip 為空值，請將 ax_resolved_client_ip 設為 (not set)。

撥打電話的裝置作業系統版本。

很適合做為第二個「細查」工具搭載 OS 系列產品 (ax_ua_os_family)，查看作業系統版本。

呼叫用戶端的 IP 位址 (儲存在 proxy.client.ip 中) 「流程變數」。 這通常是來電的 X-Forwarded-For 地址。 這是從上次外部 TCP 握手接收的 IP 位址邊緣。這麼做 代表呼叫的用戶端或負載平衡器如果 Pod 中有多個 IP X-Forwarded-For 標頭，這是列出的最後一個 IP。

使用 Akamai 等轉送產品擷取客戶的真正 IP 位址時， 用戶端 IP 會透過 HTTP 標頭 True-Client-IP 傳遞至 Edge。這個 維度則會從該標頭擷取真正的用戶端 IP。

如要判斷原始用戶端 IP 位址，可透過 ax_resolved_client_ip 存取 Edge 會使用 ax_true_client_ip，而 x_forwarded_for_ip 個維度。

目標服務的資源路徑 (不含網域)，不含查詢 參數。

例如，Apigee 範例目標 http://mocktarget.apigee.net 包含多項資源，包括會傳回問候語的 /user。 無論 API Proxy 如何呼叫 http://mocktarget.apigee.net/user， request_path 為 /user。

目標服務的資源路徑 (不含網域)，包含查詢 參數。

例如，Apigee 範例目標 http://mocktarget.apigee.net 包含多項資源，包括 /user?user={name} 資源和查詢 參數，將自訂問候語傳回所提供的名稱。無論您的 API 是如何開發的 Proxy 呼叫 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)，取得代理程式系列的版本。

目標服務的資源路徑 (不含網域)，不含查詢 參數，定義於 Proxy 的 <TargetEndpoint> 中。

舉例來說，假設某個 API Proxy 呼叫下列目標：

<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 將為空值。

在追蹤記錄工具中 選取流程圖末端的 AX 圖示 target.basepath 流程變數會對應至 target_basepath 維度。

目標服務對 API Proxy 傳回的 HTTP 回應狀態碼，例如 200、404、503 等。

「null」的值表示要求從未到達目標服務。這種情況會發生在 回應快取政策或要求失敗時，就會傳回回應。 和資料處理之間

不同於回應狀態碼 (response_status_code) 維度。

在 API Proxy 的 TargetEndpoint 中定義的目標服務完整網址。

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

在這個範例中，target_url 是 http://mocktarget.apigee.net/user?user=Dude。

請注意，使用 target.url「資料流變數」。

在 Proxy 中 鏈結和使用指令碼 target (Node.js)，呼叫 Proxy 中的 target_url 為空值。

X-Forwarded-For 標頭中的 IP 位址清單。

如要判斷原始用戶端 IP 位址，可透過 ax_resolved_client_ip 存取 Edge 會使用 ax_true_client_ip，而 x_forwarded_for_ip 個維度。

以 24 小時制計算，也就是發出 API 呼叫的 2 位數小時。例如： 在下午 10 點到 11 點之間進行的 API 呼叫，ax_hour_of_day 為 22。

時間值是以世界標準時間為準。