

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

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

Gunakan Sinyal CloudWatch Aplikasi untuk menginstruksikan aplikasi Anda secara otomatis 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 jejak dari aplikasi instrumen otomatis Anda, secara opsional menerapkan aturan untuk mengurangi kardinalitas tinggi, dan kemudian mempublikasikan telemetri yang diproses ke. CloudWatch Anda dapat memberikan konfigurasi khusus kepada CloudWatch agen khusus untuk Sinyal Aplikasi menggunakan file konfigurasi agen. Untuk memulainya, keberadaan bagian di bawah `application_signals` bagian dalam `metrics_collected` bagian file konfigurasi agen menentukan bahwa CloudWatch agen akan menerima metrik dari aplikasi instrumentasi otomatis Anda. `logs` Demikian pula, keberadaan `application_signals` bagian di bawah `traces_collected` bagian dalam `traces` bagian file konfigurasi agen menentukan bahwa CloudWatch agen diaktifkan untuk menerima jejak dari aplikasi instrumentasi 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 klaster 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 instrumentasi 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)
+ Untuk RedHat for OpenShift on AWS (ROSA), saat Anda menginstal operator CloudWatch agen menggunakan bagan helm, CloudWatch agen secara default diaktifkan untuk menerima metrik dan jejak dari aplikasi instrumentasi 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 CloudWatch agen dengan konfigurasi agen yang mengaktifkan Sinyal Aplikasi dengan menentukan `application_signals` bagian dan secara opsional aturan konfigurasi kustom seperti yang diuraikan nanti di bagian ini.

Berikut ini adalah ikhtisar bidang dalam file konfigurasi CloudWatch agen yang terkait dengan Sinyal CloudWatch 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 peningkatan observabilitas 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 Sinyal CloudWatch Aplikasi untuk menerima metrik dari aplikasi yang diinstrumentasi otomatis untuk memfasilitasi Sinyal Aplikasi. CloudWatch 
      + `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 untuk 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 jejak CloudWatch jika cocok 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 oleh 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 satuan. Pecahan 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 dijatuhkan. Nilai default-nya `false`.
**catatan**  
Untuk mengaktifkan logging ini, `debug` parameter di `agent` bagian ini juga harus diatur ke`true`.
+ `traces`
  + `traces_collected`
    + `application_signals` Opsional. Tentukan ini untuk memungkinkan CloudWatch agen menerima jejak dari aplikasi instrumentasi otomatis Anda untuk memfasilitasi CloudWatch Sinyal 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": {}
            }
        }
    }
}
```