翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CloudWatch を使用して、Data Lifecycle Manager のポリシーをモニタリング
Amazon Data Lifecycle Manager のライフサイクルポリシーは、CloudWatch を使ってモニタリングすることができます。CloudWatch は、raw データを収集し、読み取り可能なほぼリアルタイムのメトリクスに加工することができます。これらのメトリクスを使用して、ポリシーによって作成、削除、コピーされた Amazon EBS スナップショットと EBS Backed AMI の数を正確に把握できます。また、特定のしきい値を監視するアラームを設定し、これらのしきい値に達したときに通知を送信したりアクションを実行したりできます。
メトリクスは 15 か月間保持されるため、履歴情報にアクセスして長期間にわたるライフサイクルポリシーのパフォーマンスをより的確に把握できます。
Amazon CloudWatch の詳細については、[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)を参照してください。
**Topics**
+ [
## サポートされるメトリクス
](#metrics)
+ [
## ポリシーの CloudWatch メトリクスを表示する
](#view-metrics)
+ [グラフメトリクス](#graph-metrics)
+ [
## ポリシーの CloudWatch アラームを作成する
](#create-alarm)
+ [
## ユースケースの例
](#use-cases)
+ [
## 失敗したアクションを報告するポリシーの管理
](#manage)
## サポートされるメトリクス
`AWS/EBS` 名前空間には、Amazon Data Lifecycle Manager の以下のメトリクスが含まれます。メトリクスは、ポリシータイプによって異なります。
すべてのメトリクスは、`DLMPolicyId` ディメンションで測定できます。最も有用な統計データは `sum` と `average`、そして測定単位は `count` です。
タブを選択すると、そのポリシータイプでサポートされているメトリクスが表示されます。
------
#### [ EBS snapshot policies ]
| メトリクス | 説明 |
| --- | --- |
| `ResourcesTargeted` | スナップショットまたは EBS-backed AMI ポリシーで指定されたタグがターゲットとするリソースの数。 |
| `SnapshotsCreateStarted` | スナップショットポリシーによって開始されたスナップショット作成アクションの数。後続の再試行が複数ある場合でも、各アクションは 1 回だけ記録されます。 スナップショット作成アクションが失敗すると、Amazon Data Lifecycle Manager は `SnapshotsCreateFailed` メトリクスを送信します。 |
| `SnapshotsCreateCompleted` | スナップショットポリシーにより作成されたスナップショットの数。これには、スケジュールされた時刻から 60 分以内に成功した再試行が含まれます。 |
| `SnapshotsCreateFailed` | スナップショットポリシーにより作成できなかったスナップショットの数。これには、スケジュールされた時刻から 60 分以内に失敗した再試行が含まれます。 |
| `SnapshotsSharedCompleted` | スナップショットポリシーによってアカウント間で共有されたスナップショットの数。 |
| `SnapshotsDeleteCompleted` | スナップショットポリシーまたは EBS-backed AMI ポリシーにより削除されたスナップショットの数。このメトリクスは、ポリシーによって作成されたスナップショットにのみ適用されます。このポリシーは、ポリシーによって作成されたクロスリージョンスナップショットコピーには適用されません。 このメトリクスには、EBS-backed AMI ポリシーが AMI の登録を解除したときに削除されるスナップショットが含まれます。 |
| `SnapshotsDeleteFailed` | スナップショットポリシーまたは EBS-backed AMI ポリシーにより削除できなかったスナップショットの数。このメトリクスは、ポリシーによって作成されたスナップショットにのみ適用されます。このポリシーは、ポリシーによって作成されたクロスリージョンスナップショットコピーには適用されません。 このメトリクスには、EBS-backed AMI ポリシーが AMI の登録を解除したときに削除されるスナップショットが含まれます。 |
| `SnapshotsCopiedRegionStarted` | スナップショットポリシーによって開始されたクロスリージョンスナップショットコピーアクションの数。 |
| `SnapshotsCopiedRegionCompleted` | スナップショットポリシーによって作成されたクロスリージョンスナップショットコピーの数。これには、スケジュールされた時刻から 24 時間以内に成功した再試行が含まれます。 |
| `SnapshotsCopiedRegionFailed` | スナップショットポリシーにより作成できなかったクロスリージョンスナップショットコピーの数。これには、スケジュールされた時刻から 24 時間以内に失敗した再試行が含まれます。 |
| `SnapshotsCopiedRegionDeleteCompleted` | スナップショットポリシーによって削除された、保持ルールで指定されたクロスリージョンスナップショットコピーの数。 |
| `SnapshotsCopiedRegionDeleteFailed` | スナップショットポリシーにより、保持ルールで指定された削除できなかったクロスリージョンのスナップショットコピーの数。 |
| `snapshotsArchiveDeletionFailed` | スナップショットポリシーによりアーカイブ層から削除できなかったアーカイブ済みスナップショットの数。 |
| `snapshotsArchiveScheduled` | スナップショットポリシーによりアーカイブが予定されているスナップショットの数。 |
| `snapshotsArchiveCompleted` | スナップショットポリシーによりアーカイブが正常に行われたスナップショットの数。 |
| `snapshotsArchiveFailed` | スナップショットポリシーによりアーカイブできなかったスナップショットの数。 |
| `snapshotsArchiveDeletionCompleted` | スナップショットポリシーによりアーカイブ層から正常に削除できたアーカイブ済みスナップショットの数。 |
| `PreScriptStarted` | 事前スクリプトが正常に開始されたインスタンスの数。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| `PreScriptCompleted` | 事前スクリプトが正常に完了したインスタンスの数。事前スクリプトが指定したタイムアウト期間外に完了した場合でも、メトリクスは出力されます。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| `PreScriptFailed` | 事前スクリプトが正常に完了しなかったインスタンスの数。事前スクリプトが指定したタイムアウト期間外に完了した場合でも、メトリクスは出力されます。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| `PostScriptStarted` | ポストスクリプトが正常に開始されたインスタンスの数。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| PostScriptCompleted | ポストスクリプトが正常に完了したインスタンスの数。事後スクリプトが指定したタイムアウト期間外に完了した場合でも、メトリクスは出力されます。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| PostScriptFailed | 事後スクリプトが正常に完了しなかったインスタンスの数。事後スクリプトが指定したタイムアウト期間外に完了した場合でも、メトリクスは出力されます。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| `VSSBackupStarted` | VSS バックアップが正常に開始されたインスタンスの数。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| `VSSBackupCompleted` | VSS バックアップが正常に完了したインスタンスの数。VSS バックアップがタイムアウト期間外に完了した場合でも、メトリクスは出力されます。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
| `VSSBackupFailed` | VSS バックアップが正常に完了しなかったインスタンスの数。VSS バックアップがタイムアウト期間外に完了した場合でも、メトリクスは出力されます。 スクリプトの再試行が有効になっている場合、このメトリクスはポリシー実行ごとに複数回出力される可能性があります。 |
------
#### [ EBS-backed AMI policies ]
EBS-backed AMI ポリシーでは、次のメトリクスを使用できます。
| メトリクス | 説明 |
| --- | --- |
| `ResourcesTargeted` | スナップショットまたは EBS-backed AMI ポリシーで指定されたタグがターゲットとするリソースの数。 |
| `SnapshotsDeleteCompleted` | スナップショットポリシーまたは EBS-backed AMI ポリシーにより削除されたスナップショットの数。このメトリクスは、ポリシーによって作成されたスナップショットにのみ適用されます。このポリシーは、ポリシーによって作成されたクロスリージョンスナップショットコピーには適用されません。 このメトリクスには、EBS-backed AMI ポリシーが AMI の登録を解除したときに削除されるスナップショットが含まれます。 |
| `SnapshotsDeleteFailed` | スナップショットポリシーまたは EBS-backed AMI ポリシーにより削除できなかったスナップショットの数。このメトリクスは、ポリシーによって作成されたスナップショットにのみ適用されます。このポリシーは、ポリシーによって作成されたクロスリージョンスナップショットコピーには適用されません。 このメトリクスには、EBS-backed AMI ポリシーが AMI の登録を解除したときに削除されるスナップショットが含まれます。 |
| `SnapshotsCopiedRegionDeleteCompleted` | スナップショットポリシーによって削除された、保持ルールで指定されたクロスリージョンスナップショットコピーの数。 |
| `SnapshotsCopiedRegionDeleteFailed` | スナップショットポリシーにより、保持ルールで指定された削除できなかったクロスリージョンのスナップショットコピーの数。 |
| `ImagesCreateStarted` | EBS-backed AMI ポリシーによって開始された **CreateImage** アクションの数。 |
| `ImagesCreateCompleted` | EBS-backed AMI ポリシーによって作成された AMI の数。 |
| `ImagesCreateFailed` | EBS-backed AMI ポリシーによって作成できなかった AMI の数。 |
| `ImagesDeregisterCompleted` | EBS-backed AMI ポリシーによって登録解除された AMI の数。 |
| `ImagesDeregisterFailed` | EBS-backed AMI ポリシーによって登録解除できなかった AMI の数。 |
| `ImagesCopiedRegionStarted` | EBS-backed AMI ポリシーによって開始されたクロスリージョンコピーアクションの数。 |
| `ImagesCopiedRegionCompleted` | EBS-Backed AMI ポリシーによって作成されたクロスリージョン AMI コピーの数。 |
| `ImagesCopiedRegionFailed` | EBS-backed AMI ポリシーによって作成できなかったクロスリージョン AMI コピーの数。 |
| `ImagesCopiedRegionDeregisterCompleted` | EBS-backed AMI ポリシーによって保持ルールで指定された、登録解除されたクロスリージョン AMI コピーの数。 |
| `ImagesCopiedRegionDeregisteredFailed` | EBS-backed AMI ポリシーによって登録解除できなかった、保持ルールで指定されたクロスリージョン AMI コピーの数。 |
| `EnableImageDeprecationCompleted` | EBS-backed AMI ポリシーによって非推奨としてマークされた AMI の数。 |
| `EnableImageDeprecationFailed` | EBS-backed AMI ポリシーによって非推奨としてマークされなかった AMI の数。 |
| `EnableCopiedImageDeprecationCompleted` | EBS-Backed AMI ポリシーによって非推奨としてマークされたクロスリージョン AMI コピーの数。 |
| `EnableCopiedImageDeprecationFailed` | グリッドでポリシーを選択し、Monitoringタブを選びます。EBSでサポートされているAMIポリシーによって非推奨としてマークされなかったクロスリージョンAMIコピーの数。 |
------
#### [ Cross-account copy event policies ]
クロスアカウントコピーイベントポリシーでは、以下のメトリクスを使用できます。
| メトリクス | 説明 |
| --- | --- |
| `SnapshotsCopiedAccountStarted` | クロスアカウントコピーイベントポリシーによって開始された、クロスアカウントスナップショットコピーアクションの数。 |
| `SnapshotsCopiedAccountCompleted` | クロスアカウントコピーイベントポリシーによって別のアカウントからコピーされたスナップショットの数。これには、スケジュールされた時刻から 24 時間以内に成功した再試行が含まれます。 |
| `SnapshotsCopiedAccountFailed` | クロスアカウントコピーイベントポリシーによって別のアカウントからコピーできなかったスナップショットの数。これには、スケジュールされた時刻から 24 時間以内に失敗した再試行が含まれます。 |
| `SnapshotsCopiedAccountDeleteCompleted` | クロスアカウントのコピーイベントポリシーによって、保持ルールで指定された削除されたクロスレジオンスナップショットコピーの数。 |
| `SnapshotsCopiedAccountDeleteFailed` | クロスアカウントのコピーイベントポリシーによって、保持ルールで指定された削除できなかったクロスレジオンスナップショットコピーの数。 |
------
## ポリシーの CloudWatch メトリクスを表示する
AWS マネジメントコンソール または コマンドラインツールを使用して、Amazon Data Lifecycle Manager が Amazon CloudWatch に送信するメトリクスを一覧表示できます。
------
#### [ Amazon EC2 console ]
**Amazon EC2 コンソールを使用してメトリクスを表示するには**
1. Amazon EC2 コンソールの [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) を開いてください。
1. ナビゲーションペインで**Lifecycle Manager**を選択します。
1. グリッドでポリシーを選択し、**モニタリング**タブを選びます。
------
#### [ CloudWatch console ]
**Amazon CloudWatch コンソールを使用してメトリクスを表示するには**
1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。
1. ナビゲーションペインで [**メトリクス**] を選択します。
1. [**EBS**] 名前空間を選択し、[**Data Lifecycle Manager metrics**] (Data Lifecycle Manager メトリクス) を選択します。
------
#### [ AWS CLI ]
**Amazon Data Lifecycle Manager で利用可能なメトリクスをすべて表示するには**
[list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) コマンドを使用します。
```
$ C:\> aws cloudwatch list-metrics \
--namespace AWS/EBS
```
**特定のポリシーのすべてのメトリクスを表示するには**
[list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) コマンドを使用して、`DLMPolicyId` ディメンションを指定します。
```
$ C:\> aws cloudwatch list-metrics \
--namespace AWS/EBS \
--dimensions Name=DLMPolicyId,Value=policy-abcdef01234567890
```
**すべてのポリシーにわたって単一のメトリクスを表示するには**
[list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) コマンドを使用して、`--metric-name` オプションを指定します。
```
$ C:\> aws cloudwatch list-metrics \
--namespace AWS/EBS \
--metric-name SnapshotsCreateCompleted
```
------
## ポリシーのグラフメトリクス
ポリシーの作成が完了したら、Amazon EC2 コンソールを開いて、**Monitoring** タブにポリシーのモニタリンググラフを表示できます。各グラフは利用可能な Amazon EC2 メトリクスのいずれかに基づいています。
以下のグラフが利用可能です：
+ ターゲットとなるリソース (`ResourcesTargeted`に基づく)
+ スナップショットの作成が開始されました (`SnapshotsCreateStarted`)
+ スナップショットの作成が完了しました (`SnapshotsCreateCompleted`に基づく)
+ スナップショットの作成に失敗しました (`SnapshotsCreateFailed`に基づく)
+ スナップショットの共有が完了しました (`SnapshotsSharedCompleted`に基づく)
+ スナップショットの削除が完了しました (`SnapshotsDeleteCompleted`に基づく)
+ スナップショットの削除に失敗しました (`SnapshotsDeleteFailed`に基づく)
+ スナップショットのクロスリージョンコピーが開始されました (`SnapshotsCopiedRegionStarted`に基づく)
+ スナップショットのクロスリージョンコピーが完了しました (`SnapshotsCopiedRegionCompleted`に基づく)
+ スナップショットのクロスリージョンコピーに失敗しました (`SnapshotsCopiedRegionFailed`に基づく)
+ スナップショットのクロスリージョンコピーの削除が完了しました (`SnapshotsCopiedRegionDeleteCompleted`に基づく)
+ スナップショットのクロスリージョンコピーの削除に失敗しました (`SnapshotsCopiedRegionDeleteFailed`に基づく)
+ スナップショットのクロスアカウントコピーが開始されました (`SnapshotsCopiedAccountStarted`に基づく)
+ スナップショットのクロスアカウントコピーが完了しました (`SnapshotsCopiedAccountCompleted`に基づく)
+ スナップショットのクロスアカウントコピーに失敗しました (`SnapshotsCopiedAccountFailed`に基づく)
+ スナップショットのクロスアカウントコピーの削除が完了しました (`SnapshotsCopiedAccountDeleteCompleted`に基づく)
+ スナップショットのクロスアカウントコピーの削除に失敗しました (`SnapshotsCopiedAccountDeleteFailed`に基づく)
+ AMI の作成が開始されました (`ImagesCreateStarted`に基づく)
+ AMI の作成が完了しました (`ImagesCreateCompleted`に基づく)
+ AMI の作成に失敗しました (`ImagesCreateFailed`に基づく)
+ AMI の登録解除が完了しました (`ImagesDeregisterCompleted`に基づく)
+ AMI の登録解除に失敗しました (`ImagesDeregisterFailed`に基づく)
+ AMI のクロスリージョンコピーを開始 (`ImagesCopiedRegionStarted`に基づく)
+ AMI のクロスリージョンコピーが完了しました (`ImagesCopiedRegionCompleted`に基づく)
+ AMI のクロスリージョンコピーに失敗しました (`ImagesCopiedRegionFailed`に基づく)
+ AMI のクロスリージョンコピーの登録解除が完了しました (`ImagesCopiedRegionDeregisterCompleted`に基づく)
+ AMI のクロスリージョンコピーの登録解除に失敗しました (`ImagesCopiedRegionDeregisteredFailed`に基づく)
+ AMI の有効化の廃止が完了しました (`EnableImageDeprecationCompleted`に基づく)
+ AMI の有効化の廃止に失敗しました (`EnableImageDeprecationFailed`に基づく)
+ AMI クロスリージョンコピーの有効化の廃止が完了しました (`EnableCopiedImageDeprecationCompleted`に基づく)
+ AMI クロスリージョンコピーの有効化の廃止に失敗しました (`EnableCopiedImageDeprecationFailed`に基づく)
## ポリシーの CloudWatch アラームを作成する
ポリシーの CloudWatch メトリクスをモニタリングする CloudWatch アラームを作成できます。CloudWatch は、指定したしきい値にメトリクスが到達すると、自動的に通知を送信します。CloudWatch アラームを作成するには、CloudWatch コンソールを使用します。
CloudWatch コンソールを使用してアラームを作成する方法について詳細は、*Amazon CloudWatch ユーザーガイド*の次のトピックを参照してください。
+ [静的しきい値に基づいて CloudWatch アラームを作成する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)
+ [異常検出に基づいて CloudWatch アラームを作成する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html)
## ユースケースの例
ユースケースの例を次に示します。
**Topics**
+ [
### 例 1: ResourcesTargeted メトリクス
](#case1)
+ [
### 例 2: SnapshotDeleteFailed メトリクス
](#case2)
+ [
### 例 3: SnapshotsCopiedRegionFailed メトリクス
](#case3)
### 例 1: ResourcesTargeted メトリクス
`ResourcesTargeted` メトリクスを使って、特定のポリシーが実行されるたびに対象となるリソースの総数をモニタリングすることができます。これにより、ターゲットリソースの数が予想されるしきい値を下回ったり上回ったりしたときにアラームをトリガーできます。
例えば、日時ポリシーで `50` 個以下のボリュームのバックアップを作成することを想定している場合、`1` 時間の間に `ResourcesTargeted` の `sum` が `50` より大きくなったときにメールで通知するアラームを作成することができます。これにより、誤ってタグ付けされたボリュームからスナップショットが予期せず作成されないようにすることができます。
以下のコマンドを使用して、このアラームを作成できます。
```
$ C:\> aws cloudwatch put-metric-alarm \
--alarm-name resource-targeted-monitor \
--alarm-description "Alarm when policy targets more than 50 resources" \
--metric-name ResourcesTargeted \
--namespace AWS/EBS \
--statistic Sum \
--period 3600 \
--threshold 50 \
--comparison-operator GreaterThanThreshold \
--dimensions "Name=DLMPolicyId,Value=policy_id" \
--evaluation-periods 1 \
--alarm-actions sns_topic_arn
```
### 例 2: SnapshotDeleteFailed メトリクス
この `SnapshotDeleteFailed` メトリクスを使用して、ポリシーのスナップショット保持ルールに従ってスナップショットを削除する際の失敗をモニタリングできます。
例えば、12 時間ごとにスナップショットを自動的に削除するポリシーを作成した場合、`1` 時間の間に `SnapshotDeletionFailed` の `sum` が `0` より大きくなったときにエンジニアリングチームに通知するアラームを作成することができます。これにより、不適切なスナップショットの保持を調査し、不要なスナップショットによってストレージコストが増加しないようにすることができます。
以下のコマンドを使用して、このアラームを作成できます。
```
$ C:\> aws cloudwatch put-metric-alarm \
--alarm-name snapshot-deletion-failed-monitor \
--alarm-description "Alarm when snapshot deletions fail" \
--metric-name SnapshotsDeleteFailed \
--namespace AWS/EBS \
--statistic Sum \
--period 3600 \
--threshold 0 \
--comparison-operator GreaterThanThreshold \
--dimensions "Name=DLMPolicyId,Value=policy_id" \
--evaluation-periods 1 \
--alarm-actions sns_topic_arn
```
### 例 3: SnapshotsCopiedRegionFailed メトリクス
`SnapshotsCopiedRegionFailed` メトリクスを使用して、ポリシーが他のリージョンへのスナップショットのコピーに失敗した場合を特定します。
例えば、ポリシーによりリージョン間でスナップショットを毎日コピーしている場合、`1` 時間の間に `SnapshotCrossRegionCopyFailed` の `sum` が `0` より大きくなったときにエンジニアリングチームに SMS を送信するアラームを作成することができます。これは、系統内の後続のスナップショットがポリシーによって正常にコピーされたかどうかを検証する場合に便利です。
以下のコマンドを使用して、このアラームを作成できます。
```
$ C:\> aws cloudwatch put-metric-alarm \
--alarm-name snapshot-copy-region-failed-monitor \
--alarm-description "Alarm when snapshot copy fails" \
--metric-name SnapshotsCopiedRegionFailed \
--namespace AWS/EBS \
--statistic Sum \
--period 3600 \
--threshold 0 \
--comparison-operator GreaterThanThreshold \
--dimensions "Name=DLMPolicyId,Value=policy_id" \
--evaluation-periods 1 \
--alarm-actions sns_topic_arn
```
## 失敗したアクションを報告するポリシーの管理
ポリシーの 1 つが、失敗したアクションメトリクスについて予期しないゼロ以外の値を報告した場合の対処方法の詳細については、「[What do I do if Amazon Data Lifecycle Manager reports failed actions in Amazon CloudWatch metrics?](https://repost.aws/knowledge-center/cloudwatch-metrics-dlm)」の記事を参照してください。