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

# PromQL を使用して Amazon CloudWatch メトリクスをクエリする
<a name="cloudwatch-promql"></a>

PromQL を使用して Amazon CloudWatch メトリクスをクエリするには、CloudWatch PromQL エンドポイントを指す Amazon Managed Service for Prometheus データソースを設定します。このアプローチでは、PromQL 構文を使用して、OpenTelemetry Protocol (OTLP) を介して CloudWatch に取り込まれるメトリクスをクエリできます。

AWS リソースエンリッチメントは`aws_account_id`、、`aws_region`、および リソースタグなどのラベルをメトリクスに自動的に追加します。これらのラベルは、PromQL クエリでフィルタリングと集計に使用できます。

CloudWatch PromQL データソースを設定する前に、次の要件を確認してください。
+ [CloudWatch 取り込みの OpenTelemetry メトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html)はCloudWatch アカウントで有効になっています。
+ Amazon Managed Grafana ワークスペースバージョン 12.4 以降。
+ Amazon Managed Service for Prometheus プラグインバージョン 3.0.0 以降。
+ `cloudwatch:GetMetricData` および の IAM アクセス許可`cloudwatch:ListMetrics`。

**CloudWatch PromQL データソースを設定するには**

1. Amazon Managed Grafana ワークスペースで、ナビゲーションペイン**の接続**を選択し、**データソース**を選択します。

1. **データソースの追加**を選択し、**Amazon Managed Service for Prometheus** を選択します。

1. **Prometheus サーバー URL** には、リージョンの CloudWatch PromQL エンドポイント を入力します`https://monitoring.{{region}}.amazonaws.com`。

1. **認証** で、認証方法として **SigV4** を選択します。

1. **SigV4 認証の詳細の「サービス**」に「」と入力します**monitoring**。 ****

1. **保存とテスト**を選択して接続を確認します。

データソースを保存したら、Explore および ダッシュボードで PromQL クエリを使用して、OTLP を介して取り込まれた CloudWatch メトリクスをクエリできます。

![Amazon Managed Grafana Explore ビューで、フィルターとして利用可能なエンリッチ AWS ラベルを持つコンテナ CPU 使用率の PromQL クエリを表示](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/grafana-cloudwatch-promql.png)


Amazon CloudWatch での OpenTelemetry メトリクスの取り込みと PromQL クエリの詳細については、 AWS クラウドオペレーションブログの[Amazon CloudWatch での OpenTelemetry と PromQL サポートの紹介](https://aws.amazon.com/blogs/mt/introducing-opentelemetry-promql-support-in-amazon-cloudwatch/)」を参照してください。