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

# CloudWatch 指標 (OTel)
<a name="metrics-pipeline-selection-criteria"></a>

選擇條件會決定哪些 OTel 指標進入管道進行處理。每個條件都是與傳入指標的特定屬性`<path> == "<value>"`相符的表單表達式。至少需要一個選擇條件。

條件會在具有 AND 語意的`match_all`區塊內分組 — 指標必須符合群組中的每個表達式，才能進入管道。

## 支援的路徑
<a name="selection-criteria-paths"></a>

選擇條件中支援下列 OTTL 路徑：


**選擇條件路徑**  

| 路徑 | 說明 | 
| --- | --- | 
| `resource.attributes["key"]` | 資源層級屬性 | 
| `instrumentation_scope.name` | 檢測範圍名稱 | 
| `instrumentation_scope.version` | 檢測範圍版本 | 
| `instrumentation_scope.attributes["key"]` | 檢測範圍屬性 | 
| `metric.name` | 指標名稱 | 
| `datapoint.attributes["key"]` | Datapoint-level 屬性 | 
| `attributes["key"]` | 的簡短格式 `datapoint.attributes["key"]` | 

## 組態
<a name="selection-criteria-configuration"></a>

選擇條件在管道組態的 `source`區段中定義：

```
pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'metric.name == "http.server.request.duration"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "platform-engineering"
  sink:
    - cloudwatch_metrics: {}
```

下列範例使用所有支援的路徑類型：

```
pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'instrumentation_scope.name == "my-scope"'
            - 'instrumentation_scope.version == "1.0.0"'
            - 'instrumentation_scope.attributes["library"] == "otel-java"'
            - 'metric.name == "http.server.request.duration"'
            - 'datapoint.attributes["status_code"] == "200"'
            - 'attributes["environment"] == "production"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "observability"
  sink:
    - cloudwatch_metrics: {}
```

## 使用 PromQL 驗證
<a name="selection-criteria-promql"></a>

CloudWatch 使用`@`字首慣例將 OTLP 屬性範圍映射至 PromQL 標籤。使用此映射來驗證您的管道是否如預期在 Query Studio 中處理指標：


**PromQL 標籤映射的 OTTL 路徑**  

| 管道 OTTL 路徑 | PromQL 標籤字首 | 範例 | 
| --- | --- | --- | 
| `resource.attributes["key"]` | `@resource.` | `@resource.service.name` | 
| `instrumentation_scope.name` | `@instrumentation.@name` | `@instrumentation.@name` | 
| `instrumentation_scope.attributes["key"]` | `@instrumentation.` | `@instrumentation.library` | 
| `datapoint.attributes["key"]` / `attributes["key"]` | `@datapoint.` 或裸機 | `status_code` | 

例如，如果您的管道新增`resource.attributes["team"]`了 值 `"platform-engineering"`，您可以確認已套用它：

```
{"CPUUtilization", "@resource.team"="platform-engineering"}
```

## 要求與限制
<a name="selection-criteria-requirements"></a>

單一`match_all`群組  
每個管道在 中僅支援一個`match_all`群組`selection_criteria`。您無法在單一管道中定義多個`match_all`群組。

最低條件  
`match_all` 群組中至少需要一個表達式。

條件上限  
`match_all` 群組最多可包含 20 個表達式。

AND 語意  
`match_all` 群組中的所有表達式都必須相符，指標才能進入管道。

精確字串比對  
值必須是靜態字串。不支援萬用字元、規則運算式和部分比對。每個表達式都必須使用 `==`運算子。

管道之間沒有重疊的條件  
每個指標資料點最多必須符合一個管道。如果資料點同時符合新的和現有的管道條件，則管道建立會失敗。為了防止重疊，請在每個管道的選擇條件中包含至少一個具有不同值的屬性路徑。  
例如，以下兩個選擇條件重疊，因為管道 A 從 選取所有指標`payment-service`，其中包括管道 B 目標的特定指標：  

```
# Pipeline A — selects ALL metrics from payment-service
selection_criteria:
  - match_all:
      - 'resource.attributes["service.name"] == "payment-service"'

# Pipeline B — FAILS: a datapoint with service.name="payment-service"
# and metric.name="http.server.request.duration" matches both pipelines
selection_criteria:
  - match_all:
      - 'metric.name == "http.server.request.duration"'
```