本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 日誌記錄和監控
監控是維護 MemoryDB 和其他 AWS 解決方案的可靠性、可用性和效能的重要部分。 AWS 提供下列監控工具來監看 MemoryDB、在發生錯誤時回報，以及適時採取自動動作：
+ *Amazon CloudWatch* AWS 會即時監控您的 AWS 資源和您在 上執行的應用程式。您可以收集和追蹤指標、建立自訂儀板表，以及設定警示，在特定指標達到您指定的閾值時通知您或採取動作。例如，您可以讓 CloudWatch 追蹤 CPU 使用量或其他 Amazon EC2 執行個體指標，並在需要時自動啟動新的執行個體。如需詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。
+ *Amazon CloudWatch Logs* 可讓您監控、存放和存取來自 Amazon EC2 執行個體、CloudTrail 及其他來源的日誌檔案。CloudWatch Logs 可監控日誌檔案中的資訊，並在達到特定閾值時通知您。您也可以將日誌資料存檔在高耐用性的儲存空間。如需詳細資訊，請參閱 [Amazon CloudWatch Logs 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)。
+ *AWS CloudTrail* 會擷取由 AWS 您的帳戶發出或代表發出的 API 呼叫和相關事件，並將日誌檔案交付至您指定的 Amazon S3 儲存貯體。您可以識別呼叫的使用者和帳戶 AWS、進行呼叫的來源 IP 地址，以及呼叫的時間。如需詳細資訊，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
# 使用 Amazon CloudWatch 監控 MemoryDB
您可以使用 CloudWatch 監控 MemoryDB，這會收集原始資料並將其處理為可讀且近乎即時的指標。這些統計資料會保留 15 個月，以便您存取歷史資訊，並更清楚 Web 應用程式或服務的執行效能。您也可以設定留意特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。
下列各節列出 MemoryDB 的指標和維度。
**Topics**
+ [主機層級指標](metrics.HostLevel.md)
+ [MemoryDB 的指標](metrics.memorydb.md)
+ [應監控哪些指標？](metrics.whichshouldimonitor.md)
+ [選擇指標統計資料與期間](metrics.ChoosingStatisticsAndPeriods.md)
+ [監控 CloudWatch 指標](cloudwatchmetrics.md)
# 主機層級指標
`AWS/MemoryDB` 命名空間包含下列個別節點的主機層級指標。
**另請參閱**
+ [MemoryDB 的指標](metrics.memorydb.md)
| 指標 | 描述 | 單位 |
| --- | --- | --- |
| CPUUtilization | 整部主機的 CPU 使用率百分比。由於 Valkey 和 Redis OSS 是單執行緒，我們建議您監控具有 4 個或更多 vCPUs節點的 EngineCPUUtilization 指標。 | 百分比 |
| FreeableMemory | 主機上可用的記憶體數量。此數字衍生自 RAM 中的記憶體，以及作業系統報告為可釋放的緩衝區。 | 位元組 |
| NetworkBytesIn | 主機已從網路讀取的位元組數。 | 位元組 |
| NetworkBytesOut | 執行個體在所有網路界面上送出的位元組數目。 | 位元組 |
| NetworkPacketsIn | 執行個體在所有網路界面上收到的封包數目。此指標識別單一執行個體上的傳入流量 (封包數目)。 | 計數 |
| NetworkPacketsOut | 執行個體在所有網路界面上送出的封包數目。此指標識別單一執行個體上的傳出流量 (封包數目)。 | 計數 |
| NetworkBandwidthInAllowanceExceeded | 因傳入的彙總頻寬超過執行個體的上限而成形的封包數目。 | 計數 |
| NetworkConntrackAllowanceExceeded | 因為連線追蹤超過執行個體的上限且無法建立新的連線，而成形的封包數目。這可能會導致傳送或傳回執行個體流量的封包遺失。 | 計數 |
| NetworkBandwidthOutAllowanceExceeded | 因傳出的彙總頻寬超過執行個體的上限而成形的封包數目。 | 計數 |
| NetworkPacketsPerSecondAllowanceExceeded | 因雙向每秒封包數超過執行個體的上限而成形的封包數目。 | 計數 |
| NetworkMaxBytesIn | 每分鐘接收位元組的每秒爆量上限。 | 位元組 |
| NetworkMaxBytesOut | 每分鐘傳輸位元組的每秒爆量上限。 | 位元組 |
| NetworkMaxPacketsIn | 每分鐘接收封包的每秒爆量上限。 | 計數 |
| NetworkMaxPacketsOut | 每分鐘傳輸封包的每秒爆量上限。 | 計數 |
| SwapUsage | 主機已使用的交換空間的量。 | 位元組 |
# MemoryDB 的指標
`AWS/MemoryDB` 命名空間包含下列指標。
除了 `ReplicationLag`、`SuccessfulWriteRequestLatency`、 `EngineCPUUtilization`和 之外`SuccessfulReadRequestLatency`，這些指標衍生自 Valkey 和 Redis OSS **info**命令。每個指標都會在節點層級計算。
如需 **INFO**命令的完整文件，請參閱 [INFO](http://valkey.io/commands/info)。
**另請參閱:**
+ [主機層級指標](metrics.HostLevel.md)
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/memorydb/latest/devguide/metrics.memorydb.html)
這些是來自 **info commandstats** 的特定命令類型彙整。commandstats 區段會根據命令類型提供統計資料，包括呼叫次數。
如需可用命令的完整清單，請參閱 [命令](https://valkey.io/commands)。
| 指標 | 描述 | 單位 |
| --- | --- | --- |
| EvalBasedCmds | 以 eval 為基礎之命令的命令總數。這透過加總 commandstats eval和 衍生自 統計資料evalsha。 | 計數 |
| GeoSpatialBasedCmds | 以 geospatial- 為基礎的之命令的命令總數。這是衍生自 commandstats 統計資料。加總了下列 geo 類型的所有命令而得出：geoadd、geodist、geohash、geopos、georadius 及 georadiusbymember。 | 計數 |
| GetTypeCmds | read-only 類型命令的總數。這是透過加總所有read-only類型命令 commandstats (get、hget、lrange、 等） scard衍生自 統計資料。 | 計數 |
| HashBasedCmds | 雜湊類型命令總數。這透過加總對一或多個雜湊 (hget、hkeys、hdel、 等） hvals採取行動的所有命令，衍生自 commandstats統計資料。 | 計數 |
| HyperLogLogBasedCmds | 以 HyperLogLog 為基礎的命令總數。這透過加總所有pf類型的命令 (pfadd、pfmerge、 pfcount等），衍生自 commandstats統計資料。 | 計數 |
| JsonBasedCmds | JSON 類型命令總數。這透過加總處理一或多個 JSON 文件物件的所有命令，衍生自 commandstats統計資料。 | 計數 |
| KeyBasedCmds | 金鑰類型命令總數。這衍生自 commandstats 統計資料，加總了跨多個資料結構 (del、rename、 expire等） 對一或多個索引鍵執行動作的所有命令。 | 計數 |
| ListBasedCmds | 清單類型命令總數。這透過加總對一或多個清單 (lindex、lrange、ltrim、 等） lpush採取行動的所有命令，衍生自 commandstats統計資料。 | 計數 |
| PubSubBasedCmds | pub/sub 功能的命令總數。這透過加總用於 pub/sub 功能的所有命令衍生自commandstats統計資料：psubscribe、publish、pubsubpunsubscribe、、 subscribe和 unsubscribe。 | 計數 |
| SearchBasedCmds | 次要索引和搜尋命令的總數，包括讀取和寫入命令。這透過加總處理次要索引的所有搜尋命令，衍生自 commandstats統計資料。 | 計數 |
| SearchBasedGetCmds | 次要索引和搜尋唯讀命令的總數。這透過加總所有次要索引和搜尋取得命令，衍生自 commandstats統計資料。 | 計數 |
| SearchBasedSetCmds | 次要索引和搜尋寫入命令的總數。這透過加總所有次要索引和搜尋集命令，衍生自 commandstats統計資料。 | 計數 |
| SearchNumberOfIndexes | 索引的總數。 | 計數 |
| SearchNumberOfIndexedKeys | 索引鍵總數 | 計數 |
| SearchTotalIndexSize | 所有索引使用的記憶體 （位元組）。 | 位元組 |
| SetBasedCmds | 集合類型命令總數。這透過加總對一或多個集合 (scard、sdiff、sadd、 sunion等） 執行動作的所有命令，衍生自 commandstats統計資料。 | 計數 |
| SetTypeCmds | write 類型命令的總數。這透過加總在資料 (set、hset、lpop、 等） sadd上操作的所有命令mutative類型，衍生自 commandstats統計資料。 | 計數 |
| SortedSetBasedCmds | 有序集合類型命令總數。這透過加總對一或多個已排序集合 (zcount、zrange、zadd、 等） zrank執行動作的所有命令，衍生自 commandstats統計資料。 | 計數 |
| StringBasedCmds | 字串類型命令總數。這透過加總對一或多個字串 (strlen、setrange、 等） setex執行動作的所有命令，衍生自 commandstats統計資料。 | 計數 |
| StreamBasedCmds | 串流類型命令總數。這透過加總對一或多個串流資料類型 (xrange、xlen、xdel、 等） xadd執行動作的所有命令，衍生自 commandstats統計資料。 | 計數 |
# 應監控哪些指標？
下列 CloudWatch 指標提供 MemoryDB 效能的良好洞見。在大多數的案例中，我們建議您為這些指標設定 CloudWatch 警示，讓您可以在發生效能問題前先採取修正動作。
**Topics**
+ [CPUUtilization](#metrics-cpu-utilization)
+ [EngineCPUUtilization](#metrics-engine-cpu-utilization)
+ [SwapUsage](#metrics-swap-usage)
+ [移出](#metrics-evictions)
+ [CurrConnections](#metrics-curr-connections)
+ [記憶體](#metrics-memory)
+ [網路](#metrics-network)
+ [Latency (延遲)](#metrics-latency)
+ [複寫](#metrics-replication)
## CPUUtilization
此為主機層級指標，以百分比報告。如需詳細資訊，請參閱[主機層級指標](metrics.HostLevel.md)。
對於具有 2 個或以下 vCPU 的小型節點類型，請使用 `CPUUtilization ` 指標來監控工作負載。
一般而言，我們建議您將閾值設為您可用 CPU 的 90%。由於 Valkey 和 Redis OSS 是單執行緒，實際閾值應計算為節點總容量的一部分。例如，假設您使用擁有二核心的節點類型。在此情況下，CPUUtilization 的閾值將為 90/2 或 45%。若要尋找節點類型擁有的核心 (vCPUs) 數量，請參閱 [MemoryDB 定價](https://aws.amazon.com/memorydb/pricing/?p=ps)。
您需要根據您正在使用的節點中的核心數量來判斷自己的閾值。如果您超過此閾值，且主要工作負載來自讀取請求，請新增僅供讀取複本來擴展叢集。如果主要工作負載來自寫入請求，我們建議您新增更多碎片，將寫入工作負載分散到更多主節點。
**提示**
`CPUUtilization`您或許可以使用指標 來報告 Valkey 或 Redis OSS 引擎核心上的用量百分比`EngineCPUUtilization`，而不是使用主機層級指標 。若要查看此指標是否在您的節點上可用，以及如需詳細資訊，請參閱 [ MemoryDB 的指標](https://docs.aws.amazon.com/memorydb/latest/devguide/metrics.memorydb.html)。
對於具有 4vCPUs或更多的較大節點類型，您可能需要使用 `EngineCPUUtilization` 指標，該指標會報告 Valkey 或 Redis OSS 引擎核心上的用量百分比。若要查看此指標是否在您的節點上可用，如需詳細資訊，請參閱 [ MemoryDB 的指標](https://docs.aws.amazon.com/memorydb/latest/devguide/metrics.memorydb.html)。
## EngineCPUUtilization
對於具有 4vCPUs或更多的較大節點類型，您可能需要使用 `EngineCPUUtilization` 指標，該指標會報告 Valkey 或 Redis OSS 引擎核心上的用量百分比。若要查看此指標是否在您的節點上可用，以及如需詳細資訊，請參閱 [ MemoryDB 的指標](https://docs.aws.amazon.com/memorydb/latest/devguide/metrics.memorydb.html)。
## SwapUsage
此為主機層級指標，以位元組報告。如需詳細資訊，請參閱[主機層級指標](metrics.HostLevel.md)。
如果 `FreeableMemory` CloudWatch 指標接近 0 （即低於 100MB)，或`SwapUsage`指標大於`FreeableMemory`指標，則節點可能會受到記憶體壓力。
## 移出
這是引擎指標。建議您根據應用程式需求，親自判斷此指標的警示閾值。
## CurrConnections
這是引擎指標。建議您根據應用程式需求，親自判斷此指標的警示閾值。
*CurrConnections* 的數字增加，可能表示您的應用程式發生問題。您需要調查應用程式行為才能處理此問題。
## 記憶體
記憶體是 Valkey 和 Redis OSS 的核心層面。為避免資料遺失以及因應資料集的未來成長而調整，了解叢集的記憶體使用率是必要的。有關節點記憶體使用率的統計資料，請參閱 [INFO](https://valkey.io/commands/info) 命令的記憶體區段。
## 網路
叢集網路頻寬容量的決定因素之一，是您選取的節點類型。如需節點網路容量的詳細資訊，請參閱 [Amazon MemoryDB 定價](https://aws.amazon.com/memorydb/pricing/)。
## Latency (延遲)
延遲指標`SuccessfulWriteRequestLatency`和`SuccessfulReadRequestLatency`測量 Valkey 引擎的 MemoryDB 回應請求所需的總時間。
**注意**
在 Valkey 用戶端上啟用 CLIENT REPLY 的情況下使用 Valkey 管道時，可能會發生 `SuccessfulWriteRequestLatency`和 `SuccessfulReadRequestLatency`指標的膨脹值。Valkey pipeline 是一種透過一次發出多個命令來改善效能的技術，無需等待對每個個別命令的回應。為了避免膨脹值，建議您使用 [CLIENT REPLY OFF](https://valkey.io/commands/client-reply/) 將 Redis 用戶端設定為管道命令。
## 複寫
遭複寫的資料量可透過 `ReplicationBytes` 指標顯示。您可以`MaxReplicationThroughput`針對複寫容量輸送量進行監控。建議在達到最大複寫容量輸送量時新增更多碎片。
`ReplicationDelayedWriteCommands` 也可以指出工作負載是否超過最大複寫容量輸送量。如需 MemoryDB 中複寫的詳細資訊，請參閱[了解 MemoryDB 複寫](https://docs.aws.amazon.com/memorydb/latest/devguide/replication.html)
# 選擇指標統計資料與期間
雖然 CloudWatch 允許您為每個指標選擇任何統計數字及期間，並非所有組合都有用。例如，CPUUtilization 的平均值 (Average)、最小值 (Minimum)、最大值 (Maximum) 統計資料相當有用，但總和 (Sum) 統計資料則否。
所有 MemoryDB 範例都會針對每個個別節點發佈 60 秒的持續時間。在任何 60 秒期間內，節點指標只會包含單一範例。
# 監控 CloudWatch 指標
MemoryDB 和 CloudWatch 已整合，因此您可以收集各種指標。您可以使用 CloudWatch 來監控這些指標。
**注意**
下列範例需使用 CloudWatch 命令列工具。如需 CloudWatch 和下載開發人員工具的詳細資訊，請參閱 [CloudWatch 產品頁面](https://aws.amazon.com/cloudwatch)。
下列程序說明如何使用 CloudWatch 來收集過去一小時叢集的儲存空間統計資料。
**注意**
以下範例中提供的 `StartTime`和 `EndTime`值僅供說明之用。請務必為您的節點替換適當的開始和結束時間值。
如需 MemoryDB 限制的資訊，請參閱 MemoryDB [AWS 的服務限制](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_memorydb)。
## 監控 CloudWatch 指標 （主控台）
**收集叢集的 CPU 使用率統計資料**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。
1. 選取您要檢視指標的節點。
**注意**
選取 20 個以上的節點時，會停用主控台上的指標檢視。
1. 在 AWS 管理主控台的**叢集**頁面上，按一下一或多個叢集的名稱。
叢集的詳細資訊頁面隨即出現。
1. 按一下視窗頂端的 **Nodes (節點)** 標籤。
1. 在詳細資訊視窗的**節點**索引標籤上，選取要檢視指標的節點。
主控台視窗底部會顯示可用的 CloudWatch 指標清單。
1. 按一下 **CPU Utilization (CPU 使用率)** 指標。
隨即開啟 CloudWatch 主控台，並顯示您選取的指標。若要變更顯示的指標，可以使用 **Statistic (統計數字)** 和 **Period (期間)** 下拉式清單方塊和 **Time Range (時間範圍)** 索引標籤。
## 使用 CloudWatch CLI 監控 CloudWatch 指標
**收集叢集的 CPU 使用率統計資料**
+ 使用 CloudWatch 命令**aws cloudwatch get-metric-statistics**搭配下列參數 （請注意，開始和結束時間僅顯示為範例；您將需要替換自己的適當開始和結束時間）：
若為 Linux、macOS 或 Unix：
```
1. aws cloudwatch get-metric-statistics CPUUtilization \
2. --dimensions=ClusterName=mycluster,NodeId=0002" \
3. --statistics=Average \
4. --namespace="AWS/MemoryDB" \
5. --start-time 2013-07-05T00:00:00 \
6. --end-time 2013-07-06T00:00:00 \
7. --period=60
```
針對 Windows：
```
1. mon-get-stats CPUUtilization ^
2. --dimensions=ClusterName=mycluster,NodeId=0002" ^
3. --statistics=Average ^
4. --namespace="AWS/MemoryDB" ^
5. --start-time 2013-07-05T00:00:00 ^
6. --end-time 2013-07-06T00:00:00 ^
7. --period=60
```
## 使用 CloudWatch API 監控 CloudWatch 指標
**收集叢集的 CPU 使用率統計資料**
+ 使用下列參數呼叫 CloudWatch API `GetMetricStatistics` (請注意，顯示的開始和結束時間僅為範例；您必須將其替代為適當的開始和結束時間)：
+ `Statistics.member.1``=Average`
+ `Namespace``=AWS/MemoryDB`
+ `StartTime``=2013-07-05T00:00:00`
+ `EndTime``=2013-07-06T00:00:00`
+ `Period``=60`
+ `MeasureName``=CPUUtilization`
+ `Dimensions``=ClusterName=mycluster,NodeId=0002`
**Example**
```
1. http://monitoring.amazonaws.com/
2. ?SignatureVersion=4
3. &Action=GetMetricStatistics
4. &Version=2014-12-01
5. &StartTime=2013-07-16T00:00:00
6. &EndTime=2013-07-16T00:02:00
7. &Period=60
8. &Statistics.member.1=Average
9. &Dimensions.member.1="ClusterName=mycluster"
10. &Dimensions.member.2="NodeId=0002"
11. &Namespace=Amazon/memorydb
12. &MeasureName=CPUUtilization
13. &Timestamp=2013-07-07T17%3A48%3A21.746Z
14. &AWS;AccessKeyId=<&AWS; Access Key ID>
15. &Signature=
```
# 監控 MemoryDB 事件
當叢集發生重大事件時，MemoryDB 會傳送通知給特定的 Amazon SNS 主題。範例包含新增節點失敗、新增節點成功、安全群組修改和其他事件。藉由監控重要事件，您可以了解叢集目前的狀態，並根據事件採取正確的動作。
**Topics**
+ [管理 MemoryDB Amazon SNS 通知](mdbevents.sns.md)
+ [檢視 MemoryDB 事件](mdbevents.viewing.md)
+ [事件通知和 Amazon SNS](memorydbsns.md)
# 管理 MemoryDB Amazon SNS 通知
您可以設定 MemoryDB 使用 Amazon Simple Notification Service (Amazon SNS) 傳送重要叢集事件的通知。在這些範例中，您會使用 Amazon SNS 主題的 Amazon Resource Name (ARN) 設定叢集以接收通知。
**注意**
本主題假設您已註冊 Amazon SNS，並已設定及訂閱 Amazon SNS 主題。如需操作方式的相關資訊，請參閱 [Amazon Simple Notification Service 開發人員指南](https://docs.aws.amazon.com/sns/latest/dg/)。
## 新增 Amazon SNS 主題
下列各節說明如何使用 AWS 主控台、 AWS CLI或 MemoryDB API 新增 Amazon SNS 主題。
### 新增 Amazon SNS 主題 (主控台)
下列程序示範如何為叢集新增 Amazon SNS 主題。
**注意**
此程序也可用於修改 Amazon SNS 主題。
**為叢集新增或修改 Amazon SNS 主題 (主控台)**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。
1. 在 **Clusters (叢集)** 中，選擇您要新增或修改 Amazon SNS 主題 ARN 的叢集。
1. 選擇 **Modify** (修改)。
1. 在 **Modify Cluster (修改叢集)** 的 **Topic for SNS Notification (SNS 通知的主題)** 下，選擇您要新增的 SNS 主題，或選擇 **Manual ARN input (手動輸入 ARN)**，並輸入 Amazon SNS 主題的 ARN。
1. 選擇 **Modify** (修改)。
### 新增 Amazon SNS 主題 (AWS CLI)
若要新增或修改叢集的 Amazon SNS 主題，請使用 AWS CLI 命令 `update-cluster`。
下列程式碼範例會將 Amazon SNS 主題 ARN 新增至 *my-cluster*。
若為 Linux、macOS 或 Unix：
```
aws memorydb update-cluster \
--cluster-name my-cluster \
--sns-topic-arn arn:aws:sns:us-east-1:565419523791:memorydbNotifications
```
針對 Windows：
```
aws memorydb update-cluster ^
--cluster-name my-cluster ^
--sns-topic-arn arn:aws:sns:us-east-1:565419523791:memorydbNotifications
```
如需詳細資訊，請參閱 [UpdateCluster](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateCluster.html)。
### 新增 Amazon SNS 主題 (MemoryDB API)
若要新增或更新叢集的 Amazon SNS 主題，請使用下列參數呼叫 `UpdateCluster`動作：
+ `ClusterName``=my-cluster`
+ `SnsTopicArn``=arn%3Aaws%3Asns%3Aus-east-1%3A565419523791%3AmemorydbNotifications`
若要新增或更新叢集的 Amazon SNS 主題，請呼叫 `UpdateCluster`動作。
如需詳細資訊，請參閱 [UpdateCluster](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateCluster.html)。
## 啟用和停用 Amazon SNS 通知
您可以為叢集開啟或關閉通知。下列程序示範如何停用 Amazon SNS 通知。
### 啟用和停用 Amazon SNS 通知 (主控台)
**使用 停用 Amazon SNS 通知 AWS 管理主控台**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。
1. 選擇您要修改通知之叢集左側的選項按鈕。
1. 選擇 **Modify** (修改)。
1. 在 **Modify Cluster (修改叢集)** 的 **Topic for SNS Notification (SNS 通知的主題)** 下，選擇 *Disable Notifications (停用通知)*。
1. 選擇 **Modify** (修改)。
### 啟用和停用 Amazon SNS 通知 (AWS CLI)
若要停用 Amazon SNS 通知，請搭配下列參數使用 `update-cluster` 命令：
若為 Linux、macOS 或 Unix：
```
aws memorydb update-cluster \
--cluster-name my-cluster \
--sns-topic-status inactive
```
針對 Windows：
```
aws memorydb update-cluster ^
--cluster-name my-cluster ^
--sns-topic-status inactive
```
### 啟用和停用 Amazon SNS 通知 (MemoryDB API)
若要停用 Amazon SNS 通知，請搭配下列參數呼叫 `UpdateCluster` 動作：
+ `ClusterName``=my-cluster`
+ `SnsTopicStatus``=inactive`
此呼叫會傳回類似以下的輸出：
**Example**
```
1. https://memory-db.us-east-1.amazonaws.com/
2. ?Action=UpdateCluster
3. &ClusterName=my-cluster
4. &SnsTopicStatus=inactive
5. &Version=2021-01-01
6. &SignatureVersion=4
7. &SignatureMethod=HmacSHA256
8. &Timestamp=20210801T220302Z
9. &X-Amz-Algorithm=Amazon4-HMAC-SHA256
10. &X-Amz-Date=20210801T220302Z
11. &X-Amz-SignedHeaders=Host
12. &X-Amz-Expires=20210801T220302Z
13. &X-Amz-Credential=
14. &X-Amz-Signature=
```
# 檢視 MemoryDB 事件
MemoryDB 會記錄與叢集、安全群組和參數群組相關的事件。此資訊包含事件的日期和時間、事件的來源名稱和來源類型，以及事件的描述。您可以使用 MemoryDB 主控台、 AWS CLI `describe-events`命令或 MemoryDB API 動作 從日誌輕鬆擷取事件`DescribeEvents`。
下列程序說明如何檢視過去 24 小時 (1440 分鐘） 的所有 MemoryDB 事件。
## 檢視 MemoryDB 事件 （主控台）
下列程序使用 MemoryDB 主控台顯示事件。
**使用 MemoryDB 主控台檢視事件**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。
1. 在左側導覽窗格中，選擇**事件**。
*事件*畫面隨即出現，列出所有可用的事件。清單的每一列代表一個事件，並顯示事件來源、事件類型 （例如叢集、參數群組、accl、安全群組或子網路群組）、事件的 GMT 時間，以及事件的描述。
您可以使用 **Filter (篩選條件)** 指定要查看事件清單中的所有事件，還是只查看特定類型的事件。
## 檢視 MemoryDB 事件 (AWS CLI)
若要使用 產生 MemoryDB 事件清單 AWS CLI，請使用 命令 `describe-events`。您可以使用選用參數來控制列出的事件類型、列出的事件時間範圍，要列出的最大事件數等等。
下列程式碼最多列出 40 個叢集事件。
```
aws memorydb describe-events --source-type cluster --max-results 40
```
下列程式碼會列出過去 24 小時 (1440 分鐘) 內的所有事件。
```
aws memorydb describe-events --duration 1440
```
`describe-events` 命令的輸出會類似下列內容。
```
{
"Events": [
{
"Date": "2021-03-29T22:17:37.781Z",
"Message": "Added node 0001 in Availability Zone us-east-1a",
"SourceName": "memorydb01",
"SourceType": "cluster"
},
{
"Date": "2021-03-29T22:17:37.769Z",
"Message": "cluster created",
"SourceName": "memorydb01",
"SourceType": "cluster"
}
]
}
```
如需可用參數和允許參數值這類項目的詳細資訊，請參閱 [https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-events.html](https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-events.html)。
## 檢視 MemoryDB 事件 (MemoryDB API)
若要使用 MemoryDB API 產生 MemoryDB 事件清單，請使用 `DescribeEvents`動作。您可以使用選用參數來控制列出的事件類型、列出的事件時間範圍，要列出的最大事件數等等。
下列程式碼列出 40 個最新的 叢集事件。
```
https://memory-db.us-east-1.amazonaws.com/
?Action=DescribeEvents
&MaxResults=40
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&SourceType=cluster
&Timestamp=20210802T192317Z
&Version=2021-01-01
&X-Amz-Credential=
```
下列程式碼列出過去 24 小時 (1440 分鐘） 的叢集事件。
```
https://memory-db.us-east-1.amazonaws.com/
?Action=DescribeEvents
&Duration=1440
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&SourceType=cluster
&Timestamp=20210802T192317Z
&Version=2021-01-01
&X-Amz-Credential=
```
上述動作產生的輸出應該會類似下列內容。
```
cluster created
cluster
2021-08-02T18:22:18.202Z
my-memorydb-primary
(...output omitted...)
e21c81b4-b9cd-11e3-8a16-7978bb24ffdf
```
如需可用參數和允許參數值這類項目的詳細資訊，請參閱 [https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeEvents.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeEvents.html)。
# 事件通知和 Amazon SNS
當叢集上發生重大事件時，MemoryDB 可以使用 Amazon Simple Notification Service (SNS) 發佈訊息。此功能可用來重新整理連接到叢集個別節點端點之用戶端電腦上的伺服器清單。
**注意**
如需 Amazon Simple Notification Service (SNS) 的詳細資訊，包含定價資訊和 Amazon SNS 說明文件的連結，請參閱 [Amazon SNS 產品頁面](https://aws.amazon.com/sns)。
通知會發佈至特定的 Amazon SNS *主題*。下列是通知的需求：
+ 只能為 MemoryDB 通知設定一個主題。
+ 擁有 Amazon SNS 主題 AWS 的帳戶必須與擁有啟用通知之叢集的帳戶相同。
## MemoryDB 事件
下列 MemoryDB 事件會觸發 Amazon SNS 通知：
| 事件名稱 | 訊息 | 描述 |
| --- | --- | --- |
| MemoryDB：AddNodeComplete | "Modified number of nodes from %d to %d" | 節點已新增至叢集並可供使用。 |
| MemoryDB：AddNodeFailed | "Failed to modify number of nodes from %d to %d due to insufficient free IP addresses" | 節點無法新增，因為沒有足夠的可用 IP 地址。 |
| MemoryDB：ClusterParametersChanged | "Updated parameter group for the cluster" 在建立時，也傳送 `"Updated to use a ParameterGroup %s"` | 一個或多個叢集參數已變更。 |
| MemoryDB：ClusterProvisioningComplete | "Cluster created." | 叢集的佈建已完成，且叢集中的節點已就緒可供使用。 |
| MemoryDB：ClusterProvisioningFailed | "Failed to create cluster due to incompatible network state. %s" | 嘗試在不存在的虛擬私有雲端 (VPC) 中啟動新叢集。 |
| MemoryDB：ClusterRestoreFailed | "Restore from %s failed for node %s. %s" | MemoryDB 無法使用快照資料填入叢集。這可能是因為 Amazon S3 中不存在快照檔案，或該檔案的許可不正確。如果您描述叢集，狀態將為 `restore-failed`。您需要刪除叢集並重新開始。 如需詳細資訊，請參閱[使用外部建立的快照植入新叢集](snapshots-seeding-redis.md)。 |
| MemoryDB：ClusterScalingComplete | `"Succeeded applying modification to node type to %s."` | 已成功擴展叢集。 |
| MemoryDB：ClusterScalingFailed | `"Failed applying modification to node type to %s."` | 叢集上的向上擴展操作失敗。 |
| MemoryDB：NodeReplaceStarted | "Recovering node %s" | MemoryDB 偵測到執行節點的主機降級或無法連線，並已開始取代節點。 取代節點的 DNS 項目不會變更。 在多數情況下，當發生此事件時，您不需要重新整理用戶端的伺服器清單。不過，即使 MemoryDB 已取代節點，某些用戶端程式庫仍可能會停止使用節點；在此情況下，應用程式應該在此事件發生時重新整理伺服器清單。 |
| MemoryDB：NodeReplaceComplete | "Finished recovery for node %s" | MemoryDB 偵測到執行節點的主機已降級或無法連線，且已完成取代節點。 取代節點的 DNS 項目不會變更。 在多數情況下，當發生此事件時，您不需要重新整理用戶端的伺服器清單。不過，即使 MemoryDB 已取代節點，某些用戶端程式庫仍可能會停止使用節點；在此情況下，應用程式應該在此事件發生時重新整理伺服器清單。 |
| MemoryDB：CreateClusterComplete | "Cluster created" | 叢集已成功建立。 |
| MemoryDB：CreateClusterFailed | "Failed to create cluster due to unsuccessful creation of its node(s)." 和 "Deleting all nodes belonging to this cluster." | 叢集尚未建立。 |
| MemoryDB：DeleteClusterComplete | "Cluster deleted." | 叢集和所有相關節點的刪除已完成。 |
| MemoryDB：FailoverComplete | `"Failover to replica node %s completed"` | 已成功容錯移轉至複本節點。 |
| MemoryDB：NodeReplacementCanceled | "The replacement of node %s which was scheduled during the maintenance window from start time: %s, end time: %s has been canceled" | 叢集中原先已排程替換的節點，已不再排程替換。 |
| MemoryDB：NodeReplacementRescheduled | "The replacement in maintenance window for node %s has been re-scheduled from previous start time: %s, previous end time: %s to new start time: %s, new end time: %s" | 叢集中原先已排程替換的節點，已重新排程在通知中所述的新視窗期間進行替換。 如需您可以採取哪些動作的資訊，請參閱[替換節點](nodes.nodereplacement.md)。 |
| MemoryDB：NodeReplacementScheduled | "The node %s is scheduled for replacement during the maintenance window from start time: %s to end time: %s" | 您叢集中的節點，已排程在通知中所述的視窗期間進行替換。 如需您可以採取哪些動作的資訊，請參閱[替換節點](nodes.nodereplacement.md)。 |
| MemoryDB：RemoveNodeComplete | "Removed node %s" | 節點已從叢集中移除。 |
| MemoryDB：SnapshotComplete | "Snapshot %s succeeded for node %s" | 快照已成功完成。 |
| MemoryDB：SnapshotFailed | "Snapshot %s failed for node %s" | 快照失敗。如需更詳細的原因，請參閱叢集的事件。 如果您描述快照，請參閱 [DescribeSnapshots](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeSnapshots.html)，狀態將為 `failed`。 |
# 使用 記錄 MemoryDB API 呼叫 AWS CloudTrail
MemoryDB 已與 服務整合 AWS CloudTrail，此服務提供由使用者、角色或 MemoryDB 中的 AWS 服務所採取之動作的記錄。CloudTrail 會將 MemoryDB 的所有 API 呼叫擷取為事件，包括來自 MemoryDB 主控台的呼叫，以及來自對 MemoryDB API 操作的程式碼呼叫。如果您建立線索，您可以將 CloudTrail 事件持續交付至 Amazon S3 儲存貯體，包括 MemoryDB 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的**事件歷史記錄**檢視最新事件。您可以使用 CloudTrail 所收集的資訊，判斷向 MemoryDB 提出的請求、提出請求的 IP 地址、提出請求的人員、提出請求的時間，以及其他詳細資訊。
若要進一步了解 CloudTrail，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
## CloudTrail 中的 MemoryDB 資訊
當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。在 MemoryDB 中發生活動時，該活動會記錄在 CloudTrail 事件中，以及**事件歷史記錄**中的其他服務 AWS 事件。您可以在 AWS 帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱《使用 CloudTrail 事件歷史記錄檢視事件》[https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。
若要持續記錄您 AWS 帳戶中的事件，包括 MemoryDB 的事件，請建立追蹤。線索能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。根據預設，當您在主控台建立權杖時，權杖會套用到所有區域。線索會記錄 AWS 分割區中所有區域的事件，並將日誌檔案傳送到您指定的 Amazon S3 儲存貯體。此外，您可以設定其他 AWS 服務，以進一步分析和處理 CloudTrail 日誌中所收集的事件資料。如需詳細資訊，請參閱下列內容：
+ [建立追蹤的概觀](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 支援的服務和整合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [設定 CloudTrail 的 Amazon SNS 通知](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [從多個區域接收 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)，以及[從多個帳戶接收 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
CloudTrail 會記錄所有 MemoryDB 動作。例如，對 `CreateCluster`、`DescribeClusters` 和 `UpdateCluster` 動作發出的呼叫會在 CloudTrail 記錄檔案中產生專案。
每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：
+ 該請求是否使用根或 IAM 使用者憑證提出。
+ 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全憑證。
+ 請求是否由其他 AWS 服務提出。
如需詳細資訊，請參閱 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。
## 了解 MemoryDB 日誌檔案項目
追蹤是一種組態，能讓事件以日誌檔案的形式交付到您指定的 Amazon S3 儲存貯體。CloudTrail 日誌檔案包含一或多個日誌專案。一個事件為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔案並非依公有 API 呼叫追蹤記錄的堆疊排序，因此不會以任何特定順序出現。
以下範例顯示的是展示 `CreateCluster` 動作的 CloudTrail 日誌項目。
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "IAMUser",
"principalId": "EKIAUAXQT3SWDEXAMPLE",
"arn": "arn:aws:iam::123456789012:user/john",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "john"
},
"eventTime": "2021-07-10T17:56:46Z",
"eventSource": "memorydb.amazonaws.com",
"eventName": "CreateCluster",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.01",
"userAgent": "aws-cli/2.2.29 Python/3.9.6 Darwin/19.6.0 source/x86_64 prompt/off command/memorydb.create-cluster",
"requestParameters": {
"clusterName": "memorydb-cluster",
"nodeType": "db.r6g.large",
"subnetGroupName": "memorydb-subnet-group",
"aCLName": "open-access"
},
"responseElements": {
"cluster": {
"name": "memorydb-cluster",
"status": "creating",
"numberOfShards": 1,
"availabilityMode": "MultiAZ",
"clusterEndpoint": {
"port": 6379
},
"nodeType": "db.r6g.large",
"engineVersion": "6.2",
"enginePatchVersion": "6.2.6",
"parameterGroupName": "default.memorydb-redis6",
"parameterGroupStatus": "in-sync",
"subnetGroupName": "memorydb-subnet-group",
"tLSEnabled": true,
"aRN": "arn:aws:memorydb:us-east-1:123456789012:cluster/memorydb-cluster",
"snapshotRetentionLimit": 0,
"maintenanceWindow": "tue:06:30-tue:07:30",
"snapshotWindow": "09:00-10:00",
"aCLName": "open-access",
"dataTiering": "false",
"autoMinorVersionUpgrade": true
}
},
"requestID": "506fc951-9ae2-42bb-872c-98028dc8ed11",
"eventID": "2ecf3dc3-c931-4df0-a2b3-be90b596697e",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management"
}
```
以下範例顯示的是展示 `DescribeClusters` 動作的 CloudTrail 日誌項目。請注意，對於所有 MemoryDB 描述和列出呼叫 (`Describe*` 和 `List*`)， `responseElements`區段會移除並顯示為 `null`。
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "IAMUser",
"principalId": "EKIAUAXQT3SWDEXAMPLE",
"arn": "arn:aws:iam::123456789012:user/john",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "john"
},
"eventTime": "2021-07-10T18:39:51Z",
"eventSource": "memorydb.amazonaws.com",
"eventName": "DescribeClusters",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.01",
"userAgent": "aws-cli/2.2.29 Python/3.9.6 Darwin/19.6.0 source/x86_64 prompt/off command/memorydb.describe-clusters",
"requestParameters": {
"maxResults": 50,
"showShardDetails": true
},
"responseElements": null,
"requestID": "5e831993-52bb-494d-9bba-338a117c2389",
"eventID": "32a3dc0a-31c8-4218-b889-1a6310b7dd50",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management"
}
```
下列範例顯示記錄 `UpdateCluster`動作的 CloudTrail 日誌項目。
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "IAMUser",
"principalId": "EKIAUAXQT3SWDEXAMPLE",
"arn": "arn:aws:iam::123456789012:user/john",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "john"
},
"eventTime": "2021-07-10T19:23:20Z",
"eventSource": "memorydb.amazonaws.com",
"eventName": "UpdateCluster",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.01",
"userAgent": "aws-cli/2.2.29 Python/3.9.6 Darwin/19.6.0 source/x86_64 prompt/off command/memorydb.update-cluster",
"requestParameters": {
"clusterName": "memorydb-cluster",
"snapshotWindow": "04:00-05:00",
"shardConfiguration": {
"shardCount": 2
}
},
"responseElements": {
"cluster": {
"name": "memorydb-cluster",
"status": "updating",
"numberOfShards": 2,
"availabilityMode": "MultiAZ",
"clusterEndpoint": {
"address": "clustercfg.memorydb-cluster.cde8da.memorydb.us-east-1.amazonaws.com",
"port": 6379
},
"nodeType": "db.r6g.large",
"engineVersion": "6.2",
"EnginePatchVersion": "6.2.6",
"parameterGroupName": "default.memorydb-redis6",
"parameterGroupStatus": "in-sync",
"subnetGroupName": "memorydb-subnet-group",
"tLSEnabled": true,
"aRN": "arn:aws:memorydb:us-east-1:123456789012:cluster/memorydb-cluster",
"snapshotRetentionLimit": 0,
"maintenanceWindow": "tue:06:30-tue:07:30",
"snapshotWindow": "04:00-05:00",
"autoMinorVersionUpgrade": true,
"DataTiering": "false"
}
},
"requestID": "dad021ce-d161-4365-8085-574133afab54",
"eventID": "e0120f85-ab7e-4ad4-ae78-43ba15dee3d8",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management"
}
```
以下範例顯示的是展示 `CreateUser` 動作的 CloudTrail 日誌項目。請注意，對於包含敏感資料的 MemoryDB 呼叫，該資料將在對應的 CloudTrail 事件中修訂，如下`requestParameters`節所示。
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "IAMUser",
"principalId": "EKIAUAXQT3SWDEXAMPLE",
"arn": "arn:aws:iam::123456789012:user/john",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "john"
},
"eventTime": "2021-07-10T19:56:13Z",
"eventSource": "memorydb.amazonaws.com",
"eventName": "CreateUser",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.01",
"userAgent": "aws-cli/2.2.29 Python/3.9.6 Darwin/19.6.0 source/x86_64 prompt/off command/memorydb.create-user",
"requestParameters": {
"userName": "memorydb-user",
"authenticationMode": {
"type": "password",
"passwords": [
"HIDDEN_DUE_TO_SECURITY_REASONS"
]
},
"accessString": "~* &* -@all +@read"
},
"responseElements": {
"user": {
"name": "memorydb-user",
"status": "active",
"accessString": "off ~* &* -@all +@read",
"aCLNames": [],
"minimumEngineVersion": "6.2",
"authentication": {
"type": "password",
"passwordCount": 1
},
"aRN": "arn:aws:memorydb:us-east-1:123456789012:user/memorydb-user"
}
},
"requestID": "ae288b5e-80ab-4ff8-989a-5ee5c67cd193",
"eventID": "ed096e3e-16f1-4a23-866c-0baa6ec769f6",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management"
}
```