

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

# Aktif CloudWatch kan Sinyal Aplikasi
<a name="CloudWatch-Agent-Application_Signals"></a>

Gunakan CloudWatch Sinyal Aplikasi untuk secara otomatis menginstrumentasikan aplikasi Anda AWS sehingga Anda dapat melacak kinerja aplikasi terhadap tujuan bisnis Anda. Sinyal Aplikasi memberi Anda tampilan terpadu, aplikasi-sentris dari aplikasi Java Anda, dependensinya, dan tepinya. Untuk informasi selengkapnya, lihat [Sinyal Aplikasi](CloudWatch-Application-Monitoring-Sections.md).

CloudWatch Sinyal Aplikasi memanfaatkan CloudWatch agen untuk menerima metrik dan pelacakan dari aplikasi berinstrumen otomatis Anda, secara opsional menerapkan aturan untuk mengurangi kardinalitas tinggi, dan kemudian menerbitkan telemetri yang diproses ke. CloudWatch Anda dapat memberikan konfigurasi khusus ke CloudWatch agen khusus untuk Sinyal Aplikasi menggunakan file konfigurasi agen. Untuk memulainya, kehadiran `application_signals` bagian di bawah `metrics_collected` bagian dalam `logs` bagian file konfigurasi agen menentukan bahwa CloudWatch agen akan menerima metrik dari aplikasi berinstrumen otomatis Anda. Demikian pula, kehadiran `application_signals` bagian di bawah `traces_collected` bagian dalam `traces` bagian file konfigurasi agen menentukan bahwa CloudWatch agen diaktifkan untuk menerima jejak dari aplikasi berinstrumen otomatis Anda. Selain itu, Anda dapat secara opsional meneruskan aturan konfigurasi khusus untuk mengurangi penerbitan telemetri kardinalitas tinggi seperti yang diuraikan dalam bagian ini.
+ Untuk cluster Amazon EKS, saat Anda menginstal add-on [ Amazon CloudWatch Observability ](install-CloudWatch-Observability-EKS-addon.md) EKS, CloudWatch agen secara default diaktifkan untuk menerima metrik dan jejak dari aplikasi berinstrumen otomatis Anda. Jika ingin meneruskan aturan konfigurasi khusus secara opsional, Anda dapat melakukannya dengan meneruskan konfigurasi agen khusus ke add-on Amazon EKS saat Anda membuat atau memperbaruinya dengan menggunakan konfigurasi tambahan, seperti yang diuraikan dalam. [(Opsional) Konfigurasi tambahan](install-CloudWatch-Observability-EKS-addon.md#install-CloudWatch-Observability-EKS-addon-configuration)
+  RedHat Untuk OpenShift on AWS (ROSA), saat Anda menginstal operator CloudWatch agen menggunakan diagram helm, CloudWatch agen secara default diaktifkan untuk menerima metrik dan pelacakan dari aplikasi berinstrumen otomatis Anda. Jika Anda ingin meneruskan aturan konfigurasi khusus secara opsional, Anda dapat melakukannya dengan meneruskan konfigurasi agen khusus dengan menggunakan bagan Helm, seperti yang diuraikan dalam[(Opsional) Konfigurasi tambahan](install-CloudWatch-Observability-EKS-addon.md#install-CloudWatch-Observability-EKS-addon-configuration).
+ Untuk platform lain yang didukung termasuk Amazon EC2, Anda harus memulai agen dengan konfigurasi CloudWatch agen yang mengaktifkan Sinyal Aplikasi dengan menentukan `application_signals` bagian dan secara opsional aturan konfigurasi khusus apa pun seperti yang diuraikan nanti di bagian ini.

Berikut ini adalah ikhtisar bidang dalam file konfigurasi CloudWatch agen yang terkait dengan Sin CloudWatch yal Aplikasi.
+ `logs`
  + `metrics_collected`— Bidang ini dapat berisi bagian untuk menentukan bahwa agen akan mengumpulkan log untuk mengaktifkan kasus penggunaan seperti Sinyal CloudWatch Aplikasi dan Wawasan Kontainer dengan pengamatan yang ditingkatkan untuk Amazon EKS.
**catatan**  
Sebelumnya bagian ini juga sudah digunakan untuk menentukan bahwa agen akan mengumpulkan log yang berada dalam format metrik tersemat. Pengaturan tersebut tidak lagi dibutuhkan.
    + `application_signals`(Opsional) Menentukan bahwa Anda ingin mengaktifkan Sin CloudWatch yal Aplikasi untuk menerima metrik dari aplikasi berinstrumen otomatis untuk memfasilitasi Sinyal CloudWatch Aplikasi.
      + `rules`(Opsional) Sebuah array dari aturan-aturan untuk memilih metrik-metrik dan jejak secara kondisional dan menerapkan tindakan untuk menangani skenario kardinalitas tinggi. Setiap aturan dapat berisi kolom berikut:
        + `rule_name` (Opsional) Nama aturan.
        + `selectors` (Opsional) Sebuah array metrik dan melacak pencocokan dimensi. Setiap pemilih harus memberikan kolom berikut:
          + `dimension` Diperlukan jika `selectors` tidak kosong. Ini menentukan dimensi metrik dan jejak yang akan digunakan sebagai filter.
          + `match` Diperlukan `selectors` jika tidak kosong. Pola wildcard yang digunakan untuk mencocokkan nilai dimensi yang ditentukan.
        + `action`( Opsional) Tindakan yang akan diterapkan pada metrik dan jejak yang cocok dengan pemilih yang ditentukan. Nilai `action` harus berupa salah satu kata kunci berikut:
          + `keep`Menentukan untuk mengirim hanya metrik dan pelacakan CloudWatch jika dicocokkan dengan`selectors`.
          + `drop` Menentukan untuk menjatuhkan metrik dan jejak yang cocok dengan `selectors`. 
          + `replace` Menentukan untuk mengganti dimensi metrik dan jejak yang cocok. `selectors` Mereka diganti sesuai dengan `replacements` bagian.
        + `replacements` Diperlukan jika `action` adalah `replace`. Array pasangan dimensi dan nilai yang akan diterapkan pada metrik dan jejak yang cocok dengan yang ditentukan `selectors` saat `action` ada`replace`. Setiap pengganti harus memberikan kolom berikut:
          + `target_dimension` Diperlukan `replacements` jika tidak kosong. Menentukan dimensi yang perlu diganti.
          + `value` Diperlukan `replacements` jika tidak kosong. Nilai untuk mengganti nilai asli `target_dimension` dengan.
      + `limiter`(Opsional) Gunakan bagian ini untuk membatasi berapa banyak metrik dan dimensi yang dikirimkan Sinyal Aplikasi CloudWatch, untuk mengoptimalkan biaya Anda.
        + `disabled`(Opsional) Jika`true`, fitur pembatas metrik dinonaktifkan. Bawaannya adalah `false`
        + `drop_threshold`(Opsional) Jumlah maksimum metrik berbeda per layanan dalam satu interval rotasi yang dapat diekspor oleh satu CloudWatch agen. Defaultnya adalah 500.
        + `rotation_interval`(Opsional) Interval di mana limiter mengatur ulang catatan metrik untuk penghitungan perbedaan. Ini dinyatakan sebagai string dengan urutan angka dan akhiran unit. Fraksi didukung. Sufiks unit yang didukung adalah`s`,,`m`,, `h` `ms``us`, dan. `ns` Defaultnya adalah `1h` selama satu jam.
        + `log_dropped_metrics`(Opsional) Menentukan apakah agen harus menulis log ke log CloudWatch agen saat metrik Sinyal Aplikasi dihapus. Nilai default-nya `false`.
**catatan**  
Untuk mengaktifkan logging ini, `debug` parameter di `agent` bagian juga harus diatur ke`true`.
+ `traces`
  + `traces_collected`
    + `application_signals` Opsional. Tentukan ini untuk memungkinkan CloudWatch agen menerima jejak dari aplikasi berinstrumen otomatis Anda untuk memfasilitasi Sinyal CloudWatch Aplikasi.

**catatan**  
Meskipun `application_signals` aturan kustom ditentukan di bagian `metrics_collected` yang terkandung dalam bagian `logs`, mereka juga secara implisit berlaku untuk bagian `traces_collected` tersebut juga. Seperangkat aturan yang sama akan berlaku untuk metrik dan jejak.

Ketika ada beberapa aturan dengan tindakan yang berbeda, mereka berlaku dalam urutan berikut: `keep`, kemudian `drop`, lalu `replace`.

Berikut ini adalah contoh file konfigurasi CloudWatch agen lengkap yang menerapkan aturan khusus.

```
{
  "logs": {
    "metrics_collected": {
      "application_signals": {
        "rules": [
          {
            "rule_name": "keep01",
            "selectors": [
              {
                "dimension": "Service",
                "match": "pet-clinic-frontend"
              },
              {
                "dimension": "RemoteService",
                "match": "customers-service"
              }
            ],
            "action": "keep"
          },
          {
            "rule_name": "drop01",
            "selectors": [
              {
                "dimension": "Operation",
                "match": "GET /api/customer/owners/*"
              }
            ],
            "action": "drop"
          },
          {
            "rule_name": "replace01",
            "selectors": [
              {
                "dimension": "Operation",
                "match": "PUT /api/customer/owners/*/pets/*"
              },
              {
                "dimension": "RemoteOperation",
                "match": "PUT /owners"
              }
            ],
            "replacements": [
              {
                "target_dimension": "Operation",
                "value": "PUT /api/customer/owners/{ownerId}/pets{petId}"
              }
            ],
            "action": "replace"
          }
        ]
      }
    }
  },
  "traces": {
    "traces_collected": {
      "application_signals": {}
    }
  }
}
```

Untuk contoh file konfigurasi sebelumnya, `rules` diproses sebagai berikut:

1. Aturan `keep01` memastikan bahwa setiap metrik dan jejak dengan dimensi `Service` sebagai `pet-clinic-frontend` dan dimensi `RemoteService` sebagai `customers-service` akan disimpan.

1. Untuk metrik dan jejak yang diproses setelah diterapkan `keep01`, aturan `drop01` memastikan bahwa metrik-metrik dan jejak dengan dimensi `Operation` sebagai `GET /api/customer/owners/*` akan dibuang.

1. Untuk metrik-metrik dan jejak yang diproses setelah penerapan `drop01`, aturan `replace01` akan memperbarui metrik dan jejak yang memiliki dimensi `Operation` sebagai `PUT /api/customer/owners/*/pets/*` dan dimensi `RemoteOperation` sebagai `PUT /owners` sedemikian rupa sehingga dimensi `Operation` yan dimilikinya sekarang diganti menjadi `PUT /api/customer/owners/{ownerId}/pets{petId}`.

Berikut ini adalah contoh lengkap dari file CloudWatch konfigurasi yang mengelola kardinalitas dalam Sinyal Aplikasi dengan mengubah batas metrik menjadi 100, memungkinkan pencatatan metrik yang dijatuhkan, dan mengatur interval rotasi menjadi dua jam.

```
{
    "logs": {
        "metrics_collected": {
            "application_signals": {
                "limiter": {
                    "disabled": false,
                    "drop_threshold": 100,
                    "rotation_interval": "2h",
                    "log_dropped_metrics": true
                }
            }
        },
        "traces": {
            "traces_collected": {
                "application_signals": {}
            }
        }
    }
}
```