Aktifkan Sinyal CloudWatch Aplikasi - Amazon CloudWatch

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

Aktifkan Sinyal CloudWatch Aplikasi

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 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. 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 EKS klaster Amazon, saat Anda menginstal EKS add-on Amazon CloudWatch Observability, 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 ke EKS add-on Amazon saat Anda membuat atau memperbaruinya dengan menggunakan konfigurasi tambahan, seperti yang diuraikan dalam. (Opsional) Konfigurasi tambahan

  • Untuk platform lain yang didukung termasuk AmazonEC2, 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:

            • keepMenentukan 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 adareplace. 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) Jikatrue, 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 adalahs,,,m, hms, dan us 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. Default-nya adalah false.

            catatan

            Untuk mengaktifkan logging ini, debug parameter di agent bagian ini juga harus diatur ketrue.

  • 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.

  2. 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.

  3. 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": {}
            }
        }
    }
}