翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # MemoryDB イベントのモニタリング 重要なイベントがクラスター上で発生すると、MemoryDB から特定の Amazon SNS トピックに通知が送信されます。例には、ノードの追加の失敗、ノードの追加の成功、セキュリティグループの変更などが含まれます。主要イベントをモニタリングすることで、クラスターの現在の状態を知り、イベントに基づいて是正措置を取ることができます。 **Topics** + [MemoryDB Amazon SNS 通知の管理](mdbevents.sns.md) + [MemoryDB イベントの表示](mdbevents.viewing.md) + [イベント通知と Amazon SNS](memorydbsns.md) # MemoryDB Amazon SNS 通知の管理 Amazon Simple Notification Service (Amazon SNS) を使用して重要なクラスターイベントの通知が送信されるように MemoryDB を設定できます。これらの例では、Amazon SNS トピックの Amazon リソースネーム（ARN）を使用してクラスターを設定し、通知を受け取るようにします。 **注記** このトピックでは、Amazon SNS にサインアップし、Amazon SNS トピックをセットアップおよびサブスクライブしていることを前提としています。これを行う方法の詳細については、「[Amazon Simple Notification Service デベロッパーガイド](https://docs.aws.amazon.com/sns/latest/dg/)」を参照してください。 ## Amazon SNS トピックを追加する 以下のセクションでは、Amazon SNS トピックを AWS コンソール、AWS CLI、または MemoryDB API を使用して追加する方法について説明します。 ### Amazon SNS トピックを追加する (コンソール) 以下の手順は、クラスターの Amazon SNS トピックを追加する方法を示しています。 **注記** このプロセスは、Amazon SNS トピックの変更に使用できます。 **クラスターの Amazon SNS トピックを追加または変更するには (コンソール)** 1. AWS マネジメントコンソール にサインインして、[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) で MemoryDB のコンソールを開きます。 1. **クラスター** で、Amazon SNS トピック ARN を追加または変更するクラスターを選択します。 1. **変更**を選択します。 1. **クラスターを変更** の **SNS 通知のトピック** で、追加する SNS トピックを選択します。または、**手動 ARN 入力** を選択して Amazon SNS トピックの ARN を入力します。 1. **変更**を選択します。 ### 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` アクションを呼び出します。 詳細については、「[クラスターの更新](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateCluster.html)」を参照してください。 ## Amazon SNS 通知の有効化と無効化 クラスターでは、通知を有効または無効にすることができます。次の手順は、Amazon SNS 通知を無効にする方法を示しています。 ### Amazon SNS 通知の有効化と無効化（コンソール） **AWS マネジメントコンソール を使用して Amazon SNS 通知を無効にするには** 1. AWS マネジメントコンソール にサインインして、[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) で MemoryDB のコンソールを開きます。 1. 通知を変更するクラスターの左側にあるラジオボタンを選択します。 1. **変更**を選択します。 1. **クラスターを変更** の **SNS 通知のトピック** で、*通知を無効にする* を選択します。 1. **変更**を選択します。 ### 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://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) で MemoryDB のコンソールを開きます。 1. 左側のナビゲーションペインで **イベント** を選択します。 *イベント*画面が開き、利用可能なすべてのイベントが一覧表示されます。Events 画面のリスト内の各行は 1 個のイベントを表し、イベントのソース、イベントの種類 (キャッシュクラスター、キャッシュパラメータグループ、キャッシュセキュリティグループ、キャッシュサブネットグループ)、イベントの GMT 時間、イベントの説明が表示されます。 **Filter** を使用して、イベントリストにすべてのイベントを表示するか特定タイプのイベントのみを表示するかを指定できます。 ## メモリデータベースイベントの表示 (AWS CLI) ‭AWS CLI を使用して MemoryDB イベントのリストを作成するには、`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 SNS ドキュメントへのリンクを含む、Amazon Simple Notification Service (SNS) の詳細については、「[Amazon SNS 製品ページ](https://aws.amazon.com/sns)」を参照してください。 通知は、指定した Amazon SNS *トピック* に発行されます。通知の要件は以下のとおりです: + MemoryDB 通知に対して設定できるトピックは 1 つだけです。 + Amazon SNS トピックを所有する AWS アカウントは、通知が有効になっているクラスターを所有するアカウントと同じアカウントである必要があります。 ## MemoryDB イベント 以下の MemoryDB イベントにより、Amazon SNS 通知がトリガーされます: | イベント名 | メッセージ | 説明 | | --- | --- | --- | | MemoryDB: ノード追加が完了しました | "Modified number of nodes from %d to %d" | ノードがクラスターに追加され、使用可能になっています。 | | IPアドレスの空き不足による 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"` も送ります。 | 1 つ以上のクラスターパラメータが変更されました。 | | MemoryDB: クラスタープロビジョニングが完了しました | "Cluster created." | クラスターのプロビジョニングが完了し、クラスター内のノードが使用可能になりました。 | | MemoryDB: 互換性のないネットワーク状態のため、クラスタープロビジョニングに失敗しました | "Failed to create cluster due to incompatible network state. %s" | 存在しない 仮想プライベートクラウド (VPC) に新しいキャッシュクラスターに起動する試みが行われました。 | | MemoryDB: クラスターの復元に失敗しました | "Restore from %s failed for node %s. %s" | MemoryDB はスナップショットデータをクラスターに入力できませんでした。これは、Amazon S3 にスナップショットファイルが存在しないか、そのファイルに対する不適切なアクセス許可が原因である可能性があります。クラスターを記述する場合は、ステータスは `restore-failed` ‬です。クラスターを削除して最初からやり直す必要があります。 詳細については、「[外部で作成されたスナップショットによる新しいクラスターのシード](snapshots-seeding-redis.md)」を参照してください。 | | MemoryDB: クラスタースケーリングが完了しました | `"Succeeded applying modification to node type to %s."` | キャッシュクラスターのスケールアップが正常に完了しました。 | | MemoryDB: クラスタースケーリングに失敗しました | `"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`です。‬‬ |