View a markdown version of this page

Prosesor pipa metrik - Amazon CloudWatch

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.attributes["key"]

Resource-level

resource.attributes["service.name"]

instrumentation_scope.attributes["key"]

Atribut cakupan

instrumentation_scope.attributes["library"]

datapoint.attributes["key"]

Datapoint-level

datapoint.attributes["status_code"]

attributes["key"]

Bentuk singkat untuk datapoint

attributes["environment"]

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. Kapantrue, mengganti nilai yang ada. Default ke false. 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. Kapantrue, mengganti jika kunci target ada. Default ke false.

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,, dan add_attributes denganoverwrite_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.name dimulaicloudwatch.aws/. Metrik ini dilewatkan tanpa perubahan.