# CloudWatch Metrics Insights でのクエリの作成
<a name="cloudwatch-metrics-insights-buildquery"></a>

CloudWatch Metrics Insights のクエリは、CloudWatch コンソール、AWS CLI、または AWS SDK から実行します。コンソールで実行されるクエリは無料です。CloudWatch の料金の詳細については、「[Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing/)」をご覧ください。

CloudWatch Metrics Insights を使用すると、最大 2 週間の長期間にわたってメトリクスデータを分析できるため、より短い保持期間の場合と比較して、より包括的な履歴分析と傾向の特定が可能になります。より長い時間範囲をクエリするときに最適なパフォーマンスを得るには、より長い期間 (5 分や 1 時間など) を使用して、返されるデータポイントの数を減らすことを検討してください。2 週間全体の傾向を分析するときは、ORDER BY 句で AVG() や MAX() などの集計関数を使用してパターンを効率的に識別します。

AWS SDK による Metrics Insights クエリの実行に関する詳細は、「[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)」でご確認ください。

CloudWatch コンソールを使用してクエリを実行するには、以下の手順に従います。

**Metrics Insights を使用してメトリクスをクエリするには**

1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。

1. ナビゲーションペインで、[**Metrics**]、[**All metrics**] を選択します。

1. (オプション) 事前構築のサンプルクエリを実行するには、**[Add query]** (クエリを追加) をクリックした上で、実行するクエリを選択します。選択したクエリの機能に不足がない場合は、この手順の残りをスキップできます。または、**[Editor]** (エディタ) をクリックし、サンプルクエリの編集を行った上で、**[Run]** (実行) をクリックしてそのクエリを実行できます。

1. 独自のクエリを作成するには、**[マルチソースクエリ]** を選択します。その後、**[ビルダー]** ビュー (デフォルト) を使用してガイド付きエクスペリエンスを得ることも、**[エディタ]** ビューを使用してクエリ構文を表示することもできます。この 2 つのビューはいつでも切り替えが可能で、どちらからも進行中の作業を確認できます。

   **[ビルダー]** ビューで、名前空間、メトリクス名、フィルター、グループ、順序、制限の各フィールドをクリックして、可能な値を参照して選択します。ビルダーによって表示されるリストをフィルタリングするために、探している値の任意の部分の入力を開始できます。フィルターおよびグループ入力でリソースタグを参照できます。

   **[エディタ]** ビューでは、Metrics Insights でサポートされている SQL のサブセットを使用してクエリを記述できます。エディタには、メトリクスがサポートするリソースタグの名前など、これまでに入力した文字に基づく自動補完オプションが用意されています。

   CloudWatch Metrics Insights は、AWS リソースタグによるメトリクスのクエリをサポートしています。タグを使用してメトリクスデータをフィルタリングおよびグループ化し、より的を絞ったモニタリングと分析を行うことができます。

   以下の例は、タグ付きのクエリを使用する方法を示しています。

   本番環境内の Amazon EC2 インスタンスの CPU 使用率を確認するには:

   ```
   SELECT MAX(CPUUtilization) FROM SCHEMA("AWS/EC2") WHERE tag.env='prod'
   ```

   GROUP BY 句を使用して環境ごとにメトリクスをグループ化するには:

   ```
   SELECT MAX(CPUUtilization) FROM SCHEMA("AWS/EC2") GROUP BY tag.env
   ```

   タグ名を指定して GROUP BY 句を使用するには:

   ```
   SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY tag."aws:cloudformation:stack-name"
   ```

   タグクエリを既存のメトリクスディメンションと組み合わせるには:

   ```
   SELECT MAX(CPUUtilization) FROM SCHEMA("AWS/EC2") WHERE tag.env='prod' AND InstanceId='i-1234567890abcdef0'
   ```

1. クエリの内容に問題がなければ、**[Run]** (実行) をクリックします。

1. (オプション) グラフ表示したクエリを編集するには、**[Graphed metrics]** (グラフ化したメトリクス) タブを開き、**[Details]** (詳細) 列でクエリ式の横にある編集アイコンクリックするという方法もあります。

1. (オプション) グラフからクエリを削除する場合は、**[Graphed metrics]** (グラフ化したメトリクス) をクリックし、クエリが表示されている行の右側にある **[X]** アイコンをクリックします。