翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon SNS による ElastiCache イベントのモニタリング 重要なイベントがクラスター上で発生すると、ElastiCache から特定の Amazon SNS トピックに通知が送信されます。例には、ノードの追加の失敗、ノードの追加の成功、セキュリティグループの変更などが含まれます。主要イベントをモニタリングすることで、クラスターの現在の状態を知り、イベントに基づいて是正措置を取ることができます。 **Topics** + [ElastiCache Amazon SNS 通知の管理](ECEvents.SNS.md) + [ElastiCache イベントの表示](ECEvents.Viewing.md) + [イベント通知と Amazon SNS](ElastiCacheSNS.md) # ElastiCache Amazon SNS 通知の管理 Amazon Simple Notification Service (Amazon SNS) を使用して重要なクラスターイベントの通知が送信されるように ElastiCache を設定できます。これらの例では、Amazon SNS トピックの Amazon リソースネーム（ARN）を使用してクラスターを設定し、通知を受け取るようにします。 **注記** このトピックでは、Amazon SNS にサインアップし、Amazon SNS トピックをセットアップおよびサブスクライブしていることを前提としています。これを行う方法の詳細については、「[Amazon Simple Notification Service デベロッパーガイド](https://docs.aws.amazon.com/sns/latest/dg/)」を参照してください。 デフォルトでは、`API modify-replication-group` は、現在の指定されたグループだけでなく、リージョン内のすべてのグループに影響します。リージョン内の 1 つの特定のグループを他のグループとは異なる方法で設定する場合は、`--notification-topic-arn` オプションを使用して、そのグループの別のトピックを作成できます。 ## Amazon SNS トピックを追加する 以下のセクションでは、AWSコンソール、、AWS CLIまたは ElastiCache API を使用して Amazon SNS トピックを追加する方法を示します。 ### Amazon SNS トピックを追加する (コンソール) 以下の手順は、クラスターの Amazon SNS トピックを追加する方法を示しています。Valkey または Redis OSS を使用してステップ 2 でレプリケーショングループの Amazon SNS トピックを追加する場合、クラスターを選択する代わりに、レプリケーショングループを選択します。次に、以降の同じステップに従います。 **注記** このプロセスは、Amazon SNS トピックの変更に使用できます。 **クラスターの Amazon SNS トピックを追加または変更するには (コンソール)** 1. にサインインAWS マネジメントコンソールし、[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) で ElastiCache コンソールを開きます。 1. **クラスター** で、Amazon SNS トピック ARN を追加または変更するクラスターを選択します。 1. **変更**を選択します。 1. **クラスターを変更** の **SNS 通知のトピック** で、追加する SNS トピックを選択します。または、**手動 ARN 入力** を選択して Amazon SNS トピックの ARN を入力します。 1. **[Modify]** (変更) を選択します。 ### Amazon SNS トピックを追加する (AWS CLI) クラスターの Amazon SNS トピックを追加または変更するには、AWS CLIコマンド を使用します`modify-cache-cluster`。 次のコード例では、Amazon SNS トピック ARN を *my-cluster* に追加します。 Linux、macOS、Unix の場合: ``` aws elasticache modify-cache-cluster \ --cache-cluster-id my-cluster \ --notification-topic-arn arn:aws:sns:us-west-2:123456789xxx:ElastiCacheNotifications ``` Windows の場合: ``` aws elasticache modify-cache-cluster ^ --cache-cluster-id my-cluster ^ --notification-topic-arn arn:aws:sns:us-west-2:123456789xx:ElastiCacheNotifications ``` 詳細については、「[modify-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html)」を参照してください。 ### Amazon SNS トピックを追加する（ElastiCache API） クラスターの Amazon SNS トピックを追加または変更するには、以下のパラメータを指定して `ModifyCacheCluster` アクションを呼び出します。 + `CacheClusterId``=my-cluster` + `TopicArn``=arn%3Aaws%3Asns%3Aus-west-2%3A565419523791%3AElastiCacheNotifications` **Example** ``` 1. https://elasticache.amazon.com/ 2. ?Action=ModifyCacheCluster 3. &ApplyImmediately=false 4. &CacheClusterId=my-cluster 5. &NotificationTopicArn=arn%3Aaws%3Asns%3Aus-west-2%3A565419523791%3AElastiCacheNotifications 6. &Version=2014-12-01 7. &SignatureVersion=4 8. &SignatureMethod=HmacSHA256 9. &Timestamp=20141201T220302Z 10. &X-Amz-Algorithm=&AWS;4-HMAC-SHA256 11. &X-Amz-Date=20141201T220302Z 12. &X-Amz-SignedHeaders=Host 13. &X-Amz-Expires=20141201T220302Z 14. &X-Amz-Credential= 15. &X-Amz-Signature= ``` 詳細については、「[ModifyCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html)」を参照してください。 ## Amazon SNS 通知の有効化と無効化 クラスターでは、通知を有効または無効にすることができます。次の手順は、Amazon SNS 通知を無効にする方法を示しています。 ### Amazon SNS 通知の有効化と無効化（コンソール） **を使用して Amazon SNS 通知を無効にするにはAWS マネジメントコンソール** 1. にサインインAWS マネジメントコンソールし、[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) で ElastiCache コンソールを開きます。 1. Memcached を実行しているクラスターのリストを表示するには、左のナビゲーションペインで、[**Memcached**] を選択します。 Valkey または Redis OSS を実行しているクラスターのリストを表示するには、左のナビゲーションペインで、**[Valkey]** または **[Redis OSS]** を選択します。 1. 通知を変更するクラスターの左側にあるボックスを選択します。 1. **[Modify]** (変更) を選択します。 1. **クラスターを変更** の **SNS 通知のトピック** で、*通知を無効にする* を選択します。 1. **[Modify]** (変更) を選択します。 ### Amazon SNS 通知の有効化と無効化（AWS CLI) Amazon SNS 通知を無効にするには、以下のパラメータを指定して `modify-cache-cluster` コマンドを使用します。 Linux、macOS、Unix の場合: ``` aws elasticache modify-cache-cluster \ --cache-cluster-id my-cluster \ --notification-topic-status inactive ``` Windows の場合: ``` aws elasticache modify-cache-cluster ^ --cache-cluster-id my-cluster ^ --notification-topic-status inactive ``` **注記** クラスターがレプリケーショングループに属している場合、SNS 通知を有効化または無効化するには CLI コマンド `modify-replication-group` を使用する必要があります。 ### Amazon SNS 通知の有効化と無効化（ElastiCache API） Amazon SNS 通知を無効にするには、以下のパラメータを指定して `ModifyCacheCluster` アクションを呼び出します。 + `CacheClusterId``=my-cluster` + `NotificationTopicStatus``=inactive` この呼び出しにより、以下のような出力が返されます。 **Example** ``` 1. https://elasticache.us-west-2.amazonaws.com/ 2. ?Action=ModifyCacheCluster 3. &ApplyImmediately=false 4. &CacheClusterId=my-cluster 5. &NotificationTopicStatus=inactive 6. &Version=2014-12-01 7. &SignatureVersion=4 8. &SignatureMethod=HmacSHA256 9. &Timestamp=20141201T220302Z 10. &X-Amz-Algorithm=&AWS;4-HMAC-SHA256 11. &X-Amz-Date=20141201T220302Z 12. &X-Amz-SignedHeaders=Host 13. &X-Amz-Expires=20141201T220302Z 14. &X-Amz-Credential= 15. &X-Amz-Signature= ``` # ElastiCache イベントの表示 ElastiCache は、クラスターのインスタンス、セキュリティグループ、パラメータグループに関連するイベントを記録します。この情報には、イベントの日付と時刻、イベントのソース名とソースタイプ、イベントの説明などがあります。ElastiCache コンソール、 コマンド、AWS CLI`describe-events`または ElastiCache API アクション を使用して、ログからイベントを簡単に取得できます`DescribeEvents`。 次の手順は、過去 24 時間 (1440 分) のすべての ElastiCache イベントを表示する方法を示しています。 ## ElastiCache イベントの表示 (コンソール) 次の手順は、ElastiCache コンソールを使用してイベントを表示します。 **ElastiCache コンソールを使用してスタックイベントを表示するには** 1. にサインインAWS マネジメントコンソールし、[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 cache-cluster --max-items 40 ``` 次のコードでは、過去 24 時間 (1440 分) のすべてのイベントを一覧表示します。 ``` aws elasticache describe-events --source-type cache-cluster --duration 1440 ``` `describe-events` のコマンドによる出力は次のようになります。 ``` aws elasticache describe-events --source-type cache-cluster --max-items 40 { "Events": [ { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Finished modifying number of nodes from 1 to 3", "Date": "2020-06-09T02:01:21.772Z" }, { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Added cache node 0002 in availability zone us-west-2a", "Date": "2020-06-09T02:01:21.716Z" }, { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Added cache node 0003 in availability zone us-west-2a", "Date": "2020-06-09T02:01:21.706Z" }, { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Increasing number of requested nodes", "Date": "2020-06-09T01:58:34.178Z" }, { "SourceIdentifier": "mycluster-0003-004", "SourceType": "cache-cluster", "Message": "Added cache node 0001 in availability zone us-west-2c", "Date": "2020-06-09T01:51:14.120Z" }, { "SourceIdentifier": "mycluster-0003-004", "SourceType": "cache-cluster", "Message": "This cluster does not support persistence (ex: 'appendonly'). Please use a different instance type to enable persistence.", "Date": "2020-06-09T01:51:14.095Z" }, { "SourceIdentifier": "mycluster-0003-004", "SourceType": "cache-cluster", "Message": "Cache cluster created", "Date": "2020-06-09T01:51:14.094Z" }, { "SourceIdentifier": "mycluster-0001-005", "SourceType": "cache-cluster", "Message": "Added cache node 0001 in availability zone us-west-2b", "Date": "2020-06-09T01:42:55.603Z" }, { "SourceIdentifier": "mycluster-0001-005", "SourceType": "cache-cluster", "Message": "This cluster does not support persistence (ex: 'appendonly'). Please use a different instance type to enable persistence.", "Date": "2020-06-09T01:42:55.576Z" }, { "SourceIdentifier": "mycluster-0001-005", "SourceType": "cache-cluster", "Message": "Cache cluster created", "Date": "2020-06-09T01:42:55.574Z" }, { "SourceIdentifier": "mycluster-0001-004", "SourceType": "cache-cluster", "Message": "Added cache node 0001 in availability zone us-west-2b", "Date": "2020-06-09T01:28:40.798Z" }, { "SourceIdentifier": "mycluster-0001-004", "SourceType": "cache-cluster", "Message": "This cluster does not support persistence (ex: 'appendonly'). Please use a different instance type to enable persistence.", "Date": "2020-06-09T01:28:40.775Z" }, { "SourceIdentifier": "mycluster-0001-004", "SourceType": "cache-cluster", "Message": "Cache cluster created", "Date": "2020-06-09T01:28:40.773Z" } ] } ``` 使用できるパラメータおよび許可されたパラメータ値などの詳細については、「[https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html)」を参照してください。 ## ElastiCache イベントの表示 (ElastiCache API) ElastiCache イベントのリストを ElastiCache API を使用して生成するには、`DescribeEvents` アクションを使用します。オプションパラメータを使用して、一覧されるイベントのタイプ、イベントの期間、イベント一覧の最大数などを制御できます。 次のコードは、40 個の最新のキャッシュクラスターイベントを一覧します。 ``` https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeEvents &MaxRecords=40 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &SourceType=cache-cluster &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential= ``` 次のコードは、過去 24 時間 (1440 分) のキャッシュクラスターイベントを一覧します。 ``` https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeEvents &Duration=1440 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &SourceType=cache-cluster &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential= ``` 上記のアクションでは、次のような出力が生成されます。 ``` Cache cluster created cache-cluster 2015-02-02T18:22:18.202Z mem01 (...output omitted...) e21c81b4-b9cd-11e3-8a16-7978bb24ffdf ``` 使用できるパラメータおよび許可されたパラメータ値などの詳細については、「[https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html)」を参照してください。 # イベント通知と Amazon SNS ElastiCache では、クラスターで重要なイベントが発生したときに、Amazon Simple Notification Service (SNS) を使用してメッセージを発行できます。この機能を使用すると、キャッシュクラスターの個々のキャッシュノードエンドポイントに接続されたクライアントコンピュータでサーバーリストを更新できます。 **注記** 価格の情報やAmazon SNS ドキュメントへのリンクを含む、Amazon Simple Notification Service (SNS) の詳細については、「[Amazon SNS 製品ページ](https://aws.amazon.com/sns)」を参照してください。 通知は、指定した Amazon SNS *トピック* に発行されます。通知の要件は以下のとおりです: + ElastiCache 通知に対して設定できるトピックは 1 つだけです。 + Amazon SNS トピックを所有するAWSアカウントは、通知が有効になっているクラスターを所有するアカウントと同じである必要があります。 + 発行先の Amazon SNS トピックは暗号化できません。 **注記** 暗号化された (保存された) Amazon SNS トピックをクラスターにアタッチできます。ただし、ElastiCache コンソールからのトピックのステータスは非アクティブと表示され、ElastiCache がメッセージをトピックにプッシュしたときに、クラスターとトピックの関連付けが効果的に解除されます。 + Amazon SNS トピックは、ElastiCache クラスターと同じリージョンに存在している必要があります。 ## ElastiCache イベント 以下の ElastiCache イベントにより、Amazon SNS 通知がトリガーされます。イベントの詳細については、「[ElastiCache イベントの表示](ECEvents.Viewing.md)」を参照してください。 | イベント名 | メッセージ | 説明 | | --- | --- | --- | | ElastiCache:AddCacheNodeComplete | ElastiCache:AddCacheNodeComplete : cache-cluster | キャッシュノードがクラスターに追加され、使用可能になっています。 | | ElastiCache:AddCacheNodeFailed（使用できる IP アドレスが不足しているため） | ElastiCache:AddCacheNodeFailed : cluster-name | 使用できる IP アドレスが不足しているため、キャッシュノードを追加できませんでした。 | | ElastiCache:CacheClusterParametersChanged | ElastiCache:CacheClusterParametersChanged : cluster-name | 1 つ以上のクラスターパラメータが変更されました。 | | ElastiCache:CacheClusterProvisioningComplete | ElastiCache:CacheClusterProvisioningComplete cluster-name-0001-005 | クラスターのプロビジョニングが完了し、キャッシュクラスター内のキャッシュノードが使用可能になりました。 | | ElastiCache:CacheClusterProvisioningFailed（ネットワーク状態に互換性がないため） | ElastiCache:CacheClusterProvisioningFailed : cluster-name | 存在しない 仮想プライベートクラウド (VPC) に新しいキャッシュクラスターに起動する試みが行われました。 | | ElastiCache:CacheClusterScalingComplete | `CacheClusterScalingComplete : cluster-name` | キャッシュクラスターのスケーリングが正常に完了しました。 | | ElastiCache:CacheClusterScalingFailed | ElastiCache:CacheClusterScalingFailed : *cluster-name* | キャッシュクラスターのスケールアップが失敗しました。 | | ElastiCache:CacheClusterSecurityGroupModified | ElastiCache:CacheClusterSecurityGroupModified : cluster-name | 以下のいずれかのイベントが発生しました。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonElastiCache/latest/dg/ElastiCacheSNS.html) | | ElastiCache:CacheNodeReplaceStarted | ElastiCache:CacheNodeReplaceStarted : cluster-name | ElastiCache が、キャッシュノードを実行しているホストのパフォーマンスが低下しているか、到達できないことを検出したため、キャッシュノードの置き換えを開始しました。 置き換えられたキャッシュノードの DNS エントリは変更されません。 ほとんどのインスタンスでは、このイベントが発生したときにクライアントのサーバーリストを更新する必要はありません。ただし、一部のキャッシュクライアントライブラリは、ElastiCache がキャッシュノードを置き換えた後でもキャッシュノードの使用を停止する可能性があります。この場合、このイベントが発生したとき、アプリケーションがサーバーリストを更新する必要があります。 | | ElastiCache:CacheNodeReplaceComplete | ElastiCache:CacheNodeReplaceComplete : cluster-name | ElastiCache が、キャッシュノードを実行しているホストのパフォーマンスが低下しているか、到達できないことを検出したため、キャッシュノードの置き換えを完了しました。 置き換えられたキャッシュノードの DNS エントリは変更されません。 ほとんどのインスタンスでは、このイベントが発生したときにクライアントのサーバーリストを更新する必要はありません。ただし、一部のキャッシュクライアントライブラリは、ElastiCache がキャッシュノードを置き換えた後でもキャッシュノードの使用を停止する可能性があります。この場合、このイベントが発生したとき、アプリケーションがサーバーリストを更新する必要があります。 | | ElastiCache:CacheNodesRebooted | ElastiCache:CacheNodesRebooted : cluster-name | 1 つ以上のキャッシュノードが再起動されました。 メッセージ (Memcached) : `"Cache node %s shutdown"` 2 番目のメッセージ: `"Cache node %s restarted"` | | ElastiCache:CertificateRenewalComplete (Valkey または Redis OSS のみ） | ElastiCache:CertificateRenewalComplete | Amazon CA 証明書が正常に更新されました。 | | ElastiCache:CreateReplicationGroupComplete | ElastiCache:CreateReplicationGroupComplete : cluster-name | レプリケーショングループが正常に作成されました。 | | ElastiCache:DeleteCacheClusterComplete | ElastiCache:DeleteCacheClusterComplete : cluster-name | クラスターおよび関連するすべてのアプリケーションキャッシュノードの削除が完了しました。 | | ElastiCache:FailoverComplete (Valkey または Redis OSS のみ) | `ElastiCache:FailoverComplete : mycluster` | レプリカノードへのフェイルオーバーが成功しました。 | | ElastiCache:ReplicationGroupIncreaseReplicaCountFinished | ElastiCache:ReplicationGroupIncreaseReplicaCountFinished : cluster-name-0001-005 | クラスタ内のレプリカの数が増加しました。 | | ElastiCache:ReplicationGroupIncreaseReplicaCountStarted | ElastiCache:ReplicationGroupIncreaseReplicaCountStarted : cluster-name-0003-004 | クラスターにレプリカを追加するプロセスが開始されました。 | | ElastiCache:NodeReplacementCanceled | ElastiCache:NodeReplacementCanceled : cluster-name | 置き換え対象となっていたクラスター内のノードが置き換え対象ではなくなりました。 | | ElastiCache:NodeReplacementRescheduled | ElastiCache:NodeReplacementRescheduled : cluster-name | 以前置き換え対象になったクラスター内のノードのスケジュールが、通知に記載されている新しい期間に変更されました。 実行可能なアクションについては、「[ノードの置き換え (Valkey および Redis OSS)](CacheNodes.NodeReplacement.md)」を参照してください。 | | ElastiCache:NodeReplacementScheduled | ElastiCache:NodeReplacementScheduled : cluster-name | クラスター内のノードが、通知に記載されている期間中の置き換え対象となりました。 実行可能なアクションについては、「[ノードの置き換え (Valkey および Redis OSS)](CacheNodes.NodeReplacement.md)」を参照してください。 | | ElastiCache:RemoveCacheNodeComplete | ElastiCache:RemoveCacheNodeComplete : cluster-name | キャッシュノードがクラスターから削除されました。 | | ElastiCache:ReplicationGroupScalingComplete | `ElastiCache:ReplicationGroupScalingComplete : cluster-name` | レプリケーショングループのスケールアップオペレーションが正常に完了しました。 | | ElastiCache:ReplicationGroupScalingFailed | `"Failed applying modification to cache node type to %s."` | レプリケーショングループのスケールアップが失敗しました。 | | ElastiCache:ServiceUpdateAvailableForNode | `"Service update is available for cache node %s."` | セルフサービス更新は、ノードで使用できます。 | | ElastiCache:SnapshotComplete (Valkey または Redis OSS のみ) | ElastiCache:SnapshotComplete : cluster-name | キャッシュスナップショットの作成が正常に完了しました。 | | ElastiCache:SnapshotFailed (Valkey または Redis OSS のみ） | SnapshotFailed : cluster-name | キャッシュスナップショットの作成に失敗しました。詳細な原因については、クラスターのキャッシュイベントを参照してください。 スナップショットを表示する場合は、「[https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeSnapshots.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeSnapshots.html)」を参照してください。ステータスは `failed` です。 | ## 関連トピック + [ElastiCache イベントの表示](ECEvents.Viewing.md)