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

# Valkey 和 Redis OSS 無伺服器快取的指標和事件
<a name="serverless-metrics-events-redis"></a>

ElastiCache 提供各式各樣的指標和事件，可在使用無伺服器快取時進行監控。這包括 CloudWatch 指標、命令層級指標，以及可透過 Amazon EventBridge 擷取的事件日誌。

**Topics**
+ [無伺服器快取指標](#serverless-metrics)
+ [無伺服器快取事件](#serverless-events)

## 無伺服器快取指標
<a name="serverless-metrics"></a>

`AWS/ElastiCache` 命名空間包含 Valkey 或 Redis OSS 無伺服器快取的下列 CloudWatch 指標。

*Valkey 或 Redis OSS 的指標代碼*


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  BytesUsedForCache  |  儲存在快取中的資料所使用的位元組總數。  |  位元組  | 
|  ElastiCacheProcessingUnits  |  在快取上執行的請求所消耗的 ElastiCacheProcessingUnits (ECPU) 總數  |  計數  | 
|  SuccessfulReadRequestLatency  |  成功讀取請求的延遲。  |  微秒  | 
|  SuccessfulWriteRequestLatency  |  成功寫入請求的延遲  |  微秒  | 
|  TotalCmdsCount  |  快取上執行的所有命令總數  |  計數  | 
|  CacheHitRate  |  表示快取的命中率。這是使用 `cache_hits` 和 `cache_misses` 統計資料以下列方式計算的：`cache_hits /(cache_hits + cache_misses)`。  |  百分比  | 
|  CacheHits  |  快取中成功的唯讀索引鍵查詢次數。  |  計數  | 
|  CacheMisses  |  快取中未成功的唯讀金鑰查詢數量。  |  計數  | 
|  CurrConnections  |  快取的用戶端連線數。  |  計數  | 
|  ThrottledCmds  |  因為工作負載的擴展速度比 ElastiCache 能夠擴展的速度快，而遭到 ElastiCache 限流的請求數。  |  計數  | 
|  NewConnections  |  在此期間內，伺服器已接受的連線總數。  |  計數  | 
|  CurrItems  |  快取中的項目數。  |  計數  | 
|  CurrVolatileItems  |  使用 TTL 的快取中的項目數。  |  計數  | 
|  NetworkBytesIn  |  傳入快取的位元組總數  |  位元組  | 
|  NetworkBytesOut  |  從快取傳出的位元組總數  |  位元組  | 
|  移出  |  由快取移出的索引鍵計數  |  計數  | 
|  IamAuthenticationExpirations  |  過期的 IAM 驗證 Valkey 或 Redis OSS 連線總數。您可以在使用者指南中找到有關 [以 IAM 進行身分驗證](auth-iam.md) 的詳細資訊。  |  計數  | 
|  IamAuthenticationThrottling  |  限流 IAM 驗證的 Valkey 或 Redis OSS AUTH 或 HELLO 請求總數。您可以在使用者指南中找到有關 [以 IAM 進行身分驗證](auth-iam.md) 的詳細資訊。  |  計數  | 
|  KeyAuthorizationFailures  |  使用者嘗試存取他們沒有存取許可的金鑰失敗總次數。建議對此設定警示，以偵測未經授權的存取嘗試。  |  計數  | 
|  AuthenticationFailures  |  使用 AUTH 命令向 Valkey 或 Redis OSS 驗證失敗的嘗試總數。建議對此設定警示，以偵測未經授權的存取嘗試。  |  計數  | 
|  CommandAuthorizationFailures  |  使用者嘗試執行他們沒有呼叫許可的命令失敗總次數。建議對此設定警示，以偵測未經授權的存取嘗試。  |  計數  | 

**命令層級指標**

ElastiCache 也會發出下列命令層級指標。ElastiCache 會針對每種命令類型發出命令總計數，以及該命令類型消耗的 ECPU 數。


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  EvalBasedCmds  |  快取已接收到的 get 命令的數量。  |  計數  | 
|  EvalBasedCmdsECPUs  |  eval 型命令消耗的 ECPU 數。  |  計數  | 
|  GeoSpatialBasedCmds  |  以 geospatial- 為基礎的之命令的命令總數。這是衍生自 Valkey 或 Redis OSS 命令統計資料。這是藉由加總所有 geo 類型的命令所衍生：geoadd、geodist、geohash、geopos、georadius 和 georadiusbymember。  |  計數  | 
|  GeoSpatialBasedCmdsECPUs  |  geospatial 型命令消耗的 ECPU 數。  |  計數  | 
|  GetTypeCmds  |  唯讀類型命令的總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總所有唯讀類型命令 (get、hget、scard、lrange 等）。  |  計數  | 
|  GetTypeCmdsECPUs  |  讀取命令消耗的 ECPU 數。  |  計數  | 
|  HashBasedCmds  |  雜湊類型命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總處理一或多個雜湊 (hget、hkeys、hvals、hdel 等） 的所有命令。  |  計數  | 
|  HashBasedCmdsECPUs  |  hash 型命令消耗的 ECPU 數。  |  計數  | 
|  HyperLogLogBasedCmds  |  HyperLogLog 型命令的總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了命令的所有 pf 類型 (pfadd、pfcount、pfmerge 等）。  |  計數  | 
|  HyperLogLogBasedCmdsECPUs  |  HyperLogLog 型命令消耗的 ECPU 數。  |  計數  | 
|  JsonBasedCmds  |  JSON 命令的總數，包括讀取和寫入命令。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了對 JSON 金鑰作用的所有 JSON 命令。  |  計數  | 
|  JsonBasedCmdsECPUs  |  所有 JSON 命令消耗的 ECPU 數，包括讀取和寫入命令。  |  計數  | 
|  JsonBasedGetCmds  |  JSON 唯讀命令的總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了對 JSON 金鑰作用的所有 JSON 讀取命令。  |  計數  | 
|  JsonBasedGetCmdsECPUs  |  JSON 唯讀命令消耗的 ECPU 數。  |  計數  | 
|  JsonBasedSetCmds  |  JSON 寫入命令的總數。這衍生自 Valkey 或 Redis OSS commandstats 統計資料，加總了作用於 JSON 金鑰的所有 JSON 寫入命令。  |  計數  | 
|  JsonBasedSetCmdsECPUs  |  JSON 寫入命令消耗的 ECPU 數。  |  計數  | 
|  KeyBasedCmds  |  金鑰類型命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了跨多個資料結構 (del、 expire、rename 等） 處理一或多個金鑰的所有命令。  |  計數  | 
|  KeyBasedCmdsECPUs  |  key 型命令消耗的 ECPU 數。  |  計數  | 
|  ListBasedCmds  |  清單類型命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總處理一或多個清單的所有命令 (lindex、lrange、lpush、ltrim 等）。  |  計數  | 
|  ListBasedCmdsECPUs  |  list 型命令消耗的 ECPU 數。  |  計數  | 
|  NonKeyTypeCmds  |  非金鑰型命令的總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總所有不對金鑰採取行動的命令，例如 acl、dbsize 或 info。  |  計數  | 
|  NonKeyTypeCmdsECPUs  |  non-key 型命令消耗的 ECPU 數。  |  計數  | 
|  PubSubBasedCmds  |  pub/sub 功能的命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了用於 pub/sub 功能的所有命令：psubscribe、publish、pubsub、punsubscribe、ssubscribe、sunsubscribe、spublish、subscribe 和 unsubscribe。  |  計數  | 
|  PubSubBasedCmdsECPUs  |  pub/sub 型命令消耗的 ECPU 數。  |  計數  | 
|  SetBasedCmds  |  集合類型命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了作用於一或多個集合的所有命令 (Scard、sdiff、sadd、sunion 等）。  |  計數  | 
|  SetBasedCmdsECPUs  |  set 型命令消耗的 ECPU 數。  |  計數  | 
|  SetTypeCmds  |  寫入類型命令的總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總對資料 （集合、hset、sadd、lpop 等） 操作的所有命令類型。  |  計數  | 
|  SetTypeCmdsECPUs  |  寫入命令消耗的 ECPU 數。  |  計數  | 
|  SortedSetBasedCmds  |  有序集合類型命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了作用於一或多個排序集的所有命令 (zcount、zrange、zrank、zadd 等）。  |  計數  | 
|  SortedSetBasedCmdsECPUs  |  sorted 型命令消耗的 ECPU 數。  |  計數  | 
|  StringBasedCmds  |  字串類型命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總了作用於一或多個字串的所有命令 （字串、setex、setrange 等）。  |  計數  | 
|  StringBasedCmdsECPUs  |  string 型命令消耗的 ECPU 數。  |  計數  | 
|  StreamBasedCmds  |  串流類型命令總數。這衍生自 Valkey 或 Redis OSS 命令統計資料，加總處理一或多個串流資料類型的所有命令 (xrange、xlen、xadd、xdel 等）。  |  計數  | 
|  StreamBasedCmdsECPUs  |  stream 型命令消耗的 ECPU 數。  |  計數  | 

## 無伺服器快取事件
<a name="serverless-events"></a>



與您的無伺服器快取相關的 ElastiCache 日誌事件。此資訊包括事件的日期和時間、事件的來源名稱和來源類型，以及事件的描述。您可以使用 ElastiCache 主控台、AWS CLI describe-events 命令或 ElastiCache API 動作 從日誌輕鬆擷取事件`DescribeEvents`。

您可以選擇使用 Amazon EventBridge 來監控、擷取、轉換和處理 ElastiCache 事件。如需進一步了解，請參閱 Amazon EventBridge [入門指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)。

**檢視 ElastiCache 事件 (主控台)**

使用 ElastiCache 主控台檢視事件：

1. 登入AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) 的 ElastiCache 主控台

1. 若要查看所有可用事件的清單，請在導覽窗格中選擇 **Events (事件)**。

1. 在*事件*畫面上，清單中的每一列都代表一個事件，並顯示事件來源、事件類型、事件的 GMT 時間以及事件的說明。您可以使用 **Filter (篩選條件)** 指定要查看事件清單中的所有事件，還是只查看特定類型的事件。

**檢視 ElastiCache 事件 (AWS CLI)**

若要使用 產生 ElastiCache 事件清單AWS CLI，請使用 命令 describe-events。您可以使用選用參數來控制列出的事件類型、列出的事件時間範圍，要列出的最大事件數等等。

下列程式碼最多會列出 40 個無伺服器快取事件。

```
aws elasticache describe-events --source-type serverless-cache --max-items 40
```

下列程式碼會列出過去 24 小時 (1440 分鐘) 內無伺服器快取的所有事件。

```
aws elasticache describe-events --source-type serverless-cache --duration 1440
```

**無伺服器事件**

本節記錄您可能收到的不同類型無伺服器快取事件。

**無伺服器快取建立事件**


| Detail-Type | Description | 單位 | 來源 | 訊息 | 
| --- | --- | --- | --- | --- | 
|  快取已建立  |  Cache arn  |  建立  |  serverless-cache  |  快取 <cache-name> 已建立且可供使用。  | 
|  快取已建立  |  Cache arn Snapshot arn  |  建立  |  serverless-cache  |  快取 <cache-name> 已建立，並已從快照還原資料。您的快取可供使用。  | 
|  快取建立失敗  |  Cache arn  |  失敗  |  serverless-cache  |  無法建立快取 <cache-name>。沒有足夠的可用 IP 地址可用來建立 VPC 端點。  | 
|  快取建立失敗  |  Cache arn  |  失敗  |  serverless-cache  |  無法建立快取 <cache-name>。請求中提供的子網路無效。  | 
|  快取建立失敗  |  Cache arn  |  失敗  |  serverless-cache  |  無法建立快取 <cache-name>。已達建立 VPC 端點的配額限制。  | 
|  快取建立失敗  |  Cache arn  |  失敗  |  serverless-cache  |  無法建立快取 <cache-name>。您沒有建立 VPC 端點的許可。  | 
|  快取建立失敗  |  Cache arn  |  失敗  |  serverless-cache  |  無法建立快取 <cache-name>。使用者群組 <user-group-name> 中存在具有不相容 Valkey 或 Redis OSS 版本的使用者。  | 
|  快取建立失敗  |  Cache arn Cache snapshot arn  |  失敗  |  serverless-cache  |  無法建立快取 <cache-name>。提供的使用者群組 <user-group-name> 不存在。  | 
|  快取建立失敗  |  Cache arn  |  失敗  |  serverless-cache  |  無法建立快取 <cache-name>。從快照還原資料失敗，原因：<reason>。 失敗原因： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/AmazonElastiCache/latest/dg/serverless-metrics-events-redis.html)  | 

**無伺服器快取更新事件 (Valkey 或 Redis OSS)**


| Detail-Type | 資源清單 | Category | 來源 | 訊息 | 
| --- | --- | --- | --- | --- | 
|  快取已更新  |  Cache arn  |  組態變更  |  serverless-cache  |  快取 <cache-name> 的 SecurityGroups 已更新。  | 
|  快取已更新  |  Cache arn  |  組態變更  |  serverless-cache  |  快取 <cache-name> 的標籤已更新。  | 
|  快取更新失敗  |  Cache arn  |  組態變更  |  serverless-cache  |  快取 <cache-name> 更新失敗。使用者群組 <user-group-name> 中存在具有不相容 Valkey 或 Redis OSS 版本的使用者。  | 
|  快取更新失敗  |  Cache arn  |  組態變更  |  serverless-cache  |  快取 <cache-name> 更新失敗。SecurityGroups 更新失敗。  | 
|  快取更新失敗  |  Cache arn  |  組態變更  |  serverless-cache  |  快取 <cache-name> 更新失敗。SecurityGroups 更新失敗，因為許可不足。  | 
|  快取更新失敗  |  Cache arn  |  組態變更  |  serverless-cache  |  快取 <cache-name> 更新失敗。SecurityGroups 更新失敗，因為 SecurityGroups 無效。  | 

**無伺服器快取刪除事件 (Valkey 或 Redis OSS)**


| Detail-Type | 資源清單 | Category | 來源 | 訊息 | 
| --- | --- | --- | --- | --- | 
|  快取已刪除  |  Cache arn  |  刪除  |  serverless-cache  |  快取 <cache-name> 已刪除。  | 

**無伺服器快取用量限制事件 (Valkey 或 Redis OSS)**


| Detail-Type | Description | 單位 | 來源 | 訊息 | 
| --- | --- | --- | --- | --- | 
|  快取已更新  |  Cache arn  |  組態變更  |  serverless-cache  |  快取 <cache-name> 的限制已更新。  | 
|  即將達到快取限制  |  Cache arn  |  notification  |  serverless-cache  |  位置 <X> 使用超過 <Y>% 的每個位置限制 32 GB。例如，位置 10 使用超過 90% 的每個位置限制 32 GB。  | 
|  快取更新失敗  |  Cache arn  |  失敗  |  serverless-cache  |  快取 <cache-name> 的限制更新失敗，因為快取已刪除。  | 
|  快取更新失敗  |  Cache arn  |  失敗  |  serverless-cache  |  快取 <cache-name> 的限制更新失敗，因為組態無效。  | 
|  快取更新失敗  |  Cache arn  |  失敗  |  serverless-cache  |  快取 <cache-name> 的限制更新失敗，因為目前快取的資料超過新的限制。請先清空部分資料，再套用限制。  | 

**無伺服器快取快照事件 (Valkey 或 Redis OSS)**


| Detail-Type | 資源清單 | Category | 來源 | 訊息 | 
| --- | --- | --- | --- | --- | 
|  快照已建立  |  Cache arn Snapshot arn  |  建立  |  serverless-cache-snapshot  |  已建立快取 <cache-name> 的快照 <snapshot-name>。  | 
|  快照建立失敗  |  Cache arn Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法建立快取 <cache-name> 的快照。快照 <snapshot-name> 建立失敗，客戶受管金鑰 <key-id>，<reason>。 失敗原因訊息： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/AmazonElastiCache/latest/dg/serverless-metrics-events-redis.html)  | 
|  快照建立失敗  |  Cache arn Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法建立快取 <cache-name> 的快照。快照 <snapshot-name> 建立失敗，原因：<reason>。 預設原因： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/AmazonElastiCache/latest/dg/serverless-metrics-events-redis.html)  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至儲存貯體 %s，因為 ElastiCache 未具備該儲存貯體的許可。  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至儲存貯體 '%s'，因為儲存貯體中已有同名的物件。  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至儲存貯體 '%s'，因為儲存貯體擁有者帳戶 ID 已變更。  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至儲存貯體 '%s'，因為無法存取 S3 儲存貯體。  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至儲存貯體 '%s'，因為無法存取儲存貯體。  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至儲存貯體 '%s'，因為儲存貯體不存在。  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至具有來源快照客戶受管金鑰 %s 的儲存貯體 '%s'，<reason>。  | 
|  快照匯出失敗  |  Snapshot arn  |  失敗  |  serverless-cache-snapshot  |  無法匯出快取 <cache-name> 的快照。無法將快照匯出至儲存貯體 '%s'。  | 
|  快照複製失敗  |  Snapshot arn-1 Snapshot arn-2  |  失敗  |  serverless-cache-snapshot  |  無法複製快照 <snapshot-name>。無法將快照 '%s' 複製到快照 '%s'，因為來源快照客戶受管金鑰為 <key-id>，<reason-name>。  | 
|  快照複製失敗  |  Snapshot arn-1 Snapshot arn-2  |  失敗  |  serverless-cache-snapshot  |  無法複製快照 <snapshot-name>。無法將快照 '%s' 複製到快照 '%s'，因為目標快照客戶受管金鑰為 '%s' '%s'。  |