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

PromQL 查詢

當您透過 OpenTelemetry Protocol (OTLP) 將 OpenTelemetry 指標擷取至 CloudWatch 時，階層式 OTLP 資料模型會扁平化為與 PromQL 相容的標籤。本節說明標籤結構、用於查詢這些標籤的 PromQL 語法，以及 PromQL 中的 UTF-8 支援。

在 CloudWatch 中使用 PromQL 時，@字首慣例會將 OTLP 範圍標籤與標準 Prometheus 標籤區分開來。每個範圍內的欄位都使用雙@字首 （例如 @resource.@schema_url)，而屬性則使用單一@範圍字首，例如 @resource.service.name。Datapoint 屬性也支援裸機 （無字首） 存取，以便與標準 PromQL 查詢回溯相容，例如 {"http.server.active_requests"}和 {"@datapoint.@name"="http.server.active_requests"} 相等。

PromQL 表達式是以大括號括住，指定指標名稱和一組選用的標籤比對器。下列範例會選取http.server.active_requests指標的所有時間序列：

{"http.server.active_requests"}

下列範例會選取 http.server.active_requests OpenTelemetry 資源屬性service.name等於 之指標的所有時間序列myservice：

{"http.server.active_requests", "@resource.service.name"="myservice"}

您可以在單一查詢中結合多個標籤比對器。下列範例會選取http.server.active_requests指標的所有時間序列，其中 OpenTelemetry 資源屬性service.name在所有美國區域myservice相等：

{"http.server.active_requests",
 "@resource.service.name"="myservice",
 "@aws.region"=~"us-.*"}

下列範例顯示範圍查詢。它會計算每個時間序列指定時間範圍內所有資料點的平均值：

avg_over_time(
  {"http.server.active_requests",
   "@resource.service.name"="myservice"}[5m]
)

下表摘要說明每個 OTLP 範圍的字首慣例：

使用 PromQL 查詢已結束的 AWS 指標

若要能夠在 PromQL 中查詢已售出 AWS 指標，您必須先啟用已售出指標的 OTel 擴充。請參閱：在 PromQL 中啟用付費指標。

啟用 OTel 擴充後，已佈建的 AWS 指標會透過 PromQL 與其他標籤進行查詢。指標名稱與原始 CloudWatch 指標名稱相同，且原始 CloudWatch 維度可作為資料點屬性使用。下列標籤可供使用 （以下範例適用於 EC2 執行個體）：

下列範例Invocations會針對特定 Lambda 函數選取 ：

histogram_sum({Invocations, FunctionName="my-api-handler"})

下列範例Errors會為標記特定團隊的所有函數選取 Lambda：

histogram_sum(
  {Errors, "@instrumentation.@name"="cloudwatch.aws/lambda", "@aws.tag.Team"="backend"}
)

下列範例會計算依團隊Invocations分組的 Lambda 總數：

sum by ("@aws.tag.Team")(
    {Invocations, "@instrumentation.@name"="cloudwatch.aws/lambda"}
)

下列範例會選取 EC2 CPUUtilization 指標的所有時間序列。的用途"@instrumentation.@name"="cloudwatch.aws/ec2"是完全符合來自 EC2 的 CPUUtilization，而不是來自其他 AWS 服務，例如 Amazon Relational Database Service：

histogram_avg({CPUUtilization, "@instrumentation.@name"="cloudwatch.aws/ec2"})