`AWSSupport-CalculateEBSPerformanceMetrics`

説明

AWSSupport-CalculateEBSPerformanceMetrics ランブックはEBS、パフォーマンスメトリクスを計算して CloudWatch ダッシュボードに公開することで、Amazon のパフォーマンス問題を診断するのに役立ちます。ダッシュボードには、ターゲット Amazon EBSボリューム、またはターゲット Amazon Elastic Compute Cloud (Amazon EC2) インスタンスにアタッチされたすべてのボリュームの推定平均IOPSとスループットが表示されます。Amazon EC2インスタンスの場合、インスタンスの平均IOPSとスループットも表示されます。ランブックは、関連する計算 CloudWatch メトリクスを表示する新しく作成された CloudWatch ダッシュボードへのリンクを出力します。 CloudWatch ダッシュボードは、という名前でアカウントに作成されますAWSSupport-<ResourceId>-EBS-Performance-<automation:EXECUTION_ID>。

動作の仕組み

ランブックは次のステップを実行します。

指定されたタイムスタンプが有効であることを確認します。
リソース ID (Amazon EBS ボリュームまたは Amazon EC2 インスタンス) が有効かどうかを検証します。
Amazon を ResourceID EC2として指定すると、その Amazon EC2インスタンスの実際の合計IOPS/スループットと、Amazon インスタンスにアタッチされたすべての Amazon EBSボリュームの推定平均IOPS/スループットグラフを含む CloudWatch ダッシュボードが作成されますEC2。 ResourceID
Amazon EBSボリュームを ResourceID として指定すると、そのボリュームの推定平均IOPS/スループットグラフを含む CloudWatch ダッシュボードが作成されます。
CloudWatch ダッシュボードが生成された後、推定平均スループットIOPSまたは推定平均スループットがそれぞれ最大スループットIOPSまたは最大スループットを超える場合、Amazon EC2インスタンスにアタッチされたボリュームに対してマイクロバーストが発生する可能性があります。

注記

バースト可能なボリューム (gp2、sc2、st1) の場合、バーストバランスが得られるまで最大 IOPS/スループットを考慮する必要があります。バーストバランスが完全に利用された後、つまりゼロになったら、ベースラインIOPS/スループットメトリクスを検討してください。

重要

CloudWatch ダッシュボードを作成すると、アカウントに追加料金が発生する可能性があります。詳細については、「Amazon CloudWatch 料金表」を参照してください。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

Amazon

[Platforms] (プラットフォーム)

Linux、macOS、Windows

パラメータ

必要なIAMアクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

ec2:DescribeVolumes
ec2:DescribeInstances
ec2:DescribeInstanceTypes
cloudwatch:PutDashboard

サンプルポリシー



        {
            "Version": "2012-10-17",
            "Statement": [
                {
                    "Sid": "VisualEditor0",
                    "Effect": "Allow",
                    "Action": "cloudwatch:PutDashboard",
                    "Resource": "arn:aws:cloudwatch::Account-id:dashboard/*-EBS-Performance-*"
                },
                {
                    "Sid": "VisualEditor1",
                    "Effect": "Allow",
                    "Action": [
                        "ec2:DescribeInstances",
                        "ec2:DescribeVolumes",
                        "ec2:DescribeInstanceTypes"
                    ],
                    "Resource": "*"
                }
            ]
        }

Instructions

次の手順に従って自動化を設定します。

Systems Manager AWSSupport-CalculateEBSPerformanceMetricsの「ドキュメント」でに移動します。
[Execute automation] (オートメーションを実行) を選択します。
入力パラメータには、次のように入力します。
- AutomationAssumeRole （オプション):
  
  Systems Manager Automation がユーザーに代わってアクションを実行できるようにする () ロールARNの Amazon リソースネーム AWS AWS Identity and Access Management （IAM）。ロールが指定されていない場合、Systems Manager Automation は、このランブックを開始するユーザーのアクセス許可を使用します。
- ResourceID (必須):
  
  Amazon EC2インスタンスまたは Amazon EBSボリュームの ID。
- 開始時刻 (必須):
  
  でデータを表示する開始時刻 CloudWatch。時刻は形式yyyy-mm-ddThh:mm:ssと形式である必要がありますUTC。
- 終了時刻 (必須):
  
  でデータを表示する終了時刻 CloudWatch。時刻は形式yyyy-mm-ddThh:mm:ssと形式である必要がありますUTC。
[実行] を選択します。
自動化が開始されます。
ドキュメントは以下のステップを実行します。
- CheckResourceIdAndTimeStamps:
  
  終了時刻が開始時刻より少なくとも 1 分長く、指定されたリソースが存在するかどうかを確認します。
- CreateCloudWatchDashboard:
  
  Amazon EBSのパフォーマンスを計算し、リソース ID に基づいてグラフを表示します。パラメータリソース ID に Amazon EBSボリューム ID を指定すると、このランブックは、Amazon EBSボリュームの推定平均スループットIOPSと推定平均スループットを含む CloudWatch ダッシュボードを作成します。パラメータリソース ID に Amazon EC2 インスタンス ID を指定すると、このランブックは、Amazon インスタンスの平均合計IOPSスループットと平均合計スループット、および Amazon EC2インスタンスにアタッチされたすべての Amazon EBSボリュームの推定平均スループットIOPSと推定平均スループットを含む CloudWatch ダッシュボードを作成しますEC2。
完了したら、出力セクションで実行の詳細な結果を確認します。

Amazon EC2インスタンスとしてのリソース ID の CloudWatch ダッシュボードの例

Amazon EBSボリューム ID としてのリソース ID の CloudWatch ダッシュボードの例

リファレンス

Systems Manager Automation

AWS サービスドキュメント

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

AWS-AttachEBSVolume

AWS-CopySnapshot