Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Prosesor pipa metrik
<a name="metrics-pipeline-processors"></a>

Prosesor pipa metrik mengubah titik data metrik OTel selama konsumsi. Pipa metrik dapat memiliki hingga 20 prosesor, diterapkan secara berurutan dalam urutan yang ditentukan.

Prosesor menggunakan ekspresi jalur OTTL untuk menargetkan atribut pada cakupan yang berbeda:


**Cakupan jalur OTTL**  

| Jalan | Lingkup | Contoh | 
| --- | --- | --- | 
| `resource.attributes["key"]` | Resource-level | `resource.attributes["service.name"]` | 
| `instrumentation_scope.attributes["key"]` | Atribut lingkup | `instrumentation_scope.attributes["library"]` | 
| `datapoint.attributes["key"]` | Datapoint-level | `datapoint.attributes["status_code"]` | 
| `attributes["key"]` | Formulir singkat untuk titik data | `attributes["environment"]` | 

## prosesor add\_attributes
<a name="add-attributes-processor"></a>

Menambahkan atau menimpa atribut pada titik data metrik. Bekerja dengan semua jenis temporalitas.

**Setara dengan OTTL:** `set(attributes["key"], "value")`

**Konfigurasi**  
Konfigurasikan prosesor add\_attributes dengan parameter berikut:

```
processor:
  - add_attributes:
      attributes:
        - key: resource.attributes["team"]
          value: "payments"
        - key: attributes["environment"]
          value: "production"
        - key: instrumentation_scope.attributes["version"]
          value: "1.0"
          overwrite_if_key_exists: true
```Parameter

`attributes`(Diperlukan)  
Array objek atribut untuk menambahkan.

`attributes[].key`(Diperlukan)  
Jalur atribut OTTL menentukan di mana untuk menambahkan atribut.

`attributes[].value`(Diperlukan)  
Nilai string untuk ditetapkan.

`attributes[].overwrite_if_key_exists` (opsional)  
Boolean. Kapan`true`, menimpa nilai yang ada. Default ke `false`. Ketika diatur ke`true`, operasi ini dianggap merusak dan tidak berlaku untuk metrik kumulatif atau metrik vended.

## prosesor delete\_attributes
<a name="delete-attributes-processor"></a>

Menghapus atribut tertentu dari titik data metrik. **Tidak berlaku untuk metrik kumulatif atau metrik vended.**

**Setara dengan OTTL:** `delete_key(attributes, "key")`

**Konfigurasi**  
Konfigurasikan prosesor delete\_attributes dengan parameter berikut:

```
processor:
  - delete_attributes:
      with_keys:
        - resource.attributes["obsolete"]
        - attributes["temp"]
        - datapoint.attributes["debug"]
```Parameter

`with_keys`(Diperlukan)  
Array jalur atribut OTTL untuk dihapus.

## prosesor rename\_attributes
<a name="rename-attributes-processor"></a>

Mengganti nama kunci atribut pada titik data metrik. **Tidak berlaku untuk metrik kumulatif atau metrik vended.**

**Setara dengan OTTL:** `set() + delete_key()`

**Konfigurasi**  
Konfigurasikan prosesor rename\_attributes dengan parameter berikut:

```
processor:
  - rename_attributes:
      attributes:
        - from_key: resource.attributes["old_key"]
          to_key: resource.attributes["new_key"]
          overwrite_if_to_key_exists: true
```Parameter

`attributes`(Diperlukan)  
Array operasi ganti nama.

`attributes[].from_key`(Diperlukan)  
Sumber jalur atribut OTTL.

`attributes[].to_key`(Diperlukan)  
Targetkan jalur atribut OTTL.

`attributes[].overwrite_if_to_key_exists` (opsional)  
Boolean. Kapan`true`, timpa jika kunci target ada. Default ke `false`.

## prosesor rename\_metrics
<a name="rename-metrics-processor"></a>

Mengganti nama nama metrik. **Tidak berlaku untuk metrik kumulatif atau metrik vended.**

**Setara dengan OTTL:** `set(name, "new.metric.name") where name == "old.metric.name"`

**Konfigurasi**  
Konfigurasikan prosesor rename\_metrics dengan parameter berikut:

```
processor:
  - rename_metrics:
      metrics:
        - from: "old.metric.name"
          to: "new.metric.name"
```Parameter

`metrics`(Diperlukan)  
Array operasi ganti nama.

`metrics[].from`(Diperlukan)  
Nama metrik saat ini.

`metrics[].to`(Diperlukan)  
Nama metrik baru.

## prosesor substitute\_attribute\_values
<a name="substitute-attribute-values-processor"></a>

Maps nilai atribut melalui tabel pencarian. **Tidak berlaku untuk metrik kumulatif atau metrik vended.**

**Setara dengan OTTL:** `replace_match()`

**Konfigurasi**  
Konfigurasikan prosesor substitute\_attribute\_values dengan parameter berikut:

```
processor:
  - substitute_attribute_values:
      attributes:
        - key: resource.attributes["region"]
          from: "us-east-1a"
          to: "us-east-1"
```Parameter

`attributes`(Diperlukan)  
Array operasi substitusi.

`attributes[].key`(Diperlukan)  
Jalur atribut OTTL untuk dicocokkan.

`attributes[].from`(Diperlukan)  
Nilai untuk dicocokkan.

`attributes[].to`(Diperlukan)  
Nilai penggantian.

## Contoh lengkap
<a name="metrics-processors-full-example"></a>

Contoh berikut menggunakan kelima prosesor dalam satu pipeline:

```
pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'metric.name == "CPUUtilization"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["env"]
            value: "prod"
            overwrite_if_key_exists: true
    - delete_attributes:
        with_keys:
          - resource.attributes["internal.trace"]
    - rename_attributes:
        attributes:
          - from_key: resource.attributes["old_key"]
            to_key: resource.attributes["new_key"]
    - rename_metrics:
        metrics:
          - from: "CPUUtilization"
            to: "system.cpu.utilization"
    - substitute_attribute_values:
        attributes:
          - key: resource.attributes["environment"]
            from: "dev"
            to: "development"
  sink:
    - cloudwatch_metrics: {}
```

## Kompatibilitas dan pembatasan prosesor
<a name="metrics-processor-restrictions"></a>

Prosesor maksimum  
Pipa metrik dapat memiliki paling banyak 20 prosesor.

Prosesor dan temporalitas yang merusak  
Prosesor destruktif (`delete_attributes``rename_attributes`,,`rename_metrics`,`substitute_attribute_values`, dan `add_attributes` dengan`overwrite_if_key_exists: true`) tidak berlaku untuk metrik kumulatif atau metrik vended. Metrik ini dilewatkan tidak berubah.

Perlindungan metrik yang dijual  
Prosesor destruktif tidak dapat memodifikasi metrik di mana `instrumentation_scope.name` dimulai dengan. `cloudwatch.aws/` Metrik ini dilewatkan tidak berubah.