Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Prosesor pipa metrik
Prosesor pipeline metrik mengubah titik data metrik oTel selama konsumsi. Pipeline metrik dapat memiliki hingga 20 prosesor, diterapkan secara berurutan sesuai urutan yang ditentukan.
Prosesor menggunakan ekspresi jalur OTTL untuk menargetkan atribut pada cakupan yang berbeda:
| Jalur | Lingkup | Contoh |
|---|---|---|
|
Resource-level |
|
|
Atribut cakupan |
|
|
Datapoint-level |
|
|
Bentuk singkat untuk datapoint |
|
add_properties prosesor
Menambahkan atau mengganti atribut pada titik data metrik. Bekerja dengan semua jenis temporalitas.
Setara dengan OTTL: set(attributes["key"], "value")
Konfigurasi
Konfigurasikan prosesor add_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 ditambahkan.
attributes[].key(diperlukan)-
Jalur atribut OTTL menentukan tempat untuk menambahkan atribut.
attributes[].value(diperlukan)-
Nilai string untuk ditetapkan.
attributes[].overwrite_if_key_exists(opsional)-
Boolean. Kapan
true, mengganti nilai yang ada. Default kefalse. Ketika disetel ketrue, operasi ini dianggap merusak dan tidak berlaku untuk metrik kumulatif atau metrik yang dijual.
pengolah delete_properties
Menghapus atribut tertentu dari titik data metrik. Tidak berlaku untuk metrik kumulatif atau metrik yang dijual.
Setara dengan OTTL: delete_key(attributes, "key")
Konfigurasi
Konfigurasikan prosesor delete_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.
pengolahukan_atribut prosesor
Mengganti nama kunci atribut pada titik data metrik. Tidak berlaku untuk metrik kumulatif atau metrik yang dijual.
Setara dengan OTTL: set() + delete_key()
Konfigurasi
Konfigurasikan prosesor rename_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 penggantian nama.
attributes[].from_key(diperlukan)-
Jalur atribut OTTL sumber.
attributes[].to_key(diperlukan)-
Target jalur atribut OTTL.
attributes[].overwrite_if_to_key_exists(opsional)-
Boolean. Kapan
true, mengganti jika kunci target ada. Default kefalse.
pengolah rename_metrics
Mengganti nama metrik. Tidak berlaku untuk metrik kumulatif atau metrik yang dijual.
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 penggantian nama.
metrics[].from(diperlukan)-
Nama metrik saat ini.
metrics[].to(diperlukan)-
Nama metrik baru.
pengganti_atribut_nilai prosesor
Memetakan nilai atribut dengan menggunakan tabel pencarian. Tidak berlaku untuk metrik kumulatif atau metrik yang dijual.
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 yang cocok.
attributes[].to(diperlukan)-
Nilai penggantian.
Contoh lengkap
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
- Prosesor maksimum
-
Pipeline metrik dapat memiliki paling banyak 20 prosesor.
- Prosesor destruktif dan temporalitas
-
Prosesor destruktif (
delete_attributesrename_attributes,rename_metrics,substitute_attribute_values,, danadd_attributesdenganoverwrite_if_key_exists: true) tidak berlaku untuk metrik kumulatif atau metrik yang dijual. Metrik ini dilewatkan tanpa perubahan. - Perlindungan metrik yang dijual
-
Prosesor destruktif tidak dapat memodifikasi metrik di mana
instrumentation_scope.namedimulaicloudwatch.aws/. Metrik ini dilewatkan tanpa perubahan.