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

# 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<br />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<br />Cache snapshot arn | 失敗 | serverless-cache | 無法建立快取 <cache-name>。提供的使用者群組 <user-group-name> 不存在。 | 
| 快取建立失敗 | Cache arn | 失敗 | serverless-cache | 無法建立快取 <cache-name>。從快照還原資料失敗，原因：<reason>。<br />失敗原因：[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<br />Snapshot arn | 建立 | serverless-cache-snapshot | 已建立快取 <cache-name> 的快照 <snapshot-name>。 | 
| 快照建立失敗 | Cache arn<br />Snapshot arn | 失敗 | serverless-cache-snapshot | 無法建立快取 <cache-name> 的快照。快照 <snapshot-name> 建立失敗，客戶受管金鑰 <key-id>，<reason>。<br />失敗原因訊息：[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<br />Snapshot arn | 失敗 | serverless-cache-snapshot | 無法建立快取 <cache-name> 的快照。快照 <snapshot-name> 建立失敗，原因：<reason>。<br />預設原因：[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<br />Snapshot arn-2 | 失敗 | serverless-cache-snapshot | 無法複製快照 <snapshot-name>。無法將快照 '%s' 複製到快照 '%s'，因為來源快照客戶受管金鑰為 <key-id>，<reason-name>。 | 
| 快照複製失敗 | Snapshot arn-1<br />Snapshot arn-2 | 失敗 | serverless-cache-snapshot | 無法複製快照 <snapshot-name>。無法將快照 '%s' 複製到快照 '%s'，因為目標快照客戶受管金鑰為 '%s' '%s'。 |