

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon CloudWatch 監控 RDS Proxy 指標
<a name="rds-proxy.monitoring"></a>

 您可以使用 Amazon CloudWatch 來監控 RDS Proxy。CloudWatch 會收集並處理來自代理的原始資料，進而將這些資料轉換為便於讀取且幾近即時的指標。若要在 CloudWatch 主控台中尋找這些指標，請選擇**Metrics (指標)**，然後選擇 **RDS**，並選擇 **Per-Proxy Metrics (每代理指標)**。如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》的[使用 Amazon CloudWatch 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)。

**注意**  
 RDS 會針對與代理關聯的每個基礎 Amazon EC2 執行個體發佈這些指標。單一代理可能由一個以上的 EC2 執行個體服務。使用 CloudWatch 統計資料彙總所有關聯執行個體之間的代理值。  
 其中一些指標可能會在 Proxy 第一次成功連線之後才顯示。

 在 RDS Proxy 日誌中，每個項目均會以關聯的代理端點名稱作為前綴。此名稱可以是您針對使用者定義端點所指定的名稱，也可以是執行讀取/寫入請求的代理預設端點的特殊名稱 `default`。

 所有 RDS Proxy 指標都在群組 `proxy` 中。

 每個代理端點都有其自己的 CloudWatch 指標。您可以獨立監控每個代理端點的用量。如需代理端點的詳細資訊，請參閱[使用 Amazon RDS Proxy 端點](rds-proxy-endpoints.md).

 您可以使用下列其中一個維度集來彙總每個指標的值。例如，藉由使用 `ProxyName` 維度集，您可以分析特定代理的所有流量。透過使用其他維度集，您可以用不同的方式來分割指標。您可以根據每個代理的不同端點或目標資料庫，或者每個資料庫的讀取/寫入和唯讀流量來分割指標。
+   維度集 1：`ProxyName`
+   維度集 2：`ProxyName`、`EndpointName`
+   維度集 3：`ProxyName`、`TargetGroup`、`Target`
+   維度集 4：`ProxyName`、`TargetGroup`、`TargetRole`


|  指標  |  描述  |  有效期間  |  CloudWatch 維度集  | 
| --- | --- | --- | --- | 
|  `AvailabilityPercentage`   |   目標群組在維度所指出的角色中可供使用的時間百分比。此指標每分鐘報告一次。此指標最實用的統計資料是 `Sum`。  |  1 分鐘  |  [Dimension set 4](#proxy-dimension-set-4)  | 
| ClientConnections  |   目前的用戶端連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 `Sum`。  |   1 分鐘   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| ClientConnectionsClosed  |   已關閉的用戶端連線數。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| ClientConnectionsInSetup |  目前開啟的用戶端連線數量，但尚未完成設定。此指標每分鐘報告一次。此指標最有用的統計資料是「總和」。  |  1 分鐘  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
|  `ClientConnectionsNoTLS`   |  不具有 Transport Layer Security (TLS) 的目前用戶端連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 Sum。 |  1 分鐘 |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
|  `ClientConnectionsReceived`   |   接收到的用戶端連線要求數。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| ClientConnectionsSetupFailedAuth  |   因身分驗證或 TLS 設定錯誤而失敗的用戶端連線嘗試次數。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| ClientConnectionsSetupSucceeded  |   使用任何具有或不具 TLS 的身分驗證機制成功建立的用戶端連線數。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| ClientConnectionsTLS  |  具有 TLS 的目前用戶端連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 Sum。 | 1 分鐘 |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| DatabaseConnectionRequests  |   建立資料庫連線的要求數目。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
|  `DatabaseConnectionRequestsWithTLS`   |  要透過 TLS 建立資料庫連線的要求數目。此指標最實用的統計資料是 Sum。 |  1 分鐘或以上  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| DatabaseConnections  |   目前的資料庫連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 `Sum`。  |   1 分鐘   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
|  `DatabaseConnectionsBorrowLatency`   |  代理為了取得資料庫連線而受到監控所花費的時間 (以毫秒為單位)。此指標最實用的統計資料是 Sum。 |  1 分鐘或以上  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| DatabaseConnectionsCurrentlyBorrowed  |   目前借用狀態中的資料庫連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 `Sum`。  |   1 分鐘   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| DatabaseConnectionsCurrentlyInTransaction  |   交易中的目前資料庫連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 `Sum`。  |   1 分鐘   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| DatabaseConnectionsCurrentlySessionPinned  |   由於變更工作階段狀態之用戶端要求中的操作而遭到鎖定的目前資料庫連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 `Sum`。  |   1 分鐘   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| DatabaseConnectionsSetupFailed  |   失敗的資料庫連線要求數目。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| DatabaseConnectionsSetupSucceeded  |   使用或不使用 TLS 成功建立的資料庫連線數。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
|  `DatabaseConnectionsWithTLS`   |  具有 TLS 的目前資料庫連線數。此指標每分鐘報告一次。此指標最實用的統計資料是 Sum。 |  1 分鐘  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| MaxDatabaseConnectionsAllowed  |   允許的資料庫連線數上限。此指標每分鐘報告一次。此指標最實用的統計資料是 `Sum`。  |   1 分鐘   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
|  `QueryDatabaseResponseLatency`   |  資料庫回應查詢已花費的時間 (以毫秒為單位)。此指標最實用的統計資料是 Average。 |  1 分鐘或以上  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| QueryRequests  |   收到的查詢數。包含多個陳述式的查詢會計算為一個查詢。此指標最實用的統計資料是 `Sum`。  |   1 分鐘或以上   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| QueryRequestsNoTLS  |  從非 TLS 連線收到的查詢數。包含多個陳述式的查詢會計算為一個查詢。此指標最實用的統計資料是 Sum。 |  1 分鐘或以上  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
|  `QueryRequestsTLS`   |  從 TLS 連線收到的查詢數。包含多個陳述式的查詢會計算為一個查詢。此指標最實用的統計資料是 Sum。 |  1 分鐘或以上  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
| QueryResponseLatency  |  取得查詢請求與代理回應請求之間的時間 (以毫秒為單位)。此指標最實用的統計資料是 Average。 |  1 分鐘或以上  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 

 您可以在 AWS 管理主控台 中的 CloudWatch 下方找到 RDS Proxy 活動的記錄。每個代理在**日誌群組**頁面中都有一筆記錄。

**重要**  
 這些日誌檔是供人類使用，用於故障診斷，而非程式設計存取。日誌檔的格式和內容可能會變更。  
 尤其是，較舊的日誌不包含指示每個請求端點的任何前綴。在較新的日誌中，每個項目均會以關聯的代理端點名稱作為前綴。此名稱可以是您針對使用者定義端點所指定的名稱，也可以是請求的 `default` 特殊名稱 (使用代理的預設端點)。