翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `AWSSupport-CalculateEBSPerformanceMetrics`
<a name="automation-calculate-ebs-performance-metrics"></a>

 **説明** 

 `AWSSupport-CalculateEBSPerformanceMetrics` ランブックは、パフォーマンスメトリクスを計算して CloudWatch ダッシュボードに発行することで、Amazon EBS のパフォーマンスの問題の診断に役立ちます。ダッシュボードには、ターゲット 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 EC2 を ResourceID として指定すると、その Amazon EC2 インスタンスの実際の合計 IOPS/スループットと、Amazon EC2 インスタンスにアタッチされたすべての Amazon EBS ボリュームの推定平均 IOPS/スループットグラフを含む CloudWatch ダッシュボードが作成されますAmazon EC2。
+ Amazon EBS ボリュームを ResourceID として指定すると、そのボリュームの推定平均 IOPS/スループットグラフを含む CloudWatch ダッシュボードが作成されます。
+ CloudWatch ダッシュボードが生成された後、推定平均 IOPS または推定平均スループットがそれぞれ最大 IOPS または最大スループットを超える場合、Amazon EC2 インスタンスにアタッチされたボリュームに対してマイクロバーストが可能です。

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

**重要**  
 CloudWatch ダッシュボードを作成すると、アカウントに追加料金が発生する可能性があります。詳細については、[Amazon CloudWatch 料金ガイド](https://aws.amazon.com/cloudwatch/pricing)を参照してください。

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CalculateEBSPerformanceMetrics) 

**ドキュメントタイプ**

オートメーション

**[所有者]**

Amazon

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

Linux、macOS、Windows

**パラメータ**

**必要な IAM アクセス許可**

`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+ `ec2:DescribeVolumes`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceTypes`
+ `cloudwatch:PutDashboard`

サンプルポリシー

------
#### [ JSON ]

****  

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

------

 **指示** 

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

1. ドキュメントの Systems Manager [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description)で に移動します。

1. [Execute automation] (オートメーションを実行) を選択します。

1. 入力パラメータには、次のように入力します。
   + **AutomationAssumeRole（オプション):**

     Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールが指定されていない場合、Systems Manager Automation は、このランブックを開始するユーザーのアクセス許可を使用します。
   + **ResourceID (必須):**

     Amazon EC2 インスタンスまたは Amazon EBS ボリュームの ID。
   + **開始時刻 (必須):**

     CloudWatch でデータを表示する開始時刻。時刻は 形式`yyyy-mm-ddThh:mm:ss`と UTC 形式である必要があります。
   + **終了時刻 (必須):**

     CloudWatch でデータを表示する終了時刻。時刻は 形式`yyyy-mm-ddThh:mm:ss`と UTC 形式である必要があります。  
![\[Input parameters form for AWS Systems Manager Automation with fields for role, resource ID, and time range.\]](http://docs.aws.amazon.com/ja_jp/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_input_parameters.png)

1. [実行] を選択します。

1. 自動化が開始されます。

1. ドキュメントは以下のステップを実行します。
   + **CheckResourceIdAndTimeStamps:**

     終了時刻が開始時刻より少なくとも 1 分長く、指定されたリソースが存在するかどうかを確認します。
   + **CreateCloudWatchDashboard:**

     Amazon EBS のパフォーマンスを計算し、リソース ID に基づいてグラフを表示します。パラメータリソース ID に Amazon EBS ボリューム ID を指定すると、このランブックは Amazon EBS ボリュームの推定平均 IOPS と推定平均スループットを含む CloudWatch ダッシュボードを作成します。パラメータリソース ID に Amazon EC2 インスタンス ID を指定すると、このランブックはAmazon EC2 インスタンスにアタッチされたすべての Amazon EBS ボリュームの推定平均 IOPS と推定平均スループットを含む CloudWatch ダッシュボードを作成します。

1. 完了したら、出力セクションで実行の詳細な結果を確認します。  
![\[CloudWatch dashboard creation output showing a URL link and a message with instructions.\]](http://docs.aws.amazon.com/ja_jp/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_outputs.png)

   Amazon EC2 インスタンスとしてのリソース ID の CloudWatch ダッシュボードの例  
![\[CloudWatch dashboard showing EC2 instance metrics with graphs for IOPS, throughput, and volume performance.\]](http://docs.aws.amazon.com/ja_jp/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ec2_instance.png)

   Amazon EBS ボリューム ID としてのリソース ID の CloudWatch ダッシュボードの例  
![\[CloudWatch dashboard showing EBS volume performance metrics with IOPS and throughput graphs.\]](http://docs.aws.amazon.com/ja_jp/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ebs_volume.png)

 **リファレンス** 

Systems Manager Automation
+ [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description)
+ [オートメーションを実行する](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [オートメーションの設定](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [「自動化ワークフローをサポート」ランディングページ](https://aws.amazon.com/premiumsupport/technology/saw/)

AWS サービスドキュメント
+ [Amazon EBS ボリュームがマイクロバーストしているかどうかを特定し、これを防ぐにはどうすればよいですか?](https://repost.aws/knowledge-center/ebs-identify-micro-bursting)
+ [CloudWatch を使用して EC2 インスタンスの Amazon EBS パフォーマンスメトリクスの集計を表示するにはどうすればよいですか?](https://repost.aws/knowledge-center/ebs-aggregate-cloudwatch-performance)