本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 PromQL 查詢 Amazon CloudWatch 指標
<a name="cloudwatch-promql"></a>

您可以透過設定指向 Amazon CloudWatch PromQL 端點的 Amazon Managed Service for Prometheus 資料來源，使用 PromQL 查詢 Amazon CloudWatch 指標。此方法可讓您使用 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. 選擇**儲存並測試**以驗證連線。

儲存資料來源之後，您可以在探索和儀表板中使用 PromQL 查詢來查詢透過 OTLP 擷取的 CloudWatch 指標。

![Amazon Managed Grafana Explore 檢視顯示容器 CPU 使用率的 PromQL 查詢，其中包含可作為篩選條件使用的豐富 AWS 標籤](http://docs.aws.amazon.com/zh_tw/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/)。