

# 使用 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 统计数据可汇总所有关联实例的代理值。  
 其中一些指标可能在代理第一次成功连接之后才可见。

 在 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 minute  |  [Dimension set 4](#proxy-dimension-set-4)  | 
| ClientConnections  |   当前客户端连接数。每分钟报告一次此指标。此指标最有用的统计数据是 `Sum`。  |   1 minute   |  [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 |  已打开但尚未完成设置的当前客户端连接数量。每分钟报告一次此指标。该指标最有用的统计数据是 Sum。  |  1 minute  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 2](#proxy-dimension-set-2)  | 
|  `ClientConnectionsNoTLS`   |  当前没有传输层安全性 (TLS) 的客户端连接的数量。每分钟报告一次此指标。此指标最有用的统计数据是 Sum。 |  1 minute |  [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 minute |  [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 minute   |  [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 minute   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| DatabaseConnectionsCurrentlyInTransaction  |   事务中的当前数据库连接数。每分钟报告一次此指标。此指标最有用的统计数据是 `Sum`。  |   1 minute   |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| DatabaseConnectionsCurrentlySessionPinned  |   由于客户端请求中更改会话状态的操作，当前固定的当前数据库连接数。每分钟报告一次此指标。此指标最有用的统计数据是 `Sum`。  |   1 minute   |  [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 minute  |  [Dimension set 1](#proxy-dimension-set-1), [Dimension set 3](#proxy-dimension-set-3), [Dimension set 4](#proxy-dimension-set-4)  | 
| MaxDatabaseConnectionsAllowed  |   允许的最大数据库连接数。每分钟报告一次此指标。此指标最有用的统计数据是 `Sum`。  |   1 minute   |  [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 活动的日志。每个代理在 **Log groups (日志组)** 页面中都有一个条目。

**重要**  
 这些日志供相关人员进行故障排除，而不是用于编程访问。日志的格式和内容可能会发生变化。  
 特别是，较旧的日志不包含指示每个请求的终端节点的任何前缀。在较新的日志中，每个条目都以关联的代理终端节点的名称作为前缀。此名称可以是您为用户定义的终端节点指定的名称，也可以是使用代理的默认终端节点的请求的特殊名称 `default`。