

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

# CloudWatch solusi observabilitas
<a name="Monitoring-Solutions"></a>

CloudWatch solusi observabilitas menawarkan katalog konfigurasi yang tersedia untuk membantu Anda menerapkan pemantauan dengan cepat untuk berbagai AWS layanan dan beban kerja umum, seperti Java Virtual Machines (JVM), Apache Kafka, Apache Tomcat, dan NGINX. Solusi ini memberikan panduan terfokus pada tugas pemantauan utama, termasuk pemasangan dan konfigurasi CloudWatch agen, penerapan dasbor khusus yang telah ditentukan sebelumnya, dan pengaturan alarm metrik. Mereka dirancang untuk membantu pengembang dan tim operasi dalam memanfaatkan alat AWS pemantauan dan observabilitas secara lebih efektif.

Solusinya mencakup panduan kapan harus menggunakan fitur observabilitas tertentu seperti metrik Pemantauan Terperinci untuk infrastruktur, Wawasan Kontainer untuk pemantauan kontainer, dan Sinyal Aplikasi untuk pemantauan aplikasi. Dengan memberikan contoh kerja dan konfigurasi praktis, solusi ini bertujuan untuk menyederhanakan proses penyiapan awal, memungkinkan Anda untuk membuat pemantauan fungsional lebih cepat dan menyesuaikan sesuai kebutuhan untuk kebutuhan spesifik mereka.

Untuk memulai dengan solusi observabilitas, kunjungi [halaman solusi observabilitas](https://console.aws.amazon.com/cloudwatch/home?#settings:/observability-solutions) di konsol. CloudWatch 

Untuk solusi sumber terbuka yang bekerja dengan Grafana Terkelola Amazon, lihat Solusi Grafana [Terkelola Amazon](https://docs.aws.amazon.com/grafana/latest/userguide/AMG_solutions.html)

Solusi yang membutuhkan CloudWatch agen dirinci di bawah ini:

**Topics**
+ [CloudWatch solusi: Beban kerja JVM di Amazon EC2](Solution-JVM-On-EC2.md)
+ [CloudWatch solusi: Beban kerja NGINX di Amazon EC2](Solution-NGINX-On-EC2.md)
+ [CloudWatch solusi: Beban kerja GPU NVIDIA di Amazon EC2](Solution-NVIDIA-GPU-On-EC2.md)
+ [CloudWatch solusi: Beban kerja Kafka di Amazon EC2](Solution-Kafka-On-EC2.md)
+ [CloudWatch solusi: Beban kerja Tomcat di Amazon EC2](Solution-Tomcat-On-EC2.md)
+ [CloudWatch solusi: Kesehatan Amazon EC2](Solution-EC2-Health.md)

**Bagaimana cara kerja dasbor solusi?**  
Dasbor untuk CloudWatch solusi menggunakan variabel bertenaga penelusuran (dropdown) yang memungkinkan Anda menjelajahi dan memvisualisasikan berbagai aspek beban kerja Anda secara dinamis.  
Dengan menggabungkan fleksibilitas variabel yang didukung penelusuran dengan [widget metrik](create-and-work-with-widgets.md) yang telah dikonfigurasi sebelumnya, dasbor memberikan wawasan mendalam tentang beban kerja Anda, memungkinkan pemantauan proaktif, pemecahan masalah, dan pengoptimalan. Pendekatan dinamis ini memastikan bahwa Anda dapat dengan cepat menyesuaikan dasbor dengan kebutuhan pemantauan spesifik Anda, tanpa perlu penyesuaian atau konfigurasi ekstensif.

**Apakah solusi mendukung observabilitas lintas wilayah?**  
CloudWatch dasbor solusi menampilkan metrik Wilayah tempat dasbor solusi dibuat. Namun, dasbor solusi tidak menampilkan metrik di beberapa Wilayah. Jika Anda memiliki kasus penggunaan untuk melihat data dari beberapa Wilayah dalam satu dasbor, Anda harus menyesuaikan dasbor JSON untuk menambahkan Wilayah yang ingin Anda lihat. Untuk melakukannya, gunakan `region` atribut format metrik untuk menanyakan metrik dari Wilayah yang berbeda. Untuk informasi selengkapnya tentang memodifikasi dasbor JSON, lihat [Widget Metrik: Format untuk Setiap Metrik dalam Array](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/CloudWatch-Dashboard-Body-Structure.html#CloudWatch-Dashboard-Properties-Metrics-Array-Format).

**Apakah dasbor solusi mendukung konsol [Lintas akun Lintas wilayah? CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Cross-Account-Cross-Region.html)**  
Saat menggunakan observabilitas CloudWatch lintas akun, dasbor solusi di akun pemantauan pusat menampilkan metrik dari akun sumber di Wilayah yang sama. Untuk membedakan metrik untuk beban kerja serupa di seluruh akun, berikan nilai dimensi pengelompokan unik dalam konfigurasi agen. Misalnya, tetapkan `ClusterName` nilai berbeda untuk broker Kafka di akun yang berbeda untuk beban kerja Kafka, memungkinkan pemilihan klaster yang tepat dan tampilan metrik di dasbor.

**Apakah dasbor solusi mendukung pengamatan [CloudWatch lintas akun?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)**  
Jika Anda telah mengaktifkan lintas akun menggunakan CloudWatch konsol Lintas akun Lintas wilayah, Anda tidak akan dapat menggunakan dasbor solusi yang dibuat di akun pemantauan untuk melihat metrik dari akun sumber. Sebagai gantinya, Anda harus membuat dasbor di akun sumber masing-masing. Namun, Anda dapat membuat dasbor di akun sumber dan melihatnya dari akun pemantauan dengan mengganti pengaturan ID akun di konsol.

**Apa batasan untuk dasbor solusi?**  
Dasbor solusi memanfaatkan ekspresi Penelusuran untuk memfilter dan menganalisis metrik untuk beban kerja. Ini memungkinkan tampilan dinamis berdasarkan pilihan opsi dropdown. Ekspresi penelusuran ini mungkin mengembalikan lebih dari 500 deret waktu, tetapi setiap widget dasbor tidak dapat menampilkan lebih dari 500 deret waktu. Jika penelusuran metrik di dasbor solusi menghasilkan lebih dari 500 deret waktu di semua Amazon EC2; instance, grafik yang menampilkan kontributor teratas mungkin menunjukkan hasil yang tidak akurat. Untuk informasi selengkapnya tentang ekspresi penelusuran, lihat[CloudWatch sintaks ekspresi pencarian](search-expression-syntax.md).  
CloudWatch menampilkan informasi metrik di dasbor jika Anda mengklik `i` ikon di widget dasbor. Namun, saat ini tidak berfungsi untuk widget dasbor yang menggunakan ekspresi penelusuran. Dasbor solusi menggunakan ekspresi penelusuran, sehingga Anda tidak akan dapat melihat deskripsi metrik di dasbor.

**Dapatkah saya menyesuaikan konfigurasi agen atau dasbor yang disediakan oleh solusi?**  
Anda dapat menyesuaikan konfigurasi agen dan dasbor. Ketahuilah bahwa jika Anda menyesuaikan konfigurasi agen, Anda harus memperbarui dasbor yang sesuai atau itu akan menampilkan widget metrik kosong. Perlu diketahui juga bahwa jika CloudWatch merilis versi baru solusi, Anda mungkin harus mengulangi penyesuaian jika menerapkan versi solusi yang lebih baru. 

**Bagaimana solusi berversi?**  
Setiap solusi memberikan up-to-date instruksi dan sumber daya terbanyak. Kami selalu merekomendasikan menggunakan versi terbaru yang tersedia. Meskipun solusi itu sendiri tidak berversi, artefak terkait (seperti CloudFormation templat untuk dasbor dan instalasi agen) diberi versi.  
Anda dapat mengidentifikasi versi artefak yang digunakan sebelumnya dengan memeriksa bidang deskripsi CloudFormation templat atau nama file templat yang Anda unduh. Untuk menentukan apakah Anda menggunakan versi terbaru, bandingkan versi yang diterapkan dengan versi yang saat ini direferensikan dalam dokumentasi solusi.

# CloudWatch solusi: Beban kerja JVM di Amazon EC2
<a name="Solution-JVM-On-EC2"></a>

Solusi ini membantu Anda mengonfigurasi pengumpulan out-of-the-box metrik menggunakan CloudWatch agen untuk aplikasi JVM yang berjalan pada instans EC2. Selain itu, ini membantu Anda mengatur CloudWatch dasbor yang telah dikonfigurasi sebelumnya. Untuk informasi umum tentang semua solusi CloudWatch observabilitas, lihat[CloudWatch solusi observabilitas](Monitoring-Solutions.md).

**Topics**
+ [Persyaratan](#Solution-JVM-On-EC2-Requirements)
+ [Manfaat](#Solution-JVM-On-EC2-Benefits)
+ [Biaya](#Solution-JVM-On-EC2-Costs)
+ [CloudWatch konfigurasi agen untuk solusi ini](#Solution-JVM-CloudWatch-Agent)
+ [Menyebarkan agen untuk solusi Anda](#Solution-JVM-Agent-Deploy)
+ [Buat dasbor solusi JVM](#Solution-JVM-Dashboard)

## Persyaratan
<a name="Solution-JVM-On-EC2-Requirements"></a>

Solusi ini relevan untuk kondisi berikut:
+ Versi yang didukung: Java LTS versi 8, 11, 17, dan 21
+ Hitung: Amazon EC2
+ Mendukung hingga 500 instans EC2 di semua beban kerja JVM dalam satu Wilayah AWS
+ Versi terbaru dari CloudWatch agent
+ Agen SSM diinstal pada instans EC2
**catatan**  
AWS Systems Manager (Agen SSM) sudah diinstal sebelumnya pada beberapa [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html) yang disediakan oleh AWS dan pihak ketiga tepercaya. Jika agen tidak diinstal, Anda dapat menginstalnya secara manual menggunakan prosedur untuk jenis sistem operasi Anda.  
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-macos.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-windows.html)

## Manfaat
<a name="Solution-JVM-On-EC2-Benefits"></a>

Solusi ini memberikan pemantauan JVM, memberikan wawasan berharga untuk kasus penggunaan berikut:
+ Pantau penggunaan memori heap dan non-heap JVM.
+ Analisis thread dan pemuatan kelas untuk masalah konkurensi.
+ Lacak pengumpulan sampah untuk mengidentifikasi kebocoran memori.
+ Beralih di antara berbagai aplikasi JVM yang dikonfigurasi melalui solusi di bawah akun yang sama.

Di bawah ini adalah keuntungan utama dari solusi ini:
+ Mengotomatiskan pengumpulan metrik untuk JVM menggunakan konfigurasi CloudWatch agen, menghilangkan instrumentasi manual.
+ Menyediakan CloudWatch dasbor terkonsolidasi yang telah dikonfigurasi sebelumnya untuk metrik JVM. Dasbor akan secara otomatis menangani metrik dari instans JVM EC2 baru yang dikonfigurasi menggunakan solusi, bahkan jika metrik tersebut tidak ada saat Anda pertama kali membuat dasbor. Ini juga memungkinkan Anda untuk mengelompokkan metrik ke dalam aplikasi logis untuk fokus dan manajemen yang lebih mudah.

Gambar berikut adalah contoh dasbor untuk solusi ini.

![\[Contoh dasbor JVM\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/monitoring/images/JvmDashboard.png)


## Biaya
<a name="Solution-JVM-On-EC2-Costs"></a>

Solusi ini membuat dan menggunakan sumber daya di akun Anda. Anda dikenakan biaya untuk penggunaan standar, termasuk yang berikut:
+ Semua metrik yang dikumpulkan oleh CloudWatch agen dikenakan biaya sebagai metrik khusus. Jumlah metrik yang digunakan oleh solusi ini tergantung pada jumlah host EC2.
  + Setiap host JVM yang dikonfigurasi untuk solusi menerbitkan total 18 metrik ditambah satu metrik (`disk_used_percent`) yang jumlah metriknya bergantung pada jumlah jalur untuk host.
+ Satu dasbor khusus.
+ Operasi API yang diminta oleh CloudWatch agen untuk mempublikasikan metrik. Dengan konfigurasi default untuk solusi ini, CloudWatch agen memanggil **PutMetricData**sekali setiap menit untuk setiap host EC2. Ini berarti **PutMetricData**API akan dipanggil `30*24*60=43,200` dalam bulan 30 hari untuk setiap host EC2.

Untuk informasi selengkapnya tentang CloudWatch harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/).

Kalkulator harga dapat membantu Anda memperkirakan perkiraan biaya bulanan untuk menggunakan solusi ini. 

**Untuk menggunakan kalkulator harga untuk memperkirakan biaya solusi bulanan Anda**

1. Buka [kalkulator CloudWatch harga Amazon](https://calculator.aws/#/createCalculator/CloudWatch).

1. Untuk **Pilih Wilayah**, pilih Wilayah tempat Anda ingin menerapkan solusi.

1. Di bagian **Metrik**, untuk **Jumlah metrik, masukkan**. **(18 \$1 average number of disk paths per EC2 host) \$1 number of EC2 instances configured for this solution**

1. Di **APIs**bagian ini, untuk **Jumlah permintaan API**, masukkan**43200 \$1 number of EC2 instances configured for this solution**.

   Secara default, CloudWatch agen melakukan satu **PutMetricData**operasi setiap menit untuk setiap host EC2.

1. Di bagian **Dasbor dan Alarm**, untuk **Jumlah Dasbor**, masukkan. **1**

1. Anda dapat melihat perkiraan biaya bulanan Anda di bagian bawah kalkulator harga.

## CloudWatch konfigurasi agen untuk solusi ini
<a name="Solution-JVM-CloudWatch-Agent"></a>

 CloudWatch Agen adalah perangkat lunak yang berjalan terus menerus dan mandiri di server Anda dan di lingkungan kontainer. Ini mengumpulkan metrik, log, dan jejak dari infrastruktur dan aplikasi Anda dan mengirimkannya ke dan CloudWatch X-Ray.

Untuk informasi lebih lanjut tentang CloudWatch agen, lihat[Kumpulkan metrik, log, dan jejak menggunakan agen CloudWatch](Install-CloudWatch-Agent.md).

Konfigurasi agen dalam solusi ini mengumpulkan metrik dasar untuk solusi tersebut. CloudWatch Agen dapat dikonfigurasi untuk mengumpulkan lebih banyak metrik JVM daripada tampilan dasbor secara default. Untuk daftar semua metrik JVM yang dapat Anda kumpulkan, lihat. [Kumpulkan metrik JVM](CloudWatch-Agent-JMX-metrics.md#CloudWatch-Agent-JVM-metrics) Untuk informasi umum tentang konfigurasi CloudWatch agen, lihat[Metrik yang dikumpulkan oleh agen CloudWatch](metrics-collected-by-CloudWatch-agent.md).

**Paparkan port JMX untuk aplikasi JVM**

 CloudWatch Agen mengandalkan JMX untuk mengumpulkan metrik yang terkait dengan proses JVM. Untuk memungkinkan ini, Anda harus mengekspos port JMX dari aplikasi JVM Anda. Petunjuk untuk mengekspos port JMX tergantung pada jenis beban kerja yang Anda gunakan untuk aplikasi JVM Anda. Lihat dokumentasi untuk aplikasi Anda untuk menemukan petunjuk ini.

Secara umum, untuk mengaktifkan port JMX untuk pemantauan dan manajemen, Anda akan mengatur properti sistem berikut untuk aplikasi JVM Anda. Pastikan untuk menentukan nomor port yang tidak digunakan. Contoh berikut mengatur JMX yang tidak diautentikasi. Jika keamanan Anda policies/requirements mengharuskan Anda mengaktifkan JMX dengan otentikasi kata sandi atau SSL untuk akses jarak jauh, lihat [dokumentasi JMX](https://docs.oracle.com/en/java/javase/17/management/monitoring-and-management-using-jmx-technology.html) untuk mengatur properti yang diperlukan.

```
-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port=port-number
-Dcom.sun.management.jmxremote.authenticate=false 
-Dcom.sun.management.jmxremote.ssl=false
```

Tinjau skrip awal dan file konfigurasi aplikasi Anda untuk menemukan tempat terbaik untuk menambahkan argumen ini. Ketika Anda menjalankan `.jar` file dari baris perintah, perintah ini bisa terlihat seperti berikut, di mana *pet-search.jar* adalah nama jar aplikasi.

```
$ java -jar -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false pet-search.jar
```

**Konfigurasi agen untuk solusi ini**

Metrik yang dikumpulkan oleh agen ditentukan dalam konfigurasi agen. Solusi ini menyediakan konfigurasi agen untuk mengumpulkan metrik yang direkomendasikan dengan dimensi yang sesuai untuk dasbor solusi. 

Langkah-langkah untuk menerapkan solusi dijelaskan nanti di[Menyebarkan agen untuk solusi Anda](#Solution-JVM-Agent-Deploy). Informasi berikut dimaksudkan untuk membantu Anda memahami cara menyesuaikan konfigurasi agen untuk lingkungan Anda.

Anda harus menyesuaikan beberapa bagian dari konfigurasi agen berikut untuk lingkungan Anda:
+ Nomor port JMX adalah nomor port yang Anda konfigurasikan di bagian sebelumnya dari dokumentasi ini. Itu ada di `endpoint` garis dalam konfigurasi.
+ `ProcessGroupName`— Berikan nama yang berarti untuk `ProcessGroupName` dimensi. Nama-nama ini harus mewakili pengelompokan cluster, aplikasi, atau layanan untuk instans EC2 yang menjalankan aplikasi atau proses yang sama. Ini membantu Anda mengelompokkan metrik dari instance yang termasuk dalam grup proses JVM yang sama, memberikan tampilan terpadu kinerja klaster, aplikasi, dan layanan di dasbor solusi.

Misalnya, jika Anda memiliki dua aplikasi Java yang berjalan di akun yang sama, satu untuk `order-processing` aplikasi dan satu lagi untuk `inventory-management` aplikasi, Anda harus mengatur `ProcessGroupName` dimensi yang sesuai dalam konfigurasi agen setiap instance.
+ Untuk instance `order-processing` aplikasi, atur`ProcessGroupName=order-processing`.
+ Untuk instance `inventory-management` aplikasi, atur`ProcessGroupName=inventory-management`.

Saat Anda mengikuti panduan ini, dasbor solusi akan secara otomatis mengelompokkan metrik berdasarkan `ProcessGroupName` dimensi. Dasbor akan menyertakan opsi dropdown untuk memilih dan melihat metrik untuk grup proses tertentu, memungkinkan Anda memantau kinerja grup proses individu secara terpisah.

### Konfigurasi agen untuk host JVM
<a name="Solution-JVM-Agent-Config"></a>

Gunakan konfigurasi CloudWatch agen berikut pada instans EC2 di mana aplikasi Java Anda digunakan. Konfigurasi akan disimpan sebagai parameter di Penyimpanan Parameter SSM, seperti yang dijelaskan nanti. [Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store](#Solution-JVM-Agent-Step2)

Ganti *ProcessGroupName* dengan nama grup proses Anda. Ganti *port-number* dengan port JMX aplikasi Java Anda. Jika JMX diaktifkan dengan otentikasi kata sandi atau SSL untuk akses jarak jauh, lihat [Kumpulkan metrik Java Management Extensions (JMX)](CloudWatch-Agent-JMX-metrics.md) informasi tentang pengaturan TLS atau otorisasi dalam konfigurasi agen sebagaimana diperlukan.

Metrik EC2 yang ditampilkan dalam konfigurasi ini (konfigurasi ditampilkan di luar blok JMX) hanya berfungsi untuk instance Linux dan macOS. Jika Anda menggunakan instance Windows, Anda dapat memilih untuk menghilangkan metrik ini dalam konfigurasi. Untuk informasi tentang metrik yang dikumpulkan pada instance Windows, lihat. [Metrik yang dikumpulkan oleh CloudWatch agen pada instans Windows Server](metrics-collected-by-CloudWatch-agent.md#windows-metrics-enabled-by-CloudWatch-agent)

```
{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "jvm": {
            "measurement": [
              "jvm.classes.loaded",
              "jvm.gc.collections.count",
              "jvm.gc.collections.elapsed",
              "jvm.memory.heap.committed",
              "jvm.memory.heap.max",
              "jvm.memory.heap.used",
              "jvm.memory.nonheap.committed",
              "jvm.memory.nonheap.max",
              "jvm.memory.nonheap.used",
              "jvm.threads.count"
            ]
          },
          "append_dimensions": {
            "ProcessGroupName": "ProcessGroupName"
          }
        }
      ],
      "disk": {
        "measurement": [
          "used_percent"
        ]
      },
      "mem": {
        "measurement": [
          "used_percent"
        ]
      },
      "swap": {
        "measurement": [
          "used_percent"
        ]
      },
      "netstat": {
        "measurement": [
          "tcp_established",
          "tcp_time_wait"
        ]
      }
    }
  }
}
```

## Menyebarkan agen untuk solusi Anda
<a name="Solution-JVM-Agent-Deploy"></a>

Ada beberapa pendekatan untuk menginstal CloudWatch agen, tergantung pada kasus penggunaan. Sebaiknya gunakan Systems Manager untuk solusi ini. Ini memberikan pengalaman konsol dan membuatnya lebih mudah untuk mengelola armada server yang dikelola dalam satu AWS akun. Petunjuk di bagian ini menggunakan Systems Manager dan ditujukan untuk saat Anda tidak menjalankan CloudWatch agen dengan konfigurasi yang ada. Anda dapat memeriksa apakah CloudWatch agen berjalan dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running).

Jika Anda sudah menjalankan CloudWatch agen di host EC2 tempat beban kerja diterapkan dan mengelola konfigurasi agen, Anda dapat melewati instruksi di bagian ini dan mengikuti mekanisme penerapan yang ada untuk memperbarui konfigurasi. Pastikan untuk menggabungkan konfigurasi agen JVM dengan konfigurasi agen Anda yang ada, dan kemudian menerapkan konfigurasi gabungan. Jika Anda menggunakan Systems Manager untuk menyimpan dan mengelola konfigurasi CloudWatch agen, Anda dapat menggabungkan konfigurasi ke nilai parameter yang ada. Untuk informasi selengkapnya, lihat [Mengelola file konfigurasi CloudWatch agen](https://docs.aws.amazon.com/prescriptive-guidance/latest/implementing-logging-monitoring-cloudwatch/create-store-cloudwatch-configurations.html).

**catatan**  
Menggunakan Systems Manager untuk menerapkan konfigurasi CloudWatch agen berikut akan menggantikan atau menimpa konfigurasi CloudWatch agen yang ada pada instans EC2 Anda. Anda dapat memodifikasi konfigurasi ini agar sesuai dengan lingkungan unik atau kasus penggunaan Anda. Metrik yang ditentukan dalam solusi ini adalah minimum yang diperlukan untuk dasbor yang direkomendasikan. 

Proses penyebaran mencakup langkah-langkah berikut:
+ Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan.
+ Langkah 2: Simpan file konfigurasi agen yang direkomendasikan di Systems Manager Parameter Store.
+ Langkah 3: Instal CloudWatch agen pada satu atau lebih instance EC2 menggunakan tumpukan. CloudFormation 
+ Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar.

### Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan
<a name="Solution-JVM-Agent-Step1"></a>

Anda harus memberikan izin kepada Systems Manager untuk menginstal dan mengkonfigurasi CloudWatch agen. Anda juga harus memberikan izin kepada CloudWatch agen untuk mempublikasikan telemetri dari instans EC2 Anda ke. CloudWatch Pastikan bahwa peran IAM yang dilampirkan pada instance memiliki kebijakan SSMManaged InstanceCore IAM **CloudWatchAgentServerPolicy**dan **Amazon** yang dilampirkan.
+ Setelah peran dibuat, lampirkan peran ke instans EC2 Anda. Ikuti langkah-langkah dalam [Luncurkan instance dengan peran IAM untuk melampirkan peran](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#launch-instance-with-role) saat meluncurkan instans EC2 baru. Untuk melampirkan peran ke instans EC2 yang ada, ikuti langkah-langkah di [Lampirkan peran IAM ke instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#attach-iam-role).

### Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store
<a name="Solution-JVM-Agent-Step2"></a>

Parameter Store menyederhanakan pemasangan CloudWatch agen pada instans EC2 dengan menyimpan dan mengelola parameter konfigurasi dengan aman, menghilangkan kebutuhan akan nilai hard-code. Ini memastikan proses penyebaran yang lebih aman dan fleksibel, memungkinkan manajemen terpusat dan pembaruan konfigurasi yang lebih mudah di beberapa instance.

Gunakan langkah-langkah berikut untuk menyimpan file konfigurasi CloudWatch agen yang direkomendasikan sebagai parameter di Parameter Store.

**Untuk membuat file konfigurasi CloudWatch agen sebagai parameter**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dari panel navigasi, pilih **Manajemen Aplikasi**, **Parameter Store**.

1. Ikuti langkah-langkah ini untuk membuat parameter baru untuk konfigurasi.

   1. Pilih **Buat parameter**.

   1. Di kotak **Nama**, masukkan nama yang akan Anda gunakan untuk mereferensikan file konfigurasi CloudWatch agen di langkah selanjutnya. Misalnya, **AmazonCloudWatch-JVM-Configuration**.

   1. (Opsional) Dalam **Deskripsi** kotak, ketikkan deskripsi untuk parameter.

   1. Untuk **tingkat Parameter**, pilih **Standar**. 

   1. Untuk **Type**, pilih **String**.

   1. Untuk **tipe Data**, pilih **teks**.

   1. Di kotak **Nilai**, tempel blok JSON yang sesuai yang terdaftar di[Konfigurasi agen untuk host JVM](#Solution-JVM-Agent-Config). Pastikan untuk menyesuaikan nilai dimensi pengelompokan dan nomor port seperti yang dijelaskan.

   1. Pilih **Buat parameter**. 

### Langkah 3: Instal CloudWatch agen dan terapkan konfigurasi menggunakan CloudFormation templat
<a name="Solution-JVM-Agent-Step3"></a>

Anda dapat menggunakan AWS CloudFormation untuk menginstal agen dan mengonfigurasinya untuk menggunakan konfigurasi CloudWatch agen yang Anda buat di langkah sebelumnya.

**Untuk menginstal dan mengkonfigurasi CloudWatch agen untuk solusi ini**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw - agent-installation-template -1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja JVM berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**CWAgentInstallationStack**.

1. Di bagian **Parameter**, tentukan yang berikut ini:

   1. Untuk **CloudWatchAgentConfigSSM**, masukkan nama parameter Systems Manager untuk konfigurasi agen yang Anda buat sebelumnya, seperti**AmazonCloudWatch-JVM-Configuration**.

   1. Untuk memilih instance target, Anda memiliki dua opsi.

      1. Untuk **InstanceIds**, tentukan daftar instance IDs daftar instance yang dibatasi koma IDs di mana Anda ingin menginstal CloudWatch agen dengan konfigurasi ini. Anda dapat membuat daftar satu contoh atau beberapa contoh.

      1. Jika Anda menerapkan pada skala besar, Anda dapat menentukan **TagKey**dan yang sesuai **TagValue**untuk menargetkan semua instans EC2 dengan tag dan nilai ini. Jika Anda menentukan a **TagKey**, Anda harus menentukan yang sesuai **TagValue**. (Untuk grup Auto Scaling, tentukan **aws:autoscaling:groupName** **TagKey**dan tentukan nama grup Auto Scaling untuk digunakan ke semua **TagValue**instance dalam grup Auto Scaling.)

         Jika Anda menentukan parameter **InstanceIds**dan **TagKeys**parameter, **InstanceIds**akan diutamakan dan tag akan diabaikan.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**. 

Jika Anda ingin mengedit file templat terlebih dahulu untuk menyesuaikannya, pilih opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan berikut untuk mengunduh templat: [ https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw- agent-installation-template -1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json). 

**catatan**  
Setelah langkah ini selesai, parameter Systems Manager ini akan dikaitkan dengan CloudWatch agen yang berjalan dalam instance yang ditargetkan. Ini artinya bahwa:  
Jika parameter Systems Manager dihapus, agen akan berhenti.
Jika parameter Systems Manager diedit, perubahan konfigurasi akan secara otomatis berlaku untuk agen pada frekuensi terjadwal yaitu 30 hari secara default.
Jika Anda ingin segera menerapkan perubahan pada parameter Systems Manager ini, Anda harus menjalankan langkah ini lagi. Untuk informasi selengkapnya tentang asosiasi, lihat [Bekerja dengan asosiasi di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations.html).

### Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar
<a name="Solution-JVM-Agent-Step4"></a>

Anda dapat memverifikasi apakah CloudWatch agen diinstal dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running). Jika CloudWatch agen tidak diinstal dan berjalan, pastikan Anda telah mengatur semuanya dengan benar.
+ Pastikan Anda telah melampirkan peran dengan izin yang benar untuk instans EC2 seperti yang dijelaskan dalam. [Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan](#Solution-JVM-Agent-Step1)
+ Pastikan Anda telah mengkonfigurasi JSON dengan benar untuk parameter Systems Manager. Ikuti langkah-langkah di [Memecahkan masalah pemasangan agen dengan CloudWatch CloudFormation](Install-CloudWatch-Agent-New-Instances-CloudFormation.md#CloudWatch-Agent-CloudFormation-troubleshooting).

Jika semuanya diatur dengan benar, maka Anda akan melihat metrik JVM dipublikasikan. CloudWatch Anda dapat memeriksa CloudWatch konsol untuk memverifikasi bahwa mereka sedang dipublikasikan.

**Untuk memverifikasi bahwa metrik JVM sedang dipublikasikan ke CloudWatch**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pilih **Metrik**, **Semua Metrik**.

1. Pastikan Anda telah memilih Wilayah tempat Anda menerapkan solusi, dan pilih **Ruang nama khusus**,. **CWAgent**

1. Cari metrik yang disebutkan dalam[Konfigurasi agen untuk host JVM](#Solution-JVM-Agent-Config), seperti`jvm.memory.heap.used`. Jika Anda melihat hasil untuk metrik ini, maka metrik sedang dipublikasikan ke. CloudWatch

## Buat dasbor solusi JVM
<a name="Solution-JVM-Dashboard"></a>

Dasbor yang disediakan oleh solusi ini menyajikan metrik untuk Java Virtual Machine (JVM) yang mendasarinya untuk server. Ini menawarkan ikhtisar JVM dengan menggabungkan dan menyajikan metrik di semua contoh, memberikan ringkasan tingkat tinggi dari keadaan kesehatan dan operasional secara keseluruhan. Selain itu, dasbor menunjukkan rincian kontributor teratas (10 teratas per widget metrik) untuk setiap metrik. Ini membantu Anda mengidentifikasi outlier atau instance dengan cepat yang berkontribusi secara signifikan terhadap metrik yang diamati.

Dasbor solusi tidak menampilkan metrik EC2. Untuk melihat metrik EC2, Anda harus menggunakan dasbor otomatis EC2 untuk melihat metrik penjual EC2 dan menggunakan dasbor konsol EC2 untuk melihat metrik EC2 yang dikumpulkan oleh agen. CloudWatch Untuk informasi selengkapnya tentang dasbor otomatis untuk AWS layanan, lihat[Melihat CloudWatch dasbor untuk satu AWS layanan](CloudWatch_Automatic_Dashboards_Focus_Service.md).

Untuk membuat dasbor, Anda dapat menggunakan opsi berikut:
+ Gunakan CloudWatch konsol untuk membuat dasbor.
+ Gunakan AWS CloudFormation konsol untuk menyebarkan dasbor.
+ Unduh AWS CloudFormation infrastruktur sebagai kode dan integrasikan sebagai bagian dari otomatisasi integrasi berkelanjutan (CI) Anda.

Dengan menggunakan CloudWatch konsol untuk membuat dasbor, Anda dapat melihat pratinjau dasbor sebelum benar-benar membuat dan mengisi daya.

**catatan**  
 Dasbor yang dibuat dengan CloudFormation solusi ini menampilkan metrik dari Wilayah tempat solusi diterapkan. Pastikan untuk membuat CloudFormation tumpukan di Wilayah tempat metrik JVM Anda diterbitkan.   
Jika metrik CloudWatch agen dipublikasikan ke namespace yang berbeda dari `CWAgent` (misalnya, jika Anda telah menyediakan namespace yang disesuaikan), Anda harus mengubah CloudFormation konfigurasi untuk mengganti `CWAgent` dengan namespace khusus yang Anda gunakan.

**Untuk membuat dasbor melalui CloudWatch Konsol**
**catatan**  
Dasbor solusi saat ini menampilkan metrik terkait pengumpulan sampah hanya untuk G1 Garbage Collector, yang merupakan kolektor default untuk versi Java terbaru. Jika Anda menggunakan algoritma pengumpulan sampah yang berbeda, widget yang berkaitan dengan pengumpulan sampah kosong. Namun, Anda dapat menyesuaikan widget ini dengan mengubah CloudFormation templat dasbor dan menerapkan jenis pengumpulan sampah yang sesuai ke dimensi nama metrik terkait pengumpulan sampah. Misalnya, jika Anda menggunakan pengumpulan sampah paralel, ubah **name=\$1"G1 Young Generation\$1"** ke **name=\$1"Parallel GC\$1"** metrik jumlah pengumpulan sampah`jvm.gc.collections.count`.

1. Buka **Dasbor Buat CloudWatch ** Konsol menggunakan tautan ini: [ https://console.aws.amazon.com/cloudwatch/beranda? \$1dashboards? DashboardTemplate= 2&referrer=os-catalog JvmOnEc](https://console.aws.amazon.com/cloudwatch/home?#dashboards?dashboardTemplate=JvmOnEc2&referrer=os-catalog). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja JVM berjalan.

1. Masukkan nama dasbor, lalu pilih **Create Dashboard**.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **JVMDashboard-us-east-1**

1. Pratinjau dasbor dan pilih **Simpan** untuk membuat dasbor.

**Untuk membuat dasbor melalui CloudFormation**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/JVM\$1EC2/CloudWatch/CFN/v1.0.0/dashboard -template-1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/JVM_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja JVM berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**JVMDashboardStack**.

1. Di bagian **Parameter**, tentukan nama dasbor di bawah **DashboardName**parameter.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **JVMDashboard-us-east-1**

1. Akui kemampuan akses untuk transformasi di bawah **Kemampuan dan** transformasi. Perhatikan bahwa CloudFormation tidak menambahkan sumber daya IAM apa pun.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**. 

1. Setelah status tumpukan **CREATE\$1COMPLETE**, pilih tab **Resources** di bawah tumpukan yang dibuat dan kemudian pilih tautan di bawah **Physical ID** untuk pergi ke dasbor. Anda juga dapat mengakses dasbor di CloudWatch konsol dengan memilih **Dasbor** di panel navigasi kiri konsol, dan menemukan nama dasbor di bawah Dasbor **Kustom**.

Jika Anda ingin mengedit file templat untuk menyesuaikannya untuk tujuan apa pun, Anda dapat menggunakan opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan ini untuk mengunduh templat: [ https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/JVM\$1EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/JVM_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json). 

**catatan**  
Dasbor solusi saat ini menampilkan metrik terkait pengumpulan sampah hanya untuk G1 Garbage Collector, yang merupakan kolektor default untuk versi Java terbaru. Jika Anda menggunakan algoritma pengumpulan sampah yang berbeda, widget yang berkaitan dengan pengumpulan sampah kosong. Namun, Anda dapat menyesuaikan widget ini dengan mengubah CloudFormation templat dasbor dan menerapkan jenis pengumpulan sampah yang sesuai ke dimensi nama metrik terkait pengumpulan sampah. Misalnya, jika Anda menggunakan pengumpulan sampah paralel, ubah **name=\$1"G1 Young Generation\$1"** ke **name=\$1"Parallel GC\$1"** metrik jumlah pengumpulan sampah`jvm.gc.collections.count`. 

### Memulai dengan dasbor JVM
<a name="Solution-JVM-Dashboard-GetStarted"></a>

Berikut adalah beberapa tugas yang dapat Anda coba dengan dasbor JVM baru. Tugas-tugas ini memungkinkan Anda untuk memvalidasi bahwa dasbor berfungsi dengan benar dan memberi Anda beberapa pengalaman langsung menggunakannya untuk memantau grup proses JVM. Saat Anda mencobanya, Anda akan terbiasa dengan menavigasi dasbor dan menafsirkan metrik yang divisualisasikan.

**Pilih grup proses**

Gunakan daftar dropdown **Nama Grup Proses JVM** untuk memilih grup proses yang ingin Anda pantau. Dasbor secara otomatis diperbarui untuk menampilkan metrik untuk grup proses yang dipilih. Jika Anda memiliki beberapa aplikasi atau lingkungan Java, masing-masing mungkin direpresentasikan sebagai grup proses terpisah. Memilih grup proses yang sesuai memastikan bahwa Anda melihat metrik khusus untuk aplikasi atau lingkungan yang ingin Anda analisis.

**Tinjau penggunaan memori**

Dari bagian ikhtisar dasbor, temukan widget **Persentase Penggunaan Memori Tumpukan dan Persentase Penggunaan** **Memori Non-Heap**. Ini menunjukkan persentase memori heap dan non-heap yang digunakan di semua JVMs dalam grup proses yang dipilih. Persentase yang tinggi menunjukkan potensi tekanan memori yang dapat menyebabkan masalah kinerja atau `OutOfMemoryError` pengecualian. Anda juga dapat menelusuri penggunaan heap oleh host di bawah **Penggunaan memori oleh host** untuk memeriksa host dengan penggunaan tinggi.

**Menganalisis utas dan kelas yang dimuat**

Di bagian **Threads and Classes Loaded by Host**, temukan widget **Top 10 Threads Count** dan **Top 10 Classes Loaded**. Carilah JVMs yang memiliki jumlah utas atau kelas yang sangat tinggi dibandingkan dengan yang lain. Terlalu banyak utas dapat menunjukkan kebocoran utas atau konkurensi yang berlebihan, sementara sejumlah besar kelas yang dimuat dapat menunjukkan potensi kebocoran pemuat kelas kelas atau pembangkitan kelas dinamis yang tidak efisien.

**Identifikasi masalah pengumpulan sampah**

**Di bagian **Pengumpulan Sampah**, temukan **10 Pemanggilan Pengumpulan Sampah Teratas Per Menit** dan **10 Widget Durasi Pengumpulan Sampah Teratas** untuk berbagai jenis pengumpul sampah: **Muda**, **Bersamaan, dan Campuran.**** Carilah JVMs yang memiliki jumlah koleksi yang luar biasa tinggi atau durasi koleksi yang panjang dibandingkan dengan yang lain. Ini bisa menunjukkan masalah konfigurasi atau kebocoran memori.

# CloudWatch solusi: Beban kerja NGINX di Amazon EC2
<a name="Solution-NGINX-On-EC2"></a>

Solusi ini membantu Anda mengonfigurasi pengumpulan out-of-the-box metrik menggunakan CloudWatch agen untuk aplikasi NGINX yang berjalan pada instans EC2. Untuk informasi umum tentang semua solusi CloudWatch observabilitas, lihat[CloudWatch solusi observabilitas](Monitoring-Solutions.md).

**Topics**
+ [Persyaratan](#Solution-NGINX-On-EC2-Requirements)
+ [Manfaat](#Solution-NGINX-On-EC2-Benefits)
+ [Biaya](#Solution-NGINX-On-EC2-Costs)
+ [CloudWatch konfigurasi agen untuk solusi ini](#Solution-NGINX-CloudWatch-Agent)
+ [Menyebarkan agen untuk solusi Anda](#Solution-NGINX-Agent-Deploy)
+ [Buat dasbor solusi NGINX](#Solution-NGINX-Dashboard)

## Persyaratan
<a name="Solution-NGINX-On-EC2-Requirements"></a>

Solusi ini relevan untuk kondisi berikut:
+ Versi yang didukung: NGINX versi 1.24
+ Hitung: Amazon EC2
+ Mendukung hingga 500 instans EC2 di semua beban kerja NGINX dalam satu Wilayah AWS
+ Versi terbaru dari CloudWatch agent
+ Prometheus Eksportir: nginxinc/ (lisensi Apache 2.0) nginx-prometheus-exporter 
+ Agen SSM diinstal pada instans EC2
**catatan**  
AWS Systems Manager (Agen SSM) sudah diinstal sebelumnya pada beberapa [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html) yang disediakan oleh AWS dan pihak ketiga tepercaya. Jika agen tidak diinstal, Anda dapat menginstalnya secara manual menggunakan prosedur untuk jenis sistem operasi Anda.  
 [Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) 
 [Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-macos.html) 
 [Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-windows.html) 

## Manfaat
<a name="Solution-NGINX-On-EC2-Benefits"></a>

Solusi ini memberikan pemantauan NGINX, memberikan wawasan berharga untuk kasus penggunaan berikut:
+ Tinjau metrik koneksi untuk mengidentifikasi potensi kemacetan, masalah koneksi, atau penggunaan yang tidak terduga.
+ Analisis volume permintaan HTTP untuk memahami beban lalu lintas keseluruhan pada NGINX.

Di bawah ini adalah keuntungan utama dari solusi ini:
+ Mengotomatiskan pengumpulan metrik untuk NGINX menggunakan konfigurasi CloudWatch agen, menghilangkan instrumentasi manual.
+ Menyediakan CloudWatch dasbor terkonsolidasi yang telah dikonfigurasi sebelumnya untuk metrik NGINX. Dasbor akan secara otomatis menangani metrik dari instans NGINX EC2 baru yang dikonfigurasi menggunakan solusi, bahkan jika metrik tersebut tidak ada saat Anda pertama kali membuat dasbor.

Gambar berikut adalah contoh dasbor untuk solusi ini.

![\[Contoh dasbor untuk solusi NGINX.\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/monitoring/images/NGINXDashboard.png)


## Biaya
<a name="Solution-NGINX-On-EC2-Costs"></a>

Solusi ini membuat dan menggunakan sumber daya di akun Anda. Anda dikenakan biaya untuk penggunaan standar, termasuk yang berikut:
+ Semua metrik yang dikumpulkan oleh CloudWatch agen untuk solusi ini dipublikasikan ke CloudWatch Log menggunakan Embedded Metric Format (EMF). CloudWatch Log ini dibebankan berdasarkan volume dan periode retensi mereka. Oleh karena itu, Anda tidak akan ditagih untuk panggilan **PutMetricData**API apa pun untuk solusi ini. Metrik yang diekstraksi dan dicerna dari log Anda dikenakan biaya sebagai metrik khusus. Jumlah metrik yang digunakan oleh solusi ini tergantung pada jumlah host EC2.
  + Setiap host NGINX EC2 yang dikonfigurasi untuk solusi menerbitkan total delapan metrik.
+ Satu dasbor khusus.

Untuk informasi selengkapnya tentang CloudWatch harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/).

Kalkulator harga dapat membantu Anda memperkirakan perkiraan biaya bulanan untuk menggunakan solusi ini.

**Untuk menggunakan kalkulator harga untuk memperkirakan biaya solusi bulanan Anda**

1. Buka [kalkulator CloudWatch harga Amazon](https://calculator.aws/#/createCalculator/CloudWatch).

1. Untuk **Pilih Wilayah**, pilih Wilayah AWS tempat Anda ingin menerapkan solusi.

1. Di bagian **Metrik**, untuk **Jumlah metrik, masukkan**. **8 \$1 number of EC2 instances configured for this solution**

1. Di bagian **Log**, untuk **Log Standar: Data Tertelan**, masukkan perkiraan volume log harian yang dihasilkan oleh CloudWatch Agen di semua host EC2. Misalnya, lima instans EC2 menghasilkan kurang dari 1000 byte per hari. Setelah diatur, Anda dapat memeriksa penggunaan byte Anda menggunakan ` IncomingBytes` metrik, yang dijual oleh CloudWatch Log. Pastikan untuk memilih grup log yang sesuai.

1. Di bagian **Log**, untuk **Penyimpanan/Arsip Log (Log Standar dan Penjual), pilih.** **Yes to Store Logs: Assuming 1 month retention** Ubah nilai ini jika Anda memutuskan untuk membuat perubahan khusus pada periode retensi.

1. Di bagian **Dasbor dan Alarm**, untuk **Jumlah Dasbor**, masukkan. **1**

1. Anda dapat melihat perkiraan biaya bulanan Anda di bagian bawah kalkulator harga.

## CloudWatch konfigurasi agen untuk solusi ini
<a name="Solution-NGINX-CloudWatch-Agent"></a>

 CloudWatch Agen adalah perangkat lunak yang berjalan terus menerus dan mandiri di server Anda dan di lingkungan kontainer. Ini mengumpulkan metrik, log, dan jejak dari infrastruktur dan aplikasi Anda dan mengirimkannya ke dan CloudWatch X-Ray.

Untuk informasi lebih lanjut tentang CloudWatch agen, lihat[Kumpulkan metrik, log, dan jejak menggunakan agen CloudWatch](Install-CloudWatch-Agent.md).

Konfigurasi agen dalam solusi ini mengumpulkan satu set metrik untuk membantu Anda mulai memantau dan mengamati beban kerja NGINX Anda. CloudWatch Agen dapat dikonfigurasi untuk mengumpulkan lebih banyak metrik NGINX daripada tampilan dasbor secara default. Untuk daftar semua metrik NGINX yang dapat Anda kumpulkan, lihat [Metrik](https://github.com/nginxinc/nginx-prometheus-exporter?tab=readme-ov-file#exported-metrics) untuk NGINX OSS.

Sebelum mengonfigurasi CloudWatch agen, Anda harus terlebih dahulu mengonfigurasi NGINX untuk mengekspos metriknya. Kedua, Anda harus menginstal dan mengkonfigurasi eksportir metrik Prometheus pihak ketiga.

### Paparkan metrik NGINX
<a name="Solution-NGINX-Expose-Metrics"></a>

**catatan**  
 Perintah berikut adalah untuk Linux. Periksa [NGINX untuk halaman Windows untuk](https://nginx.org/en/docs/windows.html) perintah yang setara di Windows Server. 

Anda harus mengaktifkan `stub_status` modul terlebih dahulu. Tambahkan blok lokasi baru di file konfigurasi NGINX Anda. Tambahkan baris berikut di `server` blok Anda `nginx.conf` untuk mengaktifkan modul NGINX: `stub_status`

```
location /nginx_status { 
          stub_status on;
          allow 127.0.0.1; # Allow only localhost to access
          deny all; # Deny all other IPs
        }
```

Sebelum memuat ulang NGINX, validasi konfigurasi NGINX Anda:

```
sudo nginx -t
```

Perintah validasi ini membantu mencegah kesalahan yang tidak terduga, yang dapat menyebabkan situs web Anda rusak. Contoh berikut menunjukkan respons yang berhasil:

```
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
```

Setelah Anda berhasil memvalidasi konfigurasi yang diperbarui, muat ulang NGINX (tidak ada output yang diharapkan):

```
sudo systemctl reload nginx
```

Perintah ini menginstruksikan proses NGINX untuk memuat ulang konfigurasi. Reload lebih anggun dibandingkan dengan restart penuh. Muat ulang memulai proses pekerja baru dengan konfigurasi baru, dengan anggun mematikan proses pekerja lama.

Uji titik akhir status NGINX:

```
curl http://127.0.0.1/nginx_status
```

Contoh berikut menunjukkan respons yang berhasil:

```
Active connections: 1
server accepts handled requests
6 6 6
Reading: 0 Writing: 1 Waiting: 0
```

Contoh berikut menunjukkan respons kegagalan (tinjau langkah-langkah sebelumnya sebelum melanjutkan):

```
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
      <head>
          <title>The page is not found</title>
          ...
```

### Konfigurasikan eksportir metrik Prometheus
<a name="Solution-NGINX-Configure-Prometheus"></a>

[Unduh rilis eksportir NGINX Prometheus terbaru dari repositori resmi. GitHub ](https://github.com/nginxinc/nginx-prometheus-exporter/releases) Anda harus mengunduh biner yang relevan untuk platform Anda.

Contoh berikut menunjukkan perintah untuk AMD64:

```
cd /tmp
wget https://github.com/nginxinc/nginx-prometheus-exporter/releases/download/v1.3.0/nginx-prometheus-exporter_1.3.0_linux_amd64.tar.gz
tar -xzvf nginx-prometheus-exporter_1.3.0_linux_amd64.tar.gz
sudo cp nginx-prometheus-exporter /usr/local/bin/
rm /tmp/nginx-prometheus-exporter*
```

Jalankan eksportir Prometheus dan arahkan ke halaman status rintisan NGINX:

```
nohup /usr/local/bin/nginx-prometheus-exporter -nginx.scrape-uri http://127.0.0.1/nginx_status &>/dev/null &
```

Contoh berikut menunjukkan respon (ID pekerjaan latar belakang dan PID):

```
[1] 74699
```

### Uji titik akhir Prometheus NGINX
<a name="Solution-NGINX-Test-Prometheus"></a>

Validasi bahwa eksportir Prometheus NGINX telah mulai mengekspos metrik yang relevan:

```
curl http://localhost:port-number/metrics
```

Contoh berikut menunjukkan respons yang berhasil:

```
# HELP go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.
# TYPE go_gc_duration_seconds summary
go_gc_duration_seconds{quantile="0"} 0
go_gc_duration_seconds{quantile="0.25"} 0
...
# HELP nginx_connections_accepted Accepted client connections
# TYPE nginx_connections_accepted counter
nginx_connections_accepted 14
# HELP nginx_connections_active Active client connections
# TYPE nginx_connections_active gauge
nginx_connections_active 1
...
# TYPE promhttp_metric_handler_requests_total counter
promhttp_metric_handler_requests_total{code="200"} 1
promhttp_metric_handler_requests_total{code="500"} 0
promhttp_metric_handler_requests_total{code="503"} 0
```

### Konfigurasi agen untuk solusi ini
<a name="Solution-NGINX-Agent-Config-Intro"></a>

Metrik yang dikumpulkan oleh agen ditentukan dalam konfigurasi agen. Solusi ini menyediakan konfigurasi agen untuk mengumpulkan metrik yang direkomendasikan dengan dimensi yang sesuai untuk dasbor solusi.

Langkah-langkah untuk menerapkan solusi dijelaskan nanti di[Menyebarkan agen untuk solusi Anda](#Solution-NGINX-Agent-Deploy). Informasi berikut dimaksudkan untuk membantu Anda memahami cara menyesuaikan konfigurasi agen untuk lingkungan Anda.

Anda harus menyesuaikan beberapa bagian agen dan konfigurasi Prometheus untuk lingkungan Anda seperti nomor port yang digunakan oleh eksportir Prometheus.

Port yang digunakan oleh eksportir Prometheus dapat diverifikasi menggunakan perintah berikut:

```
sudo netstat -antp | grep nginx-prom
```

Contoh berikut menunjukkan respon (lihat nilai port 9113):

```
tcp6 0 0 :::9113 :::* LISTEN 76398/nginx-prometh
```

### Konfigurasi agen untuk host NGINX
<a name="Solution-NGINX-Agent-Config"></a>

 CloudWatch Agen dengan pemantauan Prometheus membutuhkan dua konfigurasi untuk mengikis metrik Prometheus. Setiap konfigurasi akan disimpan sebagai parameter terpisah di Parameter Store SSM, seperti yang dijelaskan nanti. [Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store](#Solution-NGINX-Agent-Step2)

[Konfigurasi pertama adalah untuk eksportir Prometheus, seperti yang didokumentasikan dalam dokumentasi scrape\$1config Prometheus.](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config) Konfigurasi kedua adalah untuk CloudWatch agen.

 **Konfigurasi Prometheus** 

Ganti *port-number* dengan port server Anda.

```
global:
  scrape_interval: 30s
  scrape_timeout: 10s
  
scrape_configs:
- job_name: 'nginx'
  metrics_path: /metrics
  static_configs:
    - targets: ['localhost:port-number']
  ec2_sd_configs:
    - port: port-number
  relabel_configs:
    - source_labels: ['__meta_ec2_instance_id']
      target_label: InstanceId
  metric_relabel_configs:
    - source_labels: ['__name__']
      regex: 'nginx_up|nginx_http_requests_total|nginx_connections_.*'
      action: keep
```

 **CloudWatch konfigurasi agen** 

Sesuai konfigurasi CloudWatch agen sebelumnya, metrik ini diterbitkan melalui CloudWatch Log menggunakan [format metrik tertanam (EMF](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)). Log ini dikonfigurasi untuk menggunakan grup log` nginx`. Anda dapat menyesuaikan *log\$1group\$1name* dengan nama berbeda yang mewakili CloudWatch log.

 Jika Anda menggunakan Windows Server, atur *prometheus\$1config\$1path* konfigurasi berikut ke`C:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\prometheus.yaml`. 

```
{
"agent": {
  "metrics_collection_interval": 60
},
"logs": {
  "metrics_collected": {
      "prometheus": {
          "log_group_name": "nginx",
          "prometheus_config_path": "/opt/aws/amazon-cloudwatch-agent/etc/prometheus.yaml",
          "emf_processor": {
              "metric_declaration_dedup": true,
              "metric_namespace": "CWAgent",
              "metric_declaration":[
                  {
                      "source_labels":["InstanceId"],
                      "metric_selectors":["nginx_up", "nginx_http_requests_total", "nginx_connections*"],
                      "dimensions": [["InstanceId"]]
                  }
              ]
          }
      }
  }
}
}
```

## Menyebarkan agen untuk solusi Anda
<a name="Solution-NGINX-Agent-Deploy"></a>

Ada beberapa pendekatan untuk menginstal CloudWatch agen, tergantung pada kasus penggunaan. Sebaiknya gunakan Systems Manager untuk solusi ini. Ini memberikan pengalaman konsol dan membuatnya lebih mudah untuk mengelola armada server yang dikelola dalam satu AWS akun. Petunjuk di bagian ini menggunakan Systems Manager dan ditujukan untuk saat Anda tidak menjalankan CloudWatch agen dengan konfigurasi yang ada. Anda dapat memeriksa apakah CloudWatch agen berjalan dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running).

Jika Anda sudah menjalankan CloudWatch agen di host EC2 tempat beban kerja diterapkan dan mengelola konfigurasi agen, Anda dapat melewati instruksi di bagian ini dan mengikuti mekanisme penerapan yang ada untuk memperbarui konfigurasi. Pastikan untuk menggabungkan CloudWatch agen baru dan konfigurasi Prometheus dengan konfigurasi yang ada, lalu terapkan konfigurasi gabungan. Jika Anda menggunakan Systems Manager untuk menyimpan dan mengelola konfigurasi CloudWatch agen, Anda dapat menggabungkan konfigurasi ke nilai parameter yang ada. Untuk informasi selengkapnya, lihat [Mengelola file konfigurasi CloudWatch agen](https://docs.aws.amazon.com/prescriptive-guidance/latest/implementing-logging-monitoring-cloudwatch/create-store-cloudwatch-configurations.html).

**catatan**  
Menggunakan Systems Manager untuk menerapkan konfigurasi CloudWatch agen berikut akan menggantikan atau menimpa konfigurasi CloudWatch agen yang ada pada instans EC2 Anda. Anda dapat memodifikasi konfigurasi ini agar sesuai dengan lingkungan unik atau kasus penggunaan Anda. Metrik yang ditentukan dalam konfigurasi adalah minimum yang diperlukan untuk dasbor yang disediakan solusinya.

Proses penyebaran mencakup langkah-langkah berikut:
+ Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan.
+ Langkah 2: Simpan file konfigurasi agen yang direkomendasikan di Systems Manager Parameter Store.
+ Langkah 3: Instal CloudWatch agen pada satu atau lebih instance EC2 menggunakan tumpukan. CloudFormation 
+ Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar.

### Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan
<a name="Solution-NGINX-Agent-Step1"></a>

Anda harus memberikan izin kepada Systems Manager untuk menginstal dan mengkonfigurasi CloudWatch agen. Anda harus memberikan izin kepada CloudWatch agen untuk mempublikasikan telemetri dari instans EC2 Anda ke. CloudWatch Anda juga harus memberikan akses baca CloudWatch agen EC2. Akses baca EC2 diperlukan agar EC2 InstanceId ditambahkan sebagai dimensi metrik. Persyaratan tambahan ini didorong oleh `prometheus.yaml` seperti yang dijelaskan di atas karena digunakan ` __meta_ec2_instance_id` melalui EC2 Service Discovery.

Pastikan bahwa peran IAM yang dilampirkan pada instans memiliki kebijakan EC2 ReadOnlyAccess IAM ** CloudWatchAgentServerPolicy**, **Amazon SSMManaged InstanceCore**, dan **Amazon** yang dilampirkan.
+ Setelah peran dibuat, lampirkan peran ke instans EC2 Anda. Untuk melampirkan peran ke instans EC2, ikuti langkah-langkah di [Lampirkan peran IAM ke instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/attach-iam-role.html).

### Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store
<a name="Solution-NGINX-Agent-Step2"></a>

Parameter Store menyederhanakan pemasangan CloudWatch agen pada instans EC2 dengan menyimpan dan mengelola parameter konfigurasi dengan aman, menghilangkan kebutuhan akan nilai hard-code. Ini memastikan proses penyebaran yang lebih aman dan fleksibel, memungkinkan manajemen terpusat dan pembaruan konfigurasi yang lebih mudah di beberapa instance.

Gunakan langkah-langkah berikut untuk menyimpan file konfigurasi CloudWatch agen yang direkomendasikan sebagai parameter di Parameter Store.

**Untuk membuat file konfigurasi CloudWatch agen sebagai parameter**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat NGINX berjalan.

1. Dari panel navigasi, pilih **Manajemen Aplikasi**, **Parameter Store**

1. Ikuti langkah-langkah ini untuk membuat parameter baru untuk konfigurasi.

   1. Pilih **Buat parameter**.

   1. Di kotak **Nama**, masukkan nama yang akan Anda gunakan untuk mereferensikan file konfigurasi CloudWatch agen di langkah selanjutnya. Misalnya, ** AmazonCloudWatch-NGINX-CloudWatchAgent-Configuration**.

   1. (Opsional) Dalam **Deskripsi** kotak, ketikkan deskripsi untuk parameter.

   1. Untuk **tingkat Parameter**, pilih **Standar**.

   1. Untuk **Type**, pilih **String**.

   1. Untuk **tipe Data**, pilih **teks**.

   1. Di kotak **Nilai**, tempel blok JSON yang sesuai yang terdaftar di[Konfigurasi agen untuk host NGINX](#Solution-NGINX-Agent-Config). Pastikan untuk menyesuaikan sesuai kebutuhan. Misalnya, yang relevan`log_group_name`. 

   1. Pilih **Buat parameter**.

**Untuk membuat file konfigurasi Prometheus sebagai parameter**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dari panel navigasi, pilih **Manajemen Aplikasi**, **Parameter Store**

1. Ikuti langkah-langkah ini untuk membuat parameter baru untuk konfigurasi.

   1. Pilih **Buat parameter**.

   1. Di kotak **Nama**, masukkan nama yang akan Anda gunakan untuk mereferensikan file konfigurasi di langkah selanjutnya. Misalnya, ** AmazonCloudWatch-NGINX-Prometheus-Configuration**.

   1. (Opsional) Dalam **Deskripsi** kotak, ketikkan deskripsi untuk parameter.

   1. Untuk **tingkat Parameter**, pilih **Standar**.

   1. Untuk **Type**, pilih **String**.

   1. Untuk **tipe Data**, pilih **teks**.

   1. Di kotak **Nilai**, tempel blok YAMM yang sesuai yang terdaftar di. [Konfigurasi agen untuk host NGINX](#Solution-NGINX-Agent-Config) Pastikan untuk menyesuaikan sesuai kebutuhan. Misalnya, nomor port yang relevan sesuai`targets`.

   1. Pilih **Buat parameter**.

### Langkah 3: Instal CloudWatch agen dan terapkan konfigurasi menggunakan CloudFormation templat
<a name="Solution-NGINX-Agent-Step3"></a>

Anda dapat menggunakan AWS CloudFormation untuk menginstal agen dan mengonfigurasinya untuk menggunakan konfigurasi CloudWatch agen yang Anda buat di langkah sebelumnya.

**Untuk menginstal dan mengkonfigurasi CloudWatch agen untuk solusi ini**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw - agent-installation-template-with -prometheus-config-1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-with-prometheus-config-1.0.0.json).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja NGINX berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti** CWAgentInstallationStack**.

1. Di bagian **Parameter**, tentukan yang berikut ini:

   1. Untuk **CloudWatchAgentConfigSSM**, masukkan nama AWS Systems Manager parameter untuk konfigurasi agen yang Anda buat sebelumnya, seperti** AmazonCloudWatch-NGINX-CloudWatchAgent-Configuration**.

   1. Untuk **PrometheusConfigSSM**, masukkan nama AWS Systems Manager parameter untuk konfigurasi agen yang Anda buat sebelumnya, seperti** AmazonCloudWatch-NGINX-Prometheus-Configuration**.

   1. Untuk memilih instance target, Anda memiliki dua opsi.

      1. Untuk **InstanceIds**, tentukan daftar instance IDs daftar instance yang dibatasi koma IDs di mana Anda ingin menginstal CloudWatch agen dengan konfigurasi ini. Anda dapat membuat daftar satu contoh atau beberapa contoh.

      1. Jika Anda menerapkan pada skala besar, Anda dapat menentukan ** TagKey**dan yang sesuai **TagValue**untuk menargetkan semua instans EC2 dengan tag dan nilai ini. Jika Anda menentukan a ** TagKey**, Anda harus menentukan yang sesuai **TagValue**. (Untuk grup Auto Scaling, tentukan **aws:autoscaling:groupName** **TagKey**dan tentukan nama grup Auto Scaling untuk digunakan ke semua **TagValue**instance dalam grup Auto Scaling.)

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**.

Jika Anda ingin mengedit file templat terlebih dahulu untuk menyesuaikannya, pilih opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan berikut untuk mengunduh templat: [https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw- agent-installation-template-with -prometheus-config-1.0.0.json]( https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-with-prometheus-config-1.0.0.json). 

**catatan**  
Setelah langkah ini selesai, parameter Systems Manager ini akan dikaitkan dengan CloudWatch agen yang berjalan dalam instance yang ditargetkan. Ini artinya bahwa:  
Jika parameter Systems Manager dihapus, agen akan berhenti.
Jika parameter Systems Manager diedit, perubahan konfigurasi akan secara otomatis berlaku untuk agen pada frekuensi terjadwal yaitu 30 hari secara default.
Jika Anda ingin segera menerapkan perubahan pada parameter Systems Manager ini, Anda harus menjalankan langkah ini lagi. Untuk informasi selengkapnya tentang asosiasi, lihat [Bekerja dengan asosiasi di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations.html).

### Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar
<a name="Solution-NGINX-Agent-Step4"></a>

Anda dapat memverifikasi apakah CloudWatch agen diinstal dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running). Jika CloudWatch agen tidak diinstal dan berjalan, pastikan Anda telah mengatur semuanya dengan benar.
+ Pastikan Anda telah melampirkan peran dengan izin yang benar untuk instans EC2 seperti yang dijelaskan dalam. [Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan](#Solution-NGINX-Agent-Step1)
+ Pastikan Anda telah mengkonfigurasi JSON dengan benar untuk parameter Systems Manager. Ikuti langkah-langkah di [Memecahkan masalah pemasangan agen dengan CloudWatch CloudFormation](Install-CloudWatch-Agent-New-Instances-CloudFormation.md#CloudWatch-Agent-CloudFormation-troubleshooting).

Jika semuanya diatur dengan benar, maka Anda akan melihat metrik NGINX dipublikasikan. CloudWatch Anda dapat memeriksa CloudWatch konsol untuk memverifikasi bahwa mereka sedang dipublikasikan.

**Untuk memverifikasi bahwa metrik NGINX sedang dipublikasikan ke CloudWatch**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pilih **Metrik**, **Semua Metrik**.

1. Pastikan Anda telah memilih Wilayah tempat Anda menerapkan solusi, dan pilih **Ruang nama khusus**,. **CWAgent**

1. Cari metrik seperti`nginx_http_requests_total`. Jika Anda melihat hasil untuk metrik ini, maka metrik sedang dipublikasikan ke. CloudWatch

## Buat dasbor solusi NGINX
<a name="Solution-NGINX-Dashboard"></a>

Dasbor yang disediakan oleh solusi ini menyajikan metrik beban kerja NGINX dengan menggabungkan dan menyajikan metrik di semua instance. Dasbor menunjukkan rincian kontributor teratas (10 teratas per widget metrik) untuk setiap metrik. Ini membantu Anda mengidentifikasi outlier atau instance dengan cepat yang berkontribusi secara signifikan terhadap metrik yang diamati.

Untuk membuat dasbor, Anda dapat menggunakan opsi berikut:
+ Gunakan CloudWatch konsol untuk membuat dasbor.
+ Gunakan AWS CloudFormation konsol untuk menyebarkan dasbor.
+ Unduh AWS CloudFormation infrastruktur sebagai kode dan integrasikan sebagai bagian dari otomatisasi integrasi berkelanjutan (CI) Anda.

Dengan menggunakan CloudWatch konsol untuk membuat dasbor, Anda dapat melihat pratinjau dasbor sebelum benar-benar membuat dan mengisi daya.

**catatan**  
Dasbor yang dibuat dengan CloudFormation solusi ini menampilkan metrik dari Wilayah tempat solusi diterapkan. Pastikan untuk membuat CloudFormation tumpukan di Wilayah tempat metrik NGINX Anda diterbitkan.  
Jika Anda telah menentukan namespace khusus selain `CWAgent` dalam konfigurasi CloudWatch agen, Anda harus mengubah CloudFormation template untuk dasbor untuk diganti `CWAgent` dengan namespace khusus yang Anda gunakan.

**Untuk membuat dasbor melalui CloudWatch Konsol**

1. Buka **Dasbor Buat CloudWatch ** Konsol menggunakan tautan ini: [ https://console.aws.amazon.com/cloudwatch/beranda? \$1dashboards? DashboardTemplate= 2&referrer=os-catalog NginxOnEc](https://console.aws.amazon.com/cloudwatch/home?#dashboards?dashboardTemplate=NginxOnEc2&referrer=os-catalog). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja NGINX berjalan.

1. Masukkan nama dasbor, lalu pilih **Create Dashboard**.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **NGINXDashboard-us-east-1**

1. Pratinjau dasbor dan pilih **Simpan** untuk membuat dasbor.

**Untuk membuat dasbor melalui CloudFormation**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NGINX\$1EC2/CloudWatch/CFN/v1.0.0/dashboard -template-1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NGINX_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja NGINX berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti** NGINXDashboardStack**.

1. Di bagian **Parameter**, tentukan nama dasbor di bawah **DashboardName**parameter.

1. Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. ** NGINXDashboard-us-east-1**

1. Akui kemampuan akses untuk transformasi di bawah **Kemampuan dan** transformasi. Perhatikan bahwa CloudFormation tidak menambahkan sumber daya IAM apa pun.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**.

1. Setelah status tumpukan **CREATE\$1COMPLETE**, pilih tab **Resources** di bawah tumpukan yang dibuat dan kemudian pilih tautan di bawah **Physical ID** untuk pergi ke dasbor. Anda juga dapat mengakses dasbor di CloudWatch konsol dengan memilih **Dasbor** di panel navigasi kiri konsol, dan menemukan nama dasbor di bawah Dasbor **Kustom**.

Jika Anda ingin mengedit file templat terlebih dahulu untuk menyesuaikannya, pilih opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan berikut untuk mengunduh templat: [https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NGINX\$1EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json]( https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NGINX_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json). 

### Memulai dengan dasbor NGINX
<a name="Solution-NGINX-Dashboard-GetStarted"></a>

Berikut adalah beberapa tugas yang dapat Anda coba dengan dasbor NGINX baru. Tugas-tugas ini memungkinkan Anda untuk memvalidasi bahwa dasbor berfungsi dengan benar dan memberi Anda pengalaman langsung menggunakannya untuk memantau beban kerja NGINX. Saat Anda mencobanya, Anda akan terbiasa dengan menavigasi dasbor dan menafsirkan metrik yang divisualisasikan.

 **Tinjau metrik koneksi** 

Di bagian **Koneksi**, Anda dapat menemukan beberapa metrik utama yang memberikan wawasan tentang penanganan koneksi klien server NGINX Anda. Memantau metrik koneksi ini dapat membantu Anda mengidentifikasi potensi kemacetan, masalah koneksi, atau pola koneksi yang tidak terduga.
+ Koneksi klien yang diterima
+ Koneksi klien aktif
+ Koneksi klien yang ditangani
+ Koneksi membaca permintaan
+ Koneksi klien menganggur
+ Koneksi menulis tanggapan

 **Menganalisis volume permintaan HTTP** 

`request`Metrik di bagian **Permintaan HTTP** menunjukkan jumlah total permintaan HTTP yang ditangani oleh server NGINX. Melacak metrik ini dari waktu ke waktu dapat membantu Anda memahami beban lalu lintas keseluruhan pada infrastruktur NGINX Anda dan merencanakan alokasi dan penskalaan sumber daya yang sesuai.

# CloudWatch solusi: Beban kerja GPU NVIDIA di Amazon EC2
<a name="Solution-NVIDIA-GPU-On-EC2"></a>

Solusi ini membantu Anda mengonfigurasi pengumpulan out-of-the-box metrik menggunakan CloudWatch agen untuk beban kerja GPU NVIDIA yang berjalan pada instans EC2. Selain itu, ini membantu Anda mengatur CloudWatch dasbor yang telah dikonfigurasi sebelumnya. Untuk informasi umum tentang semua solusi CloudWatch observabilitas, lihat[CloudWatch solusi observabilitas](Monitoring-Solutions.md). 

**Topics**
+ [Persyaratan](#Solution-NVIDIA-GPU-On-EC2-Requirements)
+ [Manfaat](#Solution-NVIDIA-GPU-On-EC2-Benefits)
+ [CloudWatch konfigurasi agen untuk solusi ini](#Solution-NVIDIA-GPU-CloudWatch-Agent)
+ [Menyebarkan agen untuk solusi Anda](#Solution-NVIDIA-GPU-Agent-Deploy)
+ [Buat dasbor solusi GPU NVIDIA](#Solution-NVIDIA-GPU-Dashboard)

## Persyaratan
<a name="Solution-NVIDIA-GPU-On-EC2-Requirements"></a>

Solusi ini relevan untuk kondisi berikut:
+ Hitung: Amazon EC2
+ Mendukung hingga 500 GPU di semua instans EC2 dalam satu Wilayah AWS
+ Versi terbaru dari CloudWatch agent
+ Agen SSM diinstal pada instans EC2
+ Instans EC2 harus memiliki driver NVIDIA yang diinstal. Driver NVIDIA sudah diinstal sebelumnya pada beberapa Gambar Mesin Amazon (AMIs). Jika tidak, Anda dapat melakukan instalasi driver secara manual. Untuk informasi selengkapnya, silakan lihat [Install NVIDIA drivers pada instans Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/install-nvidia-driver.html).

**catatan**  
AWS Systems Manager (Agen SSM) sudah diinstal sebelumnya pada beberapa [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html) yang disediakan oleh AWS dan pihak ketiga tepercaya. Jika agen tidak diinstal, Anda dapat menginstalnya secara manual menggunakan prosedur untuk jenis sistem operasi Anda.  
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-macos.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-windows.html)

## Manfaat
<a name="Solution-NVIDIA-GPU-On-EC2-Benefits"></a>

Solusi ini memberikan pemantauan NVIDIA, memberikan wawasan berharga untuk kasus penggunaan berikut:
+ Analisis GPU dan penggunaan memori untuk kemacetan kinerja atau kebutuhan akan sumber daya tambahan.
+ Pantau suhu dan daya tarik untuk memastikan GPUs beroperasi dalam batas aman.
+ Evaluasi kinerja encoder untuk beban kerja video GPU.
+ Verifikasi PCIe konektivitas untuk generasi dan lebar yang diharapkan.
+ Pantau kecepatan clock GPU untuk mendeteksi masalah penskalaan dan pelambatan.

Di bawah ini adalah keuntungan utama dari solusi ini:
+ Mengotomatiskan pengumpulan metrik untuk NVIDIA menggunakan konfigurasi CloudWatch agen, menghilangkan instrumentasi manual.
+ Menyediakan CloudWatch dasbor terkonsolidasi yang telah dikonfigurasi sebelumnya untuk metrik NVIDIA. Dasbor akan secara otomatis menangani metrik dari instans NVIDIA EC2 baru yang dikonfigurasi menggunakan solusi, bahkan jika metrik tersebut tidak ada saat Anda pertama kali membuat dasbor.

Gambar berikut adalah contoh dasbor untuk solusi ini.

![\[Contoh dasbor untuk solusi GPU NVIDIA.\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/monitoring/images/NVIDIADashboard.png)


### Biaya
<a name="Solution-NVIDIA-GPU-On-EC2-Costs"></a>

Solusi ini membuat dan menggunakan sumber daya di akun Anda. Anda dikenakan biaya untuk penggunaan standar, termasuk yang berikut:
+ Semua metrik yang dikumpulkan oleh CloudWatch agen dikenakan biaya sebagai metrik khusus. Jumlah metrik yang digunakan oleh solusi ini tergantung pada jumlah host EC2.
  + Setiap host EC2 yang dikonfigurasi untuk solusi menerbitkan total 17 metrik per GPU.
+ Satu dasbor khusus.
+ Operasi API yang diminta oleh CloudWatch agen untuk mempublikasikan metrik. Dengan konfigurasi default untuk solusi ini, CloudWatch agen memanggil **PutMetricData**sekali setiap menit untuk setiap host EC2. Ini berarti **PutMetricData**API akan dipanggil `30*24*60=43,200` dalam bulan 30 hari untuk setiap host EC2.

Untuk informasi selengkapnya tentang CloudWatch harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/).

Kalkulator harga dapat membantu Anda memperkirakan perkiraan biaya bulanan untuk menggunakan solusi ini.

**Untuk menggunakan kalkulator harga untuk memperkirakan biaya solusi bulanan Anda**

1. Buka [kalkulator CloudWatch harga Amazon](https://calculator.aws/#/createCalculator/CloudWatch).

1. Untuk **Pilih Wilayah**, pilih Wilayah tempat Anda ingin menerapkan solusi.

1. Di bagian **Metrik**, untuk **Jumlah metrik, masukkan**. **17 \$1 average number of GPUs per EC2 host \$1 number of EC2 instances configured for this solution**

1. Di **APIs**bagian ini, untuk **Jumlah permintaan API**, masukkan**43200 \$1 number of EC2 instances configured for this solution**.

1. Secara default, CloudWatch agen melakukan satu **PutMetricData**operasi setiap menit untuk setiap host EC2.

1. Di bagian **Dasbor dan Alarm**, untuk **Jumlah Dasbor**, masukkan. **1**

1. Anda dapat melihat perkiraan biaya bulanan Anda di bagian bawah kalkulator harga.

## CloudWatch konfigurasi agen untuk solusi ini
<a name="Solution-NVIDIA-GPU-CloudWatch-Agent"></a>

 CloudWatch Agen adalah perangkat lunak yang berjalan terus menerus dan mandiri di server Anda dan di lingkungan kontainer. Ini mengumpulkan metrik, log, dan jejak dari infrastruktur dan aplikasi Anda dan mengirimkannya ke dan CloudWatch X-Ray.

Untuk informasi lebih lanjut tentang CloudWatch agen, lihat[Kumpulkan metrik, log, dan jejak menggunakan agen CloudWatch](Install-CloudWatch-Agent.md).

Konfigurasi agen dalam solusi ini mengumpulkan satu set metrik untuk membantu Anda mulai memantau dan mengamati GPU NVIDIA Anda. CloudWatch Agen dapat dikonfigurasi untuk mengumpulkan lebih banyak metrik GPU NVIDIA daripada tampilan dasbor secara default. Untuk daftar semua metrik GPU NVIDIA yang dapat Anda kumpulkan, lihat. [Kumpulkan metrik GPU NVIDIA](CloudWatch-Agent-NVIDIA-GPU.md)

### Konfigurasi agen untuk solusi ini
<a name="Solution-NVIDIA-GPU-Agent-Config"></a>

Metrik yang dikumpulkan oleh agen ditentukan dalam konfigurasi agen. Solusi ini menyediakan konfigurasi agen untuk mengumpulkan metrik yang direkomendasikan dengan dimensi yang sesuai untuk dasbor solusi.

Gunakan konfigurasi CloudWatch agen berikut pada instans EC2 dengan NVIDIA. GPUs Konfigurasi akan disimpan sebagai parameter di Penyimpanan Parameter SSM, seperti yang dijelaskan nanti. [Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store](#Solution-NVIDIA-GPU-Agent-Step2)

```
{
    "metrics": {
        "namespace": "CWAgent",
        "append_dimensions": {
            "InstanceId": "${aws:InstanceId}"
        },
        "metrics_collected": {
            "nvidia_gpu": {
                "measurement": [
                    "utilization_gpu",
                    "temperature_gpu",
                    "power_draw",
                    "utilization_memory",
                    "fan_speed",
                    "memory_total",
                    "memory_used",
                    "memory_free",
                    "pcie_link_gen_current",
                    "pcie_link_width_current",
                    "encoder_stats_session_count",
                    "encoder_stats_average_fps",
                    "encoder_stats_average_latency",
                    "clocks_current_graphics",
                    "clocks_current_sm",
                    "clocks_current_memory",
                    "clocks_current_video"
                ],
                "metrics_collection_interval": 60
            }
        }
    },
    "force_flush_interval": 60
}
```

## Menyebarkan agen untuk solusi Anda
<a name="Solution-NVIDIA-GPU-Agent-Deploy"></a>

Ada beberapa pendekatan untuk menginstal CloudWatch agen, tergantung pada kasus penggunaan. Sebaiknya gunakan Systems Manager untuk solusi ini. Ini memberikan pengalaman konsol dan membuatnya lebih mudah untuk mengelola armada server yang dikelola dalam satu AWS akun. Petunjuk di bagian ini menggunakan Systems Manager dan ditujukan untuk saat Anda tidak menjalankan CloudWatch agen dengan konfigurasi yang ada. Anda dapat memeriksa apakah CloudWatch agen berjalan dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running).

Jika Anda sudah menjalankan CloudWatch agen di host EC2 tempat beban kerja diterapkan dan mengelola konfigurasi agen, Anda dapat melewati instruksi di bagian ini dan mengikuti mekanisme penerapan yang ada untuk memperbarui konfigurasi. Pastikan untuk menggabungkan konfigurasi agen GPU NVIDIA dengan konfigurasi agen yang ada, lalu gunakan konfigurasi gabungan. Jika Anda menggunakan Systems Manager untuk menyimpan dan mengelola konfigurasi CloudWatch agen, Anda dapat menggabungkan konfigurasi ke nilai parameter yang ada. Untuk informasi selengkapnya, lihat [Mengelola file konfigurasi CloudWatch agen](https://docs.aws.amazon.com/prescriptive-guidance/latest/implementing-logging-monitoring-cloudwatch/create-store-cloudwatch-configurations.html).

**catatan**  
Menggunakan Systems Manager untuk menerapkan konfigurasi CloudWatch agen berikut akan menggantikan atau menimpa konfigurasi CloudWatch agen yang ada pada instans EC2 Anda. Anda dapat memodifikasi konfigurasi ini agar sesuai dengan lingkungan unik atau kasus penggunaan Anda. Metrik yang ditentukan dalam konfigurasi adalah minimum yang diperlukan untuk dasbor yang disediakan solusinya.

Proses penyebaran mencakup langkah-langkah berikut:
+ Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan.
+ Langkah 2: Simpan file konfigurasi agen yang direkomendasikan di Systems Manager Parameter Store.
+ Langkah 3: Instal CloudWatch agen pada satu atau lebih instance EC2 menggunakan tumpukan. CloudFormation 
+ Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar.

### Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan
<a name="Solution-NVIDIA-GPU-Agent-Step1"></a>

Anda harus memberikan izin kepada Systems Manager untuk menginstal dan mengkonfigurasi CloudWatch agen. Anda juga harus memberikan izin kepada CloudWatch agen untuk mempublikasikan telemetri dari instans EC2 Anda ke. CloudWatch Pastikan bahwa peran IAM yang dilampirkan pada instance memiliki kebijakan SSMManaged InstanceCore IAM **CloudWatchAgentServerPolicy**dan **Amazon** yang dilampirkan.
+ Setelah peran dibuat, lampirkan peran ke instans EC2 Anda. Untuk melampirkan peran ke instans EC2, ikuti langkah-langkah di [Lampirkan peran IAM ke instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/attach-iam-role.html).

### Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store
<a name="Solution-NVIDIA-GPU-Agent-Step2"></a>

Parameter Store menyederhanakan pemasangan CloudWatch agen pada instans EC2 dengan menyimpan dan mengelola parameter konfigurasi dengan aman, menghilangkan kebutuhan akan nilai hard-code. Ini memastikan proses penyebaran yang lebih aman dan fleksibel, memungkinkan manajemen terpusat dan pembaruan konfigurasi yang lebih mudah di beberapa instance.

Gunakan langkah-langkah berikut untuk menyimpan file konfigurasi CloudWatch agen yang direkomendasikan sebagai parameter di Parameter Store.

**Untuk membuat file konfigurasi CloudWatch agen sebagai parameter**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja GPU NVIDIA berjalan.

1. Dari panel navigasi, pilih **Manajemen Aplikasi**, **Parameter Store**.

1. Ikuti langkah-langkah ini untuk membuat parameter baru untuk konfigurasi.

   1. Pilih **Buat parameter**.

   1. Di kotak **Nama**, masukkan nama yang akan Anda gunakan untuk mereferensikan file konfigurasi CloudWatch agen di langkah selanjutnya. Misalnya, **AmazonCloudWatch-NVIDIA-GPU-Configuration**.

   1. (Opsional) Dalam **Deskripsi** kotak, ketikkan deskripsi untuk parameter.

   1. Untuk **tingkat Parameter**, pilih **Standar**.

   1. Untuk **Type**, pilih **String**.

   1. Untuk **tipe Data**, pilih **teks**.

   1. Di kotak **Nilai**, tempel blok JSON yang sesuai yang terdaftar di[Konfigurasi agen untuk solusi ini](#Solution-NVIDIA-GPU-Agent-Config).

   1. Pilih **Buat parameter**.

### Langkah 3: Instal CloudWatch agen dan terapkan konfigurasi menggunakan CloudFormation templat
<a name="Solution-NVIDIA-GPU-Agent-Step3"></a>

Anda dapat menggunakan AWS CloudFormation untuk menginstal agen dan mengonfigurasinya untuk menggunakan konfigurasi CloudWatch agen yang Anda buat di langkah sebelumnya.

**Untuk menginstal dan mengkonfigurasi CloudWatch agen untuk solusi ini**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw - agent-installation-template -1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja GPU NVIDIA berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**CWAgentInstallationStack**.

1. Di bagian **Parameter**, tentukan yang berikut ini:

   1. Untuk **CloudWatchAgentConfigSSM**, masukkan nama parameter Systems Manager untuk konfigurasi agen yang Anda buat sebelumnya, seperti**AmazonCloudWatch-NVIDIA-GPU-Configuration**.

   1. Untuk memilih instance target, Anda memiliki dua opsi.

      1. Untuk **InstanceIds**, tentukan daftar instance IDs daftar instance yang dibatasi koma IDs di mana Anda ingin menginstal CloudWatch agen dengan konfigurasi ini. Anda dapat membuat daftar satu contoh atau beberapa contoh.

      1. Jika Anda menerapkan pada skala besar, Anda dapat menentukan **TagKey**dan yang sesuai **TagValue**untuk menargetkan semua instans EC2 dengan tag dan nilai ini. Jika Anda menentukan a **TagKey**, Anda harus menentukan yang sesuai **TagValue**. (Untuk grup Auto Scaling, tentukan **aws:autoscaling:groupName** **TagKey**dan tentukan nama grup Auto Scaling untuk digunakan ke semua **TagValue**instance dalam grup Auto Scaling.)

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**.

Jika Anda ingin mengedit file templat terlebih dahulu untuk menyesuaikannya, pilih opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html).

**catatan**  
Setelah langkah ini selesai, parameter Systems Manager ini akan dikaitkan dengan CloudWatch agen yang berjalan dalam instance yang ditargetkan. Ini artinya bahwa:  
Jika parameter Systems Manager dihapus, agen akan berhenti.
Jika parameter Systems Manager diedit, perubahan konfigurasi akan secara otomatis berlaku untuk agen pada frekuensi terjadwal yaitu 30 hari secara default.
Jika Anda ingin segera menerapkan perubahan pada parameter Systems Manager ini, Anda harus menjalankan langkah ini lagi. Untuk informasi selengkapnya tentang asosiasi, lihat [Bekerja dengan asosiasi di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations.html).

### Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar
<a name="Solution-NVIDIA-GPU-Agent-Step4"></a>

Anda dapat memverifikasi apakah CloudWatch agen diinstal dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running). Jika CloudWatch agen tidak diinstal dan berjalan, pastikan Anda telah mengatur semuanya dengan benar.
+ Pastikan Anda telah melampirkan peran dengan izin yang benar untuk instans EC2 seperti yang dijelaskan dalam. [Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan](#Solution-NVIDIA-GPU-Agent-Step1)
+ Pastikan Anda telah mengkonfigurasi JSON dengan benar untuk parameter Systems Manager. Ikuti langkah-langkah di [Memecahkan masalah pemasangan agen dengan CloudWatch CloudFormation](Install-CloudWatch-Agent-New-Instances-CloudFormation.md#CloudWatch-Agent-CloudFormation-troubleshooting).

Jika semuanya diatur dengan benar, maka Anda akan melihat metrik GPU NVIDIA dipublikasikan ke. CloudWatch Anda dapat memeriksa CloudWatch konsol untuk memverifikasi bahwa mereka sedang dipublikasikan.

**Untuk memverifikasi bahwa metrik GPU NVIDIA sedang dipublikasikan ke CloudWatch**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pilih **Metrik**, **Semua Metrik**.

1. Pastikan Anda telah memilih Wilayah tempat Anda menerapkan solusi, dan pilih **Ruang nama khusus**,. **CWAgent**

1. Cari metrik yang disebutkan dalam[Konfigurasi agen untuk solusi ini](#Solution-NVIDIA-GPU-Agent-Config), seperti`nvidia_smi_utilization_gpu`. Jika Anda melihat hasil untuk metrik ini, maka metrik sedang dipublikasikan ke. CloudWatch

## Buat dasbor solusi GPU NVIDIA
<a name="Solution-NVIDIA-GPU-Dashboard"></a>

Dasbor yang disediakan oleh solusi ini menyajikan GPUs metrik NVIDIA dengan menggabungkan dan menyajikan metrik di semua instance. Dasbor menunjukkan rincian kontributor teratas (10 teratas per widget metrik) untuk setiap metrik. Ini membantu Anda mengidentifikasi outlier atau instance dengan cepat yang berkontribusi secara signifikan terhadap metrik yang diamati.

Untuk membuat dasbor, Anda dapat menggunakan opsi berikut:
+ Gunakan CloudWatch konsol untuk membuat dasbor.
+ Gunakan AWS CloudFormation konsol untuk menyebarkan dasbor.
+ Unduh AWS CloudFormation infrastruktur sebagai kode dan integrasikan sebagai bagian dari otomatisasi integrasi berkelanjutan (CI) Anda.

Dengan menggunakan CloudWatch konsol untuk membuat dasbor, Anda dapat melihat pratinjau dasbor sebelum benar-benar membuat dan mengisi daya.

**catatan**  
Dasbor yang dibuat dengan CloudFormation solusi ini menampilkan metrik dari Wilayah tempat solusi diterapkan. Pastikan untuk membuat CloudFormation tumpukan di Wilayah tempat metrik GPU NVIDIA Anda diterbitkan.  
Jika Anda telah menentukan namespace khusus selain CWAgent dalam konfigurasi CloudWatch agen, Anda harus mengubah CloudFormation template untuk dasbor untuk diganti CWAgent dengan namespace khusus yang Anda gunakan.

**Untuk membuat dasbor melalui CloudWatch Konsol**

1. Buka **Dasbor Buat CloudWatch ** Konsol menggunakan tautan ini: [ https://console.aws.amazon.com/cloudwatch/beranda? \$1dashboards? DashboardTemplate= 2&referrer=os-catalog NvidiaGpuOnEc](https://console.aws.amazon.com/cloudwatch/home?#dashboards?dashboardTemplate=NvidiaGpuOnEc2&referrer=os-catalog). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja GPU NVIDIA berjalan.

1. Masukkan nama dasbor, lalu pilih **Create Dashboard**.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **NVIDIA-GPU-Dashboard-us-east-1**

1. Pratinjau dasbor dan pilih **Simpan** untuk membuat dasbor.

**Untuk membuat dasbor melalui CloudFormation**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NVIDIA\$1GPU\$1EC2/CloudWatch/CFN/v1.0.0/dashboard -template-1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NVIDIA_GPU_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja GPU NVIDIA berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**NVIDIA-GPU-DashboardStack**.

1. Di bagian **Parameter**, tentukan nama dasbor di bawah **DashboardName**parameter.

1. Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **NVIDIA-GPU-Dashboard-us-east-1**

1. Akui kemampuan akses untuk transformasi di bawah **Kemampuan dan** transformasi. Perhatikan bahwa CloudFormation tidak menambahkan sumber daya IAM apa pun.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**.

1. Setelah status tumpukan **CREATE\$1COMPLETE**, pilih tab **Resources** di bawah tumpukan yang dibuat dan kemudian pilih tautan di bawah **Physical ID** untuk pergi ke dasbor. Anda juga dapat mengakses dasbor di CloudWatch konsol dengan memilih **Dasbor** di panel navigasi kiri konsol, dan menemukan nama dasbor di bawah Dasbor **Kustom**.

Jika Anda ingin mengedit file templat untuk menyesuaikannya untuk tujuan apa pun, Anda dapat menggunakan opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan ini untuk mengunduh templat: [ https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NVIDIA\$1GPU\$1EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/NVIDIA_GPU_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json).

### Memulai dengan dasbor GPU NVIDIA
<a name="Solution-NVIDIA-GPU-Dashboard-GetStarted"></a>

Berikut adalah beberapa tugas yang dapat Anda coba dengan dasbor GPU NVIDIA baru. Tugas-tugas ini memungkinkan Anda untuk memvalidasi bahwa dasbor berfungsi dengan benar dan memberi Anda pengalaman langsung menggunakannya untuk memantau NVIDIA Anda. GPUs Saat Anda mencobanya, Anda akan terbiasa dengan menavigasi dasbor dan menafsirkan metrik yang divisualisasikan.

**Tinjau pemanfaatan GPU**

Dari bagian **Utilisasi, temukan widget Pemanfaatan** **GPU dan Pemanfaatan** **Memori**. Ini menunjukkan persentase waktu GPU digunakan secara aktif untuk perhitungan dan persentase memori global yang dibaca atau ditulis, masing-masing. Pemanfaatan yang tinggi dapat menunjukkan potensi kemacetan kinerja atau kebutuhan akan sumber daya GPU tambahan.

**Menganalisis penggunaan memori GPU**

Di bagian **Memory**, temukan widget **Total Memory**, **Used Memory**, dan **Free Memory**. Ini memberikan wawasan tentang kapasitas memori keseluruhan GPUs dan berapa banyak memori yang saat ini dikonsumsi atau tersedia. Tekanan memori dapat menyebabkan masalah atau out-of-memory kesalahan kinerja, jadi penting untuk memantau metrik ini dan memastikan memori yang cukup tersedia untuk beban kerja Anda.

**Pantau suhu dan daya tarik**

Di bagian **Temperatur/Daya**, temukan widget **GPU Temperature** dan **Power Draw**. Metrik ini penting untuk memastikan bahwa Anda GPUs beroperasi dalam batas termal dan daya yang aman.

**Identifikasi kinerja encoder**

**Di bagian **Encoder**, temukan widget **Encoder Session Count**, **Average FPS, dan Average** Latency.** Metrik ini relevan jika Anda menjalankan beban kerja pengkodean video pada Anda. GPUs Pantau metrik ini untuk memastikan bahwa encoder Anda berkinerja optimal dan mengidentifikasi potensi kemacetan atau masalah kinerja.

**Periksa status PCIe tautan**

Di **PCIe**bagian ini, temukan widget **Pembuatan PCIe PCIe Tautan** **dan Lebar Tautan**. Metrik ini memberikan informasi tentang PCIe tautan yang menghubungkan GPU ke sistem host. Pastikan tautan beroperasi pada generasi dan lebar yang diharapkan untuk menghindari potensi keterbatasan kinerja karena PCIe kemacetan.

**Tinjau jam GPU**

Di bagian **Jam**, temukan widget **Jam Grafis**, **Jam SM**, **Jam Memori**, dan **Jam Video**. Metrik ini menunjukkan frekuensi operasi saat ini dari berbagai komponen GPU. Memantau jam ini dapat membantu mengidentifikasi potensi masalah dengan penskalaan jam GPU atau pelambatan frekuensi, yang dapat memengaruhi kinerja.

# CloudWatch solusi: Beban kerja Kafka di Amazon EC2
<a name="Solution-Kafka-On-EC2"></a>

Solusi ini membantu Anda mengonfigurasi pengumpulan out-of-the-box metrik menggunakan CloudWatch agen untuk beban kerja Kafka (broker, produsen, dan konsumen) yang berjalan pada instans EC2. Selain itu, ini membantu Anda mengatur CloudWatch dasbor yang telah dikonfigurasi sebelumnya. Untuk informasi umum tentang semua solusi CloudWatch observabilitas, lihat[CloudWatch solusi observabilitas](Monitoring-Solutions.md).

**Topics**
+ [Persyaratan](#Solution-Kafka-On-EC2-Requirements)
+ [Manfaat](#Solution-Kafka-On-EC2-Benefits)
+ [Biaya](#Solution-Kafka-On-EC2-Costs)
+ [CloudWatch konfigurasi agen untuk solusi ini](#Solution-Kafka-CloudWatch-Agent)
+ [Menyebarkan agen untuk solusi Anda](#Solution-Kafka-Agent-Deploy)
+ [Buat dasbor solusi Kafka](#Solution-Kafka-Dashboard)
+ [Konfigurasikan agen untuk beberapa peran Kafka pada instance yang sama](#Kafka-Multiple-Roles)

## Persyaratan
<a name="Solution-Kafka-On-EC2-Requirements"></a>

Solusi ini relevan untuk kondisi berikut:
+ Beban kerja: Kafka v0.8.2.x dan yang lebih baru
+ Hitung: Amazon EC2
+ Mendukung hingga 500 instans EC2 di semua beban kerja Kafka dalam waktu tertentu Wilayah AWS
+ Versi terbaru dari CloudWatch agent
+ Agen SSM diinstal pada instans EC2
**catatan**  
AWS Systems Manager (Agen SSM) sudah diinstal sebelumnya pada beberapa [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html) yang disediakan oleh AWS dan pihak ketiga tepercaya. Jika agen tidak diinstal, Anda dapat menginstalnya secara manual menggunakan prosedur untuk jenis sistem operasi Anda.  
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-macos.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-windows.html)

## Manfaat
<a name="Solution-Kafka-On-EC2-Benefits"></a>

Solusi ini memberikan pemantauan server Kafka, memberikan wawasan berharga untuk kasus penggunaan berikut:
+ Pantau kesehatan cluster Kafka melalui metrik replikasi dan sinkronisasi.
+ Lacak kinerja broker melalui kegagalan permintaan dan latensi bersama dengan lalu lintas jaringan.
+ Memantau producer/consumer kesalahan, latensi, dan kelambatan konsumen.
+ Analisis kinerja JVM yang mendasari untuk cluster Kafka.
+ Beralih di antara beberapa cluster Kafka, produsen, dan konsumen yang dikonfigurasi melalui solusi di bawah akun yang sama.

Di bawah ini adalah keuntungan utama dari solusi ini:
+ Mengotomatiskan pengumpulan metrik untuk Kafka dan JVM yang mendasarinya menggunakan konfigurasi CloudWatch agen, menghilangkan instrumentasi manual.
+ Menyediakan CloudWatch dasbor terkonsolidasi yang telah dikonfigurasi sebelumnya untuk metrik Kafka dan JVM. Dasbor akan secara otomatis menangani metrik dari instans Kafka EC2 baru yang dikonfigurasi menggunakan solusi, bahkan jika metrik tersebut tidak ada saat Anda pertama kali membuat dasbor. Ini juga memungkinkan Anda untuk mengelompokkan metrik ke dalam aplikasi logis untuk fokus dan manajemen yang lebih mudah.

Gambar berikut adalah contoh dasbor untuk solusi ini.

![\[Kafka klaster dashboard showing metrics for partitions, producer/consumer performance, and broker status.\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/monitoring/images/KafkaDashboard.png)


## Biaya
<a name="Solution-Kafka-On-EC2-Costs"></a>

Solusi ini membuat dan menggunakan sumber daya di akun Anda. Anda dikenakan biaya untuk penggunaan standar, termasuk yang berikut:
+ Semua metrik yang dikumpulkan oleh CloudWatch agen dikenakan biaya sebagai metrik khusus. Jumlah metrik yang digunakan oleh solusi ini tergantung pada jumlah host EC2.
  + Setiap host broker yang dikonfigurasi untuk solusi menerbitkan 33 metrik ditambah satu metrik (`disk_used_percent`) yang jumlah metrik untuk setiap host EC2 bergantung pada jumlah jalur disk untuk host tersebut.
  + Setiap host produsen yang dikonfigurasi untuk solusi menerbitkan tiga metrik dengan `topic` dimensi dan tiga metrik tanpa dimensi. `topic` Untuk metrik dengan `topic` dimensi, setiap topik dihitung sebagai metrik terpisah.
  + Setiap host konsumen yang dikonfigurasi untuk solusi menerbitkan dua metrik dengan `topic` dimensi dan tiga metrik tanpa dimensi. `topic` Untuk metrik dengan dimensi topik, setiap topik dihitung sebagai metrik terpisah.
+ Satu dasbor khusus.
+ Operasi API yang diminta oleh CloudWatch agen untuk mempublikasikan metrik. Dengan konfigurasi default untuk solusi ini, CloudWatch agen memanggil **PutMetricData**sekali setiap menit untuk setiap host EC2. Ini berarti **PutMetricData**API akan dipanggil `30*24*60=43,200` dalam bulan 30 hari untuk setiap host EC2.

Untuk informasi selengkapnya tentang CloudWatch harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/).

Kalkulator harga dapat membantu Anda memperkirakan perkiraan biaya bulanan untuk menggunakan solusi ini. 

**Untuk menggunakan kalkulator harga untuk memperkirakan biaya solusi bulanan Anda**

1. Buka [kalkulator CloudWatch harga Amazon](https://calculator.aws/#/createCalculator/CloudWatch).

1. Di bagian **Metrik**, untuk **Jumlah metrik, masukkan**. **broker\$1metrics\$1count \$1 producer\$1metrics\$1count \$1 consumer\$1metrics\$1count** Hitung ini sebagai berikut:
   + `broker_metrics_count`= (33\$1 jumlah rata-rata jalur disk per host EC2) \$1 number\$1of\$1ec2\$1broker\$1hosts 
   + `producer_metrics_count`= (3 \$1 rata-rata\$1number\$1of\$1topics\$1per\$1producer\$1host \$1 3) \$1 number\$1of\$1ec2\$1producer\$1hosts 
   + `consumer_metrics_count`= (2 \$1 rata-rata\$1number\$1of\$1topics\$1per\$1consumer\$1host \$1 3) \$1 number\$1of\$1ec2\$1consumer\$1hosts 

1. Di **APIs**bagian ini, untuk **Jumlah permintaan API**, masukkan**43200 \$1 number of EC2 instances configured for this solution**.

   Secara default, CloudWatch agen melakukan satu **PutMetricData**operasi setiap menit untuk setiap host EC2.

1. Di bagian **Dasbor dan Alarm**, untuk **Jumlah Dasbor**, masukkan. **1**

1. Anda dapat melihat perkiraan biaya bulanan Anda di bagian bawah kalkulator harga.

## CloudWatch konfigurasi agen untuk solusi ini
<a name="Solution-Kafka-CloudWatch-Agent"></a>

 CloudWatch Agen adalah perangkat lunak yang berjalan terus menerus dan mandiri di server Anda dan di lingkungan kontainer. Ini mengumpulkan metrik, log, dan jejak dari infrastruktur dan aplikasi Anda dan mengirimkannya ke dan CloudWatch X-Ray.

Untuk informasi lebih lanjut tentang CloudWatch agen, lihat[Kumpulkan metrik, log, dan jejak menggunakan agen CloudWatch](Install-CloudWatch-Agent.md).

Konfigurasi agen dalam solusi ini mengumpulkan metrik dasar untuk Kafka, JVM, dan EC2. CloudWatch Agen dapat dikonfigurasi untuk mengumpulkan lebih banyak metrik Kafka dan JVM daripada tampilan dasbor secara default. Untuk daftar semua metrik Kafka yang dapat Anda kumpulkan, lihat. [Kumpulkan metrik Kafka](CloudWatch-Agent-JMX-metrics.md#CloudWatch-Agent-Kafka-metrics) Untuk daftar semua metrik JVM yang dapat Anda kumpulkan, lihat. [Kumpulkan metrik JVM](CloudWatch-Agent-JMX-metrics.md#CloudWatch-Agent-JVM-metrics) Untuk daftar metrik EC2, lihat. [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS](metrics-collected-by-CloudWatch-agent.md#linux-metrics-enabled-by-CloudWatch-agent)

**Paparkan port JMX untuk peran broker, produsen, dan konsumen Kafka**

 CloudWatch Agen mengandalkan JMX untuk mengumpulkan metrik yang terkait dengan broker, produsen, dan konsumen Kafka. Untuk memungkinkan ini, Anda harus mengekspos port JMX di server dan aplikasi Anda.

Untuk broker Kafka, Anda harus menggunakan variabel `JMX_PORT` lingkungan untuk mengatur port. Anda harus me-restart broker setelah Anda mengatur variabel lingkungan ini. Tinjau skrip awal dan file konfigurasi aplikasi Anda untuk menemukan tempat terbaik untuk menambahkan argumen ini.

Misalnya, untuk sistem Linux dan macOS, Anda dapat menggunakan perintah berikut untuk mengatur port JMX. Pastikan untuk menentukan nomor port yang tidak digunakan.

```
export JMX_PORT=port-number
```

Untuk produsen dan konsumen Kafka, petunjuk untuk mengekspos port JMX bergantung pada jenis beban kerja yang Anda gunakan untuk aplikasi JVM produsen atau konsumen Anda. Lihat dokumentasi untuk aplikasi Anda untuk menemukan petunjuk ini.

Secara umum, untuk mengaktifkan port JMX untuk pemantauan dan manajemen, Anda akan mengatur properti sistem berikut untuk aplikasi JVM Anda. Contoh berikut mengatur JMX yang tidak diautentikasi. Jika keamanan Anda policies/requirements mengharuskan Anda mengaktifkan JMX dengan otentikasi kata sandi atau SSL untuk akses jarak jauh, lihat [dokumentasi JMX](https://docs.oracle.com/en/java/javase/17/management/monitoring-and-management-using-jmx-technology.html) untuk mengatur properti yang diperlukan.

```
-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port=port-number
-Dcom.sun.management.jmxremote.authenticate=false 
-Dcom.sun.management.jmxremote.ssl=false
```

Untuk memverifikasi port JMX, jalankan. `ps aux | grep jmxremote.port` Hasilnya harus menunjukkan bahwa port JMX diatur pada proses JVM.

**Konfigurasi agen untuk solusi ini**

Metrik yang dikumpulkan oleh agen ditentukan dalam konfigurasi agen. Solusi ini menyediakan konfigurasi agen untuk mengumpulkan metrik yang direkomendasikan dengan dimensi yang sesuai untuk dasbor solusi. Setiap peran Kafka, seperti broker, produsen, atau konsumen, memiliki konfigurasi agennya sendiri yang memungkinkan pengumpulan metrik Kafka dan metrik JVM dan EC2 yang mendasarinya.

Langkah-langkah untuk menerapkan solusi dijelaskan nanti di[Menyebarkan agen untuk solusi Anda](#Solution-Kafka-Agent-Deploy). Informasi berikut dimaksudkan untuk membantu Anda memahami cara menyesuaikan konfigurasi agen untuk lingkungan Anda.

Anda harus menyesuaikan beberapa bagian dari konfigurasi agen berikut untuk lingkungan Anda:
+ Nomor port JMX adalah nomor port yang Anda konfigurasikan di bagian sebelumnya dari dokumentasi ini. Nomor port ada di `endpoint` baris dalam konfigurasi.
+ `ClusterName`— Ini digunakan sebagai dimensi untuk metrik broker yang dikumpulkan. Berikan nama yang berarti yang mewakili pengelompokan cluster untuk instance yang menjalankan broker Kafka.
+ `ProcessGroupName`— Ini digunakan sebagai dimensi untuk metrik JVM yang dikumpulkan untuk broker. Berikan nilai yang sama seperti yang Anda berikan`ClusterName`. Ini memungkinkan melihat metrik JVM dari grup broker Kafka yang sama dengan metrik broker di dasbor solusi.
+ `ProducerGroupName`— Ini digunakan sebagai dimensi untuk metrik produsen yang dikumpulkan. Berikan nama yang berarti yang mewakili kelompok contoh produsen. Untuk nilai ini, Anda dapat menentukan aplikasi atau layanan produsen yang ingin Anda gunakan untuk tampilan gabungan metrik produsen di dasbor solusi.
+ `ConsumerGroupName`— Ini digunakan sebagai dimensi untuk metrik konsumen yang dikumpulkan. Berikan nama yang berarti yang mewakili kelompok contoh konsumen Ini tidak sama dengan konsep kelompok konsumen di Kafka. Ini hanyalah dimensi pengelompokan di mana Anda dapat menentukan aplikasi atau layanan konsumen yang ingin Anda gunakan untuk tampilan gabungan metrik konsumen di dasbor solusi 

Misalnya, jika Anda memiliki dua cluster Kafka yang berjalan di akun yang sama, satu untuk `order-processing` aplikasi dan satu lagi untuk `inventory-management` aplikasi, Anda harus mengatur `ProcessGroupName` dimensi `ClusterName` dan sesuai dalam konfigurasi agen dari instance broker.
+ Untuk instance broker `order-processing` cluster, atur `ClusterName=order-processing` dan`ProcessGroupName=order-processing`.
+ Untuk instance broker `inventory-management` cluster, atur `ClusterName=inventory-management` dan`ProcessGroupName=inventory-management`. 
+ Demikian pula, atur `ProducerGroupName` untuk instance produsen dan `ConsumerGroupName` untuk instance konsumen berdasarkan aplikasi masing-masing.

Ketika Anda mengatur dimensi di atas dengan benar, dasbor solusi akan secara otomatis mengelompokkan metrik berdasarkan`ClusterName`,`ProducerGroupName`, dan `ConsumerGroupName` dimensi. Dasbor akan menyertakan opsi dropdown untuk memilih dan melihat metrik untuk cluster dan grup tertentu, memungkinkan Anda memantau kinerja cluster dan grup individu secara terpisah.

Pastikan untuk menerapkan konfigurasi agen yang relevan ke instans EC2 yang benar. Setiap konfigurasi akan disimpan sebagai Parameter terpisah di Penyimpanan Parameter SSM, seperti yang dijelaskan nanti. [Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store](#Solution-Kafka-Agent-Step2)

Instruksi berikut menjelaskan situasi di mana peran produsen, konsumen, dan broker dikerahkan untuk memisahkan instans EC2, tanpa tumpang tindih. Jika Anda menjalankan beberapa peran Kafka pada instans EC2 yang sama, lihat [Konfigurasikan agen untuk beberapa peran Kafka pada instance yang sama](#Kafka-Multiple-Roles) untuk informasi selengkapnya.

### Konfigurasi agen untuk agen broker Kafka
<a name="Solution-Kafka-Agent-Broker"></a>

Gunakan konfigurasi CloudWatch agen berikut pada instans EC2 di mana agen broker Kafka dikerahkan. Ganti *ClusterName* dengan nama cluster yang akan digunakan untuk mengelompokkan metrik ini untuk tampilan terpadu. Nilai yang Anda tentukan *ClusterName* digunakan sebagai `ClusterName` dimensi dan `ProcessGroupName` dimensi. Ganti *port-number* dengan port JMX server Kafka Anda. Jika JMX diaktifkan dengan otentikasi kata sandi atau SSL untuk akses jarak jauh, lihat [Kumpulkan metrik Java Management Extensions (JMX)](CloudWatch-Agent-JMX-metrics.md) informasi tentang pengaturan TLS atau otorisasi sesuai kebutuhan.

Metrik EC2 yang ditampilkan dalam konfigurasi ini (konfigurasi ditampilkan di luar blok JMX) hanya berfungsi untuk instance Linux dan macOS. Jika Anda menggunakan instance Windows, Anda dapat memilih untuk menghilangkan metrik ini dalam konfigurasi. Untuk informasi tentang metrik yang dikumpulkan pada instance Windows, lihat. [Metrik yang dikumpulkan oleh CloudWatch agen pada instans Windows Server](metrics-collected-by-CloudWatch-agent.md#windows-metrics-enabled-by-CloudWatch-agent)

```
{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "kafka": {
            "measurement": [
              "kafka.request.time.avg",
              "kafka.request.failed",
              "kafka.request.count",
              "kafka.purgatory.size",
              "kafka.partition.under_replicated",
              "kafka.partition.offline",
              "kafka.network.io",
              "kafka.leader.election.rate",
              "kafka.isr.operation.count"
            ]
          },
          "append_dimensions": {
            "ClusterName": "ClusterName"
          }
        },
        {
          "endpoint": "localhost:port-number",
          "jvm": {
            "measurement": [
              "jvm.classes.loaded",
              "jvm.gc.collections.count",
              "jvm.gc.collections.elapsed",
              "jvm.memory.heap.committed",
              "jvm.memory.heap.max",
              "jvm.memory.heap.used",
              "jvm.memory.nonheap.committed",
              "jvm.memory.nonheap.max",
              "jvm.memory.nonheap.used",
              "jvm.threads.count"
            ]
          },
          "append_dimensions": {
            "ProcessGroupName": "ClusterName"
          }
        }
      ],
      "disk": {
        "measurement": [
          "used_percent"
        ]
      },
      "mem": {
        "measurement": [
          "used_percent"
        ]
      },
      "swap": {
        "measurement": [
          "used_percent"
        ]
      },
      "netstat": {
        "measurement": [
          "tcp_established",
          "tcp_time_wait"
        ]
      }
    }
  }
}
```

### Konfigurasi agen untuk produsen Kafka
<a name="Solution-Kafka-Agent-Producer"></a>

Gunakan konfigurasi CloudWatch agen berikut pada instans Amazon EC2 tempat produsen Kafka digunakan. Ganti *ProducerGroupName* dengan nama aplikasi atau grup yang ingin Anda gunakan untuk mengelompokkan metrik Anda untuk tampilan terpadu. Ganti *port-number* dengan port JMX aplikasi produsen Kafka Anda.

 Solusinya tidak mengaktifkan metrik JVM untuk produsen Kafka karena dasbor solusi tidak menampilkan metrik JVM yang terkait dengan JVM untuk produsen. Anda juga dapat menyesuaikan konfigurasi agen untuk memancarkan metrik JVM, namun metrik JVM yang terkait dengan produsen tidak terlihat di dasbor solusi.

```
{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "kafka-producer": {
            "measurement": [
              "kafka.producer.request-rate",
              "kafka.producer.byte-rate",
              "kafka.producer.request-latency-avg",
              "kafka.producer.response-rate",
              "kafka.producer.record-error-rate",
              "kafka.producer.record-send-rate"
            ]
          },
          "append_dimensions": {
            "ProducerGroupName": "ProducerGroupName"
          }
        }
      ]
    }
  }
}
```

### Konfigurasi agen untuk konsumen Kafka
<a name="Solution-Kafka-Agent-Consumer"></a>

Gunakan konfigurasi CloudWatch agen berikut pada instans EC2 tempat konsumen Kafka berjalan. Ganti *ConsumerGroupName* dengan nama aplikasi atau grup yang akan digunakan untuk mengelompokkan metrik ini untuk tampilan terpadu. Ganti *port-number* dengan port JMX aplikasi konsumen Kafka Anda.

Solusinya tidak mengaktifkan metrik JVM untuk konsumen Kafka karena dasbor solusi tidak menampilkan metrik JVM yang terkait dengan JVM untuk konsumen. Anda dapat menyesuaikan konfigurasi agen untuk memancarkan metrik JVM juga, namun metrik JVM yang terkait dengan konsumen tidak terlihat di dasbor solusi.

```
{
  "metrics": {
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "kafka-consumer": {
            "measurement": [
              "kafka.consumer.fetch-rate",
              "kafka.consumer.total.bytes-consumed-rate",
              "kafka.consumer.records-consumed-rate",
              "kafka.consumer.bytes-consumed-rate",
              "kafka.consumer.records-lag-max"
            ]
          },
          "append_dimensions": {
            "ConsumerGroupName": "ConsumerGroupName"
          }
        }
      ]
    }
  }
}
```

## Menyebarkan agen untuk solusi Anda
<a name="Solution-Kafka-Agent-Deploy"></a>

Ada beberapa pendekatan untuk menginstal CloudWatch agen, tergantung pada kasus penggunaan. Sebaiknya gunakan Systems Manager untuk solusi ini. Ini memberikan pengalaman konsol dan membuatnya lebih mudah untuk mengelola armada server yang dikelola dalam satu AWS akun. Petunjuk di bagian ini menggunakan Systems Manager dan ditujukan untuk saat Anda tidak menjalankan CloudWatch agen dengan konfigurasi yang ada. Anda dapat memeriksa apakah CloudWatch agen berjalan dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running).

Jika Anda sudah menjalankan CloudWatch agen di host EC2 tempat beban kerja diterapkan dan mengelola konfigurasi agen, Anda dapat melewati instruksi di bagian ini dan mengikuti mekanisme penerapan yang ada untuk memperbarui konfigurasi. Pastikan untuk menggabungkan konfigurasi agen sesuai dengan peran (broker, produsen, atau konsumen) dengan konfigurasi agen Anda yang ada, dan kemudian menerapkan konfigurasi gabungan. Jika Anda menggunakan Systems Manager untuk menyimpan dan mengelola konfigurasi CloudWatch agen, Anda dapat menggabungkan konfigurasi ke nilai parameter yang ada. Untuk informasi selengkapnya, lihat [Mengelola file konfigurasi CloudWatch agen](https://docs.aws.amazon.com/prescriptive-guidance/latest/implementing-logging-monitoring-cloudwatch/create-store-cloudwatch-configurations.html).

**catatan**  
Menggunakan Systems Manager untuk menerapkan konfigurasi CloudWatch agen berikut akan menggantikan atau menimpa konfigurasi CloudWatch agen yang ada pada instans EC2 Anda. Anda dapat memodifikasi konfigurasi ini agar sesuai dengan lingkungan unik atau kasus penggunaan Anda. Metrik yang ditentukan dalam solusi ini adalah minimum yang diperlukan untuk dasbor yang direkomendasikan. 

Proses penyebaran mencakup langkah-langkah berikut:
+ Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan.
+ Langkah 2: Simpan file konfigurasi agen yang direkomendasikan di Systems Manager Parameter Store.
+ Langkah 3: Instal CloudWatch agen pada satu atau lebih instance EC2 menggunakan tumpukan. CloudFormation 
+ Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar.

Anda harus mengulangi langkah-langkah ini berdasarkan apakah broker, produsen, dan konsumen Anda digunakan pada instans EC2 yang sama atau instans yang berbeda. Misalnya, jika broker, produsen, dan konsumen Kafka ditempatkan pada instance terpisah tanpa tumpang tindih, Anda harus mengulangi langkah-langkah ini tiga kali dengan konfigurasi agen yang sesuai untuk instans EC2 broker, produsen, dan konsumen.

### Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan
<a name="Solution-Kafka-Agent-Step1"></a>

Anda harus memberikan izin kepada Systems Manager untuk menginstal dan mengkonfigurasi CloudWatch agen. Anda juga harus memberikan izin kepada CloudWatch agen untuk mempublikasikan telemetri dari instans EC2 Anda ke. CloudWatch Pastikan bahwa peran IAM yang dilampirkan pada instance memiliki kebijakan SSMManaged InstanceCore IAM **CloudWatchAgentServerPolicy**dan **Amazon** yang dilampirkan.
+ Setelah peran dibuat, lampirkan peran ke instans EC2 Anda. Ikuti langkah-langkah dalam [Luncurkan instance dengan peran IAM untuk melampirkan peran](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#launch-instance-with-role) saat meluncurkan instans EC2 baru. Untuk melampirkan peran ke instans EC2 yang ada, ikuti langkah-langkah di [Lampirkan peran IAM ke instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#attach-iam-role).

### Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store
<a name="Solution-Kafka-Agent-Step2"></a>

Parameter Store menyederhanakan pemasangan CloudWatch agen pada instans EC2 dengan menyimpan dan mengelola parameter konfigurasi dengan aman, menghilangkan kebutuhan akan nilai hard-code. Ini memastikan proses penyebaran yang lebih aman dan fleksibel, memungkinkan manajemen terpusat dan pembaruan konfigurasi yang lebih mudah di beberapa instance.

Gunakan langkah-langkah berikut untuk menyimpan file konfigurasi CloudWatch agen yang direkomendasikan sebagai parameter di Parameter Store.

**Untuk membuat file konfigurasi CloudWatch agen sebagai parameter**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dari panel navigasi, pilih **Manajemen Aplikasi**, **Parameter Store**.

1. Ikuti langkah-langkah ini untuk membuat parameter baru untuk konfigurasi.

   1. Pilih **Buat parameter**.

   1. Berikan nama untuk parameter yang akan menyimpan konfigurasi CloudWatch agen Anda, seperti **AmazonCloudWatch-Kafka-Producer-Configuration** untuk produsen, **AmazonCloudWatch-Kafka-Consumer-Configuration** untuk konsumen, atau **AmazonCloudWatch-Kafka-Broker-Configuration** untuk broker. Jika Anda memiliki beberapa peran Kafka pada satu EC2, beri nama peran yang sesuai untuk identifikasi yang lebih mudah. Nilai ini nantinya akan digunakan untuk mendistribusikan konfigurasi ini ke agen yang berjalan pada instans EC2 Anda.

   1. Untuk **tingkat Parameter**, pilih **Standar**. 

   1. Untuk **Type**, pilih **String**.

   1. Untuk **tipe Data**, pilih **teks**.

   1. Di kotak **Nilai**, tempel teks lengkap konfigurasi CloudWatch agen. Pastikan untuk memilih blok JSON untuk peran Kafka yang dihosting instance ini. Lihat konfigurasi yang disediakan di[Konfigurasi agen untuk agen broker Kafka](#Solution-Kafka-Agent-Broker),[Konfigurasi agen untuk produsen Kafka](#Solution-Kafka-Agent-Producer), dan [Konfigurasi agen untuk konsumen Kafka](#Solution-Kafka-Agent-Consumer) saat menyimpan konfigurasi untuk broker, produsen, dan konsumen masing-masing. Jika Anda menjalankan beberapa peran Kafka pada instans EC2 yang sama, pastikan untuk menggabungkan konfigurasi jika diperlukan seperti yang dijelaskan [Konfigurasikan agen untuk beberapa peran Kafka pada instance yang sama](#Kafka-Multiple-Roles) pada instance yang sama

   1. Pilih **Buat parameter**. 

### Langkah 3: Instal CloudWatch agen dan terapkan konfigurasi menggunakan CloudFormation templat
<a name="Solution-Kafka-Agent-Step3"></a>

Anda dapat menggunakan AWS CloudFormation untuk menginstal agen dan mengonfigurasinya untuk menggunakan konfigurasi CloudWatch agen yang Anda buat di langkah sebelumnya.

**Untuk menginstal dan mengkonfigurasi CloudWatch agen untuk solusi ini**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw - agent-installation-template -1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja Kafka berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**CWAgentInstallationStack**.

1. Di bagian **Parameter**, tentukan yang berikut ini:

   1. Untuk **CloudWatchAgentConfigSSM**, masukkan nama parameter Systems Manager untuk konfigurasi agen yang Anda buat sebelumnya, seperti **AmazonCloudWatch-Kafka-Broker-Configuration** untuk broker, **AmazonCloudWatch-Kafka-Producer-Configuration** untuk produsen, dan **AmazonCloudWatch-Kafka-Consumer-Configuration** untuk konsumen.

   1. Untuk memilih instance target, Anda memiliki dua opsi.

      1. Untuk **InstanceIds**, tentukan daftar instance IDs daftar instance yang dibatasi koma IDs di mana Anda ingin menginstal CloudWatch agen dengan konfigurasi ini. Anda dapat membuat daftar satu contoh atau beberapa contoh.

      1. Jika Anda menerapkan pada skala besar, Anda dapat menentukan **TagKey**dan yang sesuai **TagValue**untuk menargetkan semua instans EC2 dengan tag dan nilai ini. Jika Anda menentukan a **TagKey**, Anda harus menentukan yang sesuai **TagValue**. (Untuk grup Auto Scaling, tentukan **aws:autoscaling:groupName** **TagKey**dan tentukan nama grup Auto Scaling untuk digunakan ke semua **TagValue**instance dalam grup Auto Scaling.)

         Jika Anda menentukan parameter **InstanceIds**dan **TagKeys**parameter, **InstanceIds**akan diutamakan dan tag akan diabaikan.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**. 

Jika Anda ingin mengedit file templat terlebih dahulu untuk menyesuaikannya, pilih opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan berikut untuk mengunduh templat: [https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw- agent-installation-template -1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json). 

**catatan**  
Setelah langkah ini selesai, parameter Systems Manager ini akan dikaitkan dengan CloudWatch agen yang berjalan dalam instance yang ditargetkan. Ini artinya bahwa:  
Jika parameter Systems Manager dihapus, agen akan berhenti.
Jika parameter Systems Manager diedit, perubahan konfigurasi akan secara otomatis berlaku untuk agen pada frekuensi terjadwal yaitu 30 hari secara default.
Jika Anda ingin segera menerapkan perubahan pada parameter Systems Manager ini, Anda harus menjalankan langkah ini lagi. Untuk informasi selengkapnya tentang asosiasi, lihat [Bekerja dengan asosiasi di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations.html).

### Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar
<a name="Solution-Kafka-Agent-Step4"></a>

Anda dapat memverifikasi apakah CloudWatch agen diinstal dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running). Jika CloudWatch agen tidak diinstal dan berjalan, pastikan Anda telah mengatur semuanya dengan benar.
+ Pastikan Anda telah melampirkan peran dengan izin yang benar untuk instans EC2 seperti yang dijelaskan dalam. [Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan](Solution-Tomcat-On-EC2.md#Solution-Tomcat-Agent-Step1)
+ Pastikan Anda telah mengkonfigurasi JSON dengan benar untuk parameter Systems Manager. Ikuti langkah-langkah di [Memecahkan masalah pemasangan agen dengan CloudWatch CloudFormation](Install-CloudWatch-Agent-New-Instances-CloudFormation.md#CloudWatch-Agent-CloudFormation-troubleshooting).

Jika semuanya diatur dengan benar, maka Anda akan melihat metrik Kafka dipublikasikan. CloudWatch Anda dapat memeriksa CloudWatch konsol untuk memverifikasi bahwa mereka sedang dipublikasikan.

**Untuk memverifikasi bahwa metrik Kafka sedang dipublikasikan ke CloudWatch**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pilih **Metrik**, **Semua Metrik**.

1. Pastikan Anda telah memilih Wilayah tempat Anda menerapkan solusi, dan pilih **Ruang nama khusus**,. **CWAgent**

1. Cari metrik yang disebutkan di bagian konfigurasi agen dari dokumen ini, seperti `kafka.partition.offline` untuk broker, `kafka.consumer.fetch.rate` untuk konsumen, atau `kafka.producer.request-rate` untuk produsen. Jika Anda melihat hasil untuk metrik ini, maka metrik sedang dipublikasikan ke. CloudWatch

## Buat dasbor solusi Kafka
<a name="Solution-Kafka-Dashboard"></a>

Dasbor ini menampilkan metrik yang baru dipancarkan untuk Kafka dan JVM yang mendasarinya. Dasbor ini memberikan tampilan kontributor teratas untuk kesehatan beban kerja Kafka Anda, di seluruh produsen, pialang, dan konsumen. Tampilan kontributor teratas menampilkan 10 teratas per widget metrik. Ini memungkinkan Anda untuk mengidentifikasi outlier secara sekilas. 

Dasbor solusi tidak menampilkan metrik EC2. Untuk melihat metrik EC2, Anda harus menggunakan dasbor otomatis EC2 untuk melihat metrik penjual EC2 dan menggunakan dasbor konsol EC2 untuk melihat metrik EC2 yang dikumpulkan oleh agen. CloudWatch Untuk informasi selengkapnya tentang dasbor otomatis untuk AWS layanan, lihat[Melihat CloudWatch dasbor untuk satu AWS layanan](CloudWatch_Automatic_Dashboards_Focus_Service.md).

Untuk membuat dasbor, Anda dapat menggunakan opsi berikut:
+ Gunakan CloudWatch konsol untuk membuat dasbor.
+ Gunakan AWS CloudFormation konsol untuk menyebarkan dasbor.
+ Unduh AWS CloudFormation infrastruktur sebagai kode dan integrasikan sebagai bagian dari otomatisasi integrasi berkelanjutan (CI) Anda.

Dengan menggunakan CloudWatch konsol untuk membuat dasbor, Anda dapat melihat pratinjau dasbor sebelum benar-benar membuat dan mengisi daya.

**catatan**  
Dasbor yang dibuat dengan CloudFormation solusi ini menampilkan metrik dari Wilayah tempat solusi diterapkan. Pastikan untuk membuat CloudFormation tumpukan di Wilayah tempat metrik JVM dan Kafka Anda diterbitkan.  
Jika Anda telah menentukan namespace khusus selain `CWAgent` dalam konfigurasi CloudWatch agen, Anda harus mengubah CloudFormation template untuk dasbor untuk diganti `CWAgent` dengan namespace khusus yang Anda gunakan.

**Untuk membuat dasbor melalui CloudWatch Konsol**
**catatan**  
Dasbor solusi saat ini menampilkan metrik terkait pengumpulan sampah hanya untuk G1 Garbage Collector, yang merupakan kolektor default untuk versi Java terbaru. Jika Anda menggunakan algoritma pengumpulan sampah yang berbeda, widget yang berkaitan dengan pengumpulan sampah kosong. Namun, Anda dapat menyesuaikan widget ini dengan mengubah CloudFormation templat dasbor dan menerapkan jenis pengumpulan sampah yang sesuai ke dimensi nama metrik terkait pengumpulan sampah. Misalnya, jika Anda menggunakan pengumpulan sampah paralel, ubah **name=\$1"G1 Young Generation\$1"** ke **name=\$1"Parallel GC\$1"** metrik jumlah pengumpulan sampah`jvm.gc.collections.count`.

1. Buka **Dasbor Buat CloudWatch ** Konsol menggunakan tautan ini: [ https://console.aws.amazon.com/cloudwatch/beranda? \$1dashboards? DashboardTemplate= 2&referrer=os-catalog ApacheKafkaOnEc](https://console.aws.amazon.com/cloudwatch/home?#dashboards?dashboardTemplate=ApacheKafkaOnEc2&referrer=os-catalog). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja Kafka berjalan.

1. Masukkan nama dasbor, lalu pilih **Create Dashboard**.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **KafkaDashboard-us-east-1**

1. Pratinjau dasbor dan pilih **Simpan** untuk membuat dasbor.

**Untuk membuat dasbor melalui CloudFormation**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Kafka\$1EC2/CloudWatch/CFN/v1.0.0/dashboard -template-1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Kafka_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja Kafka berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**KafkaDashboardStack**.

1. Di bagian **Parameter**, tentukan nama dasbor di bawah **DashboardName**parameter.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **KafkaDashboard-us-east-1**

1. Akui kemampuan akses untuk transformasi di bawah **Kemampuan dan** transformasi. Perhatikan bahwa CloudFormation tidak menambahkan sumber daya IAM apa pun.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**. 

1. Setelah status tumpukan **CREATE\$1COMPLETE**, pilih tab **Resources** di bawah tumpukan yang dibuat dan kemudian pilih tautan di bawah **Physical ID** untuk pergi ke dasbor. Anda juga dapat mengakses dasbor di CloudWatch konsol dengan memilih **Dasbor** di panel navigasi kiri konsol, dan menemukan nama dasbor di bawah Dasbor **Kustom**.

Jika Anda ingin mengedit file templat untuk menyesuaikannya untuk tujuan apa pun, Anda dapat menggunakan opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan ini untuk mengunduh templat: [https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Kafka\$1EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Kafka_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json). 

**catatan**  
Dasbor solusi saat ini menampilkan metrik terkait pengumpulan sampah hanya untuk G1 Garbage Collector, yang merupakan kolektor default untuk versi Java terbaru. Jika Anda menggunakan algoritma pengumpulan sampah yang berbeda, widget yang berkaitan dengan pengumpulan sampah kosong. Namun, Anda dapat menyesuaikan widget ini dengan mengubah CloudFormation templat dasbor dan menerapkan jenis pengumpulan sampah yang sesuai ke dimensi nama metrik terkait pengumpulan sampah. Misalnya, jika Anda menggunakan pengumpulan sampah paralel, ubah **name=\$1"G1 Young Generation\$1"** ke **name=\$1"Parallel GC\$1"** metrik jumlah pengumpulan sampah`jvm.gc.collections.count`. 

### Memulai dengan dasbor Kafka
<a name="Solution-Kafka-Dashboard-GetStarted"></a>

Berikut adalah beberapa tugas yang dapat Anda coba dengan dasbor Kafka baru. Tugas-tugas ini memungkinkan Anda untuk memvalidasi bahwa dasbor berfungsi dengan benar dan memberi Anda pengalaman langsung menggunakannya untuk memantau cluster Kafka. Saat Anda mencobanya, Anda akan terbiasa dengan menavigasi dasbor dan menafsirkan metrik yang divisualisasikan.

**Menggunakan daftar dropdown**

Dasbor menyediakan daftar dropdown di bagian atas yang dapat Anda gunakan untuk memfilter dan memilih cluster Kafka, produsen, dan grup konsumen tertentu yang ingin Anda pantau.
+ Untuk menampilkan metrik untuk cluster Kafka tertentu, pilih nama cluster tersebut di daftar dropdown **Kafka Cluster**. 
+ Untuk menampilkan metrik untuk grup produser Kafka tertentu, pilih nama grup produser tersebut di daftar dropdown **Produser Kafka**. 
+ Untuk menampilkan metrik untuk grup konsumen Kafka tertentu, pilih nama grup konsumen tersebut di daftar dropdown Grup **Konsumen Kafka**. 

**Verifikasi kesehatan cluster**

Dari bagian **Cluster Overview**, temukan widget **Partitions Under Replicated** and **In-Sync** Replicas. Ini idealnya nol atau angka kecil. Nilai besar untuk salah satu metrik ini dapat menunjukkan masalah dengan cluster Kafka yang perlu diselidiki. 

**Selidiki kinerja broker**

Di bagian **Broker**, temukan widget **Failed Fetch Requests** dan **Failed Producer Requests**. Ini menunjukkan jumlah permintaan gagal untuk mengambil dan menghasilkan operasi, masing-masing. Tingkat kegagalan yang tinggi dapat mengindikasikan masalah dengan broker atau konektivitas jaringan yang memerlukan penyelidikan lebih lanjut.

**Pantau kinerja produsen**

Di bagian **Ikhtisar Grup Produsen**, temukan widget Rasio **Permintaan Rata-Rata**, **Latensi Permintaan Rata-Rata**, dan Rasio **Rekaman Send/Error Rata-Rata**. Ini akan memberi Anda gambaran tentang bagaimana kinerja produsen dalam grup yang dipilih. Anda juga dapat menelusuri untuk melihat metrik untuk produsen dan topik tertentu di bagian **Produsen**.

**Pantau kelambatan konsumen**

Di bagian **Ikhtisar Grup Konsumen**, temukan widget **Consumer Lag**. Ini menunjukkan seberapa jauh di belakang konsumen dalam memproses pesan dari offset terbaru di partisi tempat mereka berlangganan. Idealnya, kelambatan konsumen harus rendah atau nol. Kelambatan konsumen yang tinggi dapat mengindikasikan bahwa konsumen tidak dapat mengikuti laju produksi data, yang menyebabkan potensi kehilangan data atau keterlambatan dalam pemrosesan. Anda juga dapat menelusuri untuk melihat metrik untuk konsumen dan topik tertentu di bagian **Konsumen**.

## Konfigurasikan agen untuk beberapa peran Kafka pada instance yang sama
<a name="Kafka-Multiple-Roles"></a>

Konfigurasi individual untuk peran Kafka yang tercantum dalam [CloudWatch konfigurasi agen untuk solusi ini](#Solution-Kafka-CloudWatch-Agent) berlaku hanya ketika peran produsen, konsumen, dan broker diterapkan pada instans EC2 terpisah, tanpa tumpang tindih. Jika Anda menjalankan beberapa peran Kafka pada instans Amazon EC2 yang sama, Anda memiliki dua opsi:
+ Buat file konfigurasi agen tunggal yang mencantumkan dan mengonfigurasi semua metrik untuk semua peran Kafka yang diterapkan pada instance itu. Jika Anda akan menggunakan Systems Manager untuk mengelola konfigurasi agen, ini adalah opsi yang lebih disukai.

  Jika Anda memilih opsi ini dan beberapa peran Kafka adalah bagian dari proses JVM yang sama, Anda harus menentukan titik akhir yang sama untuk setiap peran Kafka dalam konfigurasi agen. Jika beberapa peran Kafka merupakan bagian dari proses JVM yang berbeda, titik akhir untuk setiap peran dapat berbeda tergantung pada port JMX yang ditetapkan untuk proses itu.
+ Buat file konfigurasi agen terpisah untuk setiap peran Kafka, dan konfigurasikan agen untuk menerapkan kedua file konfigurasi. Untuk petunjuk penerapan beberapa file konfigurasi, lihat[Membuat beberapa file konfigurasi CloudWatch agen](create-cloudwatch-agent-configuration-file.md#CloudWatch-Agent-multiple-config-files).

Contoh berikut menunjukkan konfigurasi CloudWatch agen di mana peran produsen dan konsumen berjalan pada satu instance sebagai bagian dari proses JVM yang sama. Dalam hal ini, nomor port harus sama di bagian produsen dan konsumen dari konfigurasi di bawah ini. Jika sebaliknya dua peran berjalan sebagai bagian dari proses JVM yang berbeda, Anda dapat menentukan nomor port yang berbeda untuk masing-masing, sesuai dengan port JMX dari setiap proses JVM individu.

```
{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "kafka-producer": {
            "measurement": [
              "kafka.producer.request-rate",
              "kafka.producer.byte-rate",
              "kafka.producer.request-latency-avg",
              "kafka.producer.response-rate",
              "kafka.producer.record-error-rate",
              "kafka.producer.record-send-rate"
            ]
          },
          "append_dimensions": {
            "ProducerGroupName": "ProducerGroupName"
          }
        },
        {
          "endpoint": "localhost:port-number",
          "kafka-consumer": {
            "measurement": [
              "kafka.consumer.fetch-rate",
              "kafka.consumer.total.bytes-consumed-rate",
              "kafka.consumer.records-consumed-rate",
              "kafka.consumer.bytes-consumed-rate",
              "kafka.consumer.records-lag-max"
            ]
          },
          "append_dimensions": {
            "ConsumerGroupName": "ConsumerGroupName"
          }
        }
      ]
    }
  }
}
```

# CloudWatch solusi: Beban kerja Tomcat di Amazon EC2
<a name="Solution-Tomcat-On-EC2"></a>

Solusi ini membantu Anda mengonfigurasi pengumpulan out-of-the-box metrik menggunakan CloudWatch agen untuk server Tomcat yang berjalan pada instans EC2. Selain itu, ini membantu Anda mengatur CloudWatch dasbor yang telah dikonfigurasi sebelumnya. Untuk informasi umum tentang semua solusi CloudWatch observabilitas, lihat[CloudWatch solusi observabilitas](Monitoring-Solutions.md).

**Topics**
+ [Persyaratan](#Solution-Tomcat-On-EC2-Requirements)
+ [Manfaat](#Solution-Tomcat-On-EC2-Benefits)
+ [Biaya](#Solution-Tomcat-On-EC2-Costs)
+ [CloudWatch konfigurasi agen untuk solusi ini](#Solution-Tomcat-CloudWatch-Agent)
+ [Menyebarkan agen untuk solusi Anda](#Solution-Tomcat-Agent-Deploy)
+ [Buat dasbor solusi Tomcat](#Solution-Tomcat-Dashboard)

## Persyaratan
<a name="Solution-Tomcat-On-EC2-Requirements"></a>

Solusi ini relevan untuk kondisi berikut:
+ Versi yang didukung: Tomcat versi 9, 10.1, dan 11 (beta)
+ Hitung: Amazon EC2
+ Mendukung hingga 500 instans EC2 di semua beban kerja Tomcat dalam satu Wilayah AWS
+ Versi terbaru dari CloudWatch agent
+ Agen SSM diinstal pada instans EC2
**catatan**  
AWS Systems Manager (Agen SSM) sudah diinstal sebelumnya pada beberapa [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html) yang disediakan oleh AWS dan pihak ketiga tepercaya. Jika agen tidak diinstal, Anda dapat menginstalnya secara manual menggunakan prosedur untuk jenis sistem operasi Anda.  
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-macos.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-windows.html)

## Manfaat
<a name="Solution-Tomcat-On-EC2-Benefits"></a>

Solusi ini memberikan pemantauan server Tomcat, memberikan wawasan berharga untuk kasus penggunaan berikut:
+ Mendeteksi kesalahan server Tomcat dan masalah kinerja.
+ Pantau lalu lintas jaringan untuk masalah transfer data.
+ Lacak penggunaan thread dan sesi pengguna aktif.
+ Analisis kinerja JVM yang mendasari untuk server Tomcat.

Di bawah ini adalah keuntungan utama dari solusi ini:
+ Mengotomatiskan pengumpulan metrik untuk Apache Tomcat dan JVM yang mendasarinya menggunakan konfigurasi CloudWatch agen, menghilangkan instrumentasi manual.
+ Menyediakan CloudWatch dasbor terkonsolidasi yang telah dikonfigurasi sebelumnya untuk metrik Apache Tomcat dan JVM. Dasbor akan secara otomatis menangani metrik dari instans Tomcat EC2 baru yang dikonfigurasi menggunakan solusi, bahkan jika metrik tersebut tidak ada saat Anda pertama kali membuat dasbor. Ini juga memungkinkan Anda untuk mengelompokkan metrik ke dalam aplikasi logis untuk fokus dan manajemen yang lebih mudah.

Gambar berikut adalah contoh dasbor untuk solusi ini.

![\[Contoh dasbor untuk solusi Apache Tomcat.\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/monitoring/images/TomcatDashboard.png)


## Biaya
<a name="Solution-Tomcat-On-EC2-Costs"></a>

Solusi ini membuat dan menggunakan sumber daya di akun Anda. Anda dikenakan biaya untuk penggunaan standar, termasuk yang berikut:
+ Semua metrik yang dikumpulkan oleh CloudWatch agen dikenakan biaya sebagai metrik khusus. Jumlah metrik yang digunakan oleh solusi ini tergantung pada jumlah host EC2.
  + Setiap host Tomcat yang dikonfigurasi untuk solusi menerbitkan total 27 metrik ditambah satu metrik (`disk_used_percent`) yang jumlah metriknya bergantung pada jumlah jalur disk untuk host tersebut.
+ Satu dasbor khusus.
+ Operasi API yang diminta oleh CloudWatch agen untuk mempublikasikan metrik. Dengan konfigurasi default untuk solusi ini, CloudWatch agen memanggil **PutMetricData**sekali setiap menit. Ini berarti **PutMetricData**API akan dipanggil `30*24*60=43,200` dalam bulan 30 hari untuk setiap host EC2.

Untuk informasi selengkapnya tentang CloudWatch harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/).

Kalkulator harga dapat membantu Anda memperkirakan perkiraan biaya bulanan untuk menggunakan solusi ini. 

**Untuk menggunakan kalkulator harga untuk memperkirakan biaya solusi bulanan Anda**

1. Buka [kalkulator CloudWatch harga Amazon](https://calculator.aws/#/createCalculator/CloudWatch).

1. Di bagian **Metrik**, untuk **Jumlah metrik, masukkan**. **(27 \$1 average number of disk paths per EC2 host) \$1 number of EC2 instances configured for this solution**

1. Di **APIs**bagian ini, untuk **Jumlah permintaan API**, masukkan**43200 \$1 number of EC2 instances configured for this solution**.

   Secara default, solusi melakukan satu **PutMetricData**operasi setiap menit untuk setiap host EC2.

1. Di bagian **Dasbor dan Alarm**, untuk **Jumlah Dasbor**, masukkan. **1**

1. Anda dapat melihat perkiraan biaya bulanan Anda di bagian bawah kalkulator harga.

## CloudWatch konfigurasi agen untuk solusi ini
<a name="Solution-Tomcat-CloudWatch-Agent"></a>

 CloudWatch Agen adalah perangkat lunak yang berjalan terus menerus dan mandiri di server Anda dan di lingkungan kontainer. Ini mengumpulkan metrik, log, dan jejak dari infrastruktur dan aplikasi Anda dan mengirimkannya ke dan CloudWatch X-Ray.

Untuk informasi lebih lanjut tentang CloudWatch agen, lihat[Kumpulkan metrik, log, dan jejak menggunakan agen CloudWatch](Install-CloudWatch-Agent.md).

Konfigurasi agen dalam solusi ini mengumpulkan metrik dasar untuk Tomcat, JVM, dan EC2. CloudWatch Agen dapat dikonfigurasi untuk mengumpulkan lebih banyak metrik JVM daripada tampilan dasbor secara default. Untuk daftar semua metrik Tomcat yang dapat Anda kumpulkan, lihat. [Kumpulkan metrik Tomcat](CloudWatch-Agent-JMX-metrics.md#CloudWatch-Agent-Tomcat-metrics) Untuk daftar semua metrik JVM yang dapat Anda kumpulkan, lihat. [Kumpulkan metrik JVM](CloudWatch-Agent-JMX-metrics.md#CloudWatch-Agent-JVM-metrics) Untuk daftar metrik Amazon EC2, lihat. [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS](metrics-collected-by-CloudWatch-agent.md#linux-metrics-enabled-by-CloudWatch-agent)

**Paparkan port JMX untuk server Tomcat**

 CloudWatch Agen mengandalkan JMX untuk mengumpulkan metrik yang terkait dengan server Tomcat dan proses JVM. Untuk memungkinkan ini, Anda harus mengekspos port JMX dari server Anda. Untuk mengaktifkan port JMX untuk pemantauan dan manajemen, Anda akan mengatur properti sistem untuk server Tomcat Anda. Anda dapat menggunakan variabel lingkungan `CATALINA_OPTS ` untuk mengatur properti sistem yang diperlukan untuk Tomcat. Tinjau skrip startup dan file konfigurasi server Tomcat Anda di tempat terbaik untuk mengatur variabel lingkungan. Pastikan Anda menentukan nomor port yang tidak digunakan. Anda harus me-restart server setelah perubahan. 

```
export CATALINA_OPTS="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=<<port-number>> -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false"
```

Contoh ini mengatur JMX yang tidak diautentikasi. Jika keamanan Anda policies/requirements mengharuskan Anda mengaktifkan JMX dengan otentikasi kata sandi atau SSL untuk akses jarak jauh, lihat [dokumentasi JMX](https://docs.oracle.com/en/java/javase/17/management/monitoring-and-management-using-jmx-technology.html) untuk mengatur properti yang diperlukan.

Untuk memverifikasi port JMX, jalankan. `ps aux | grep jmxremote.port` Hasilnya harus menunjukkan bahwa port JMX diatur pada proses JVM.

### Konfigurasi agen untuk solusi Tomcat
<a name="Solution-Agent-Configuration-Tomcat-Solution"></a>

Metrik yang dikumpulkan oleh agen ditentukan dalam konfigurasi agen. Solusi ini menyediakan konfigurasi agen untuk mengumpulkan metrik yang direkomendasikan dengan dimensi yang sesuai untuk dasbor solusi.

Langkah-langkah untuk menerapkan solusi dijelaskan nanti di[Menyebarkan agen untuk solusi Anda](#Solution-Tomcat-Agent-Deploy). Informasi berikut dimaksudkan untuk membantu Anda memahami cara menyesuaikan konfigurasi agen untuk lingkungan Anda.

Anda harus menyesuaikan beberapa bagian dari konfigurasi agen berikut untuk lingkungan Anda:
+ Nomor port JMX adalah nomor port yang Anda konfigurasikan di bagian sebelumnya dari dokumentasi ini. Nomor port ada di `endpoint` baris dalam konfigurasi.
+ `AppName`— Ini digunakan sebagai dimensi untuk metrik aplikasi Tomcat yang dikumpulkan. Berikan nama bermakna yang mewakili pengelompokan untuk instance yang menjalankan aplikasi Tomcat.
+ `ProcessGroupName`— Ini digunakan sebagai dimensi untuk metrik JVM yang dikumpulkan untuk host Tomcat. Berikan nilai yang sama seperti `AppName` di atas. Ini untuk memungkinkan melihat metrik JVM dari grup aplikasi Tomcat yang sama dengan metrik server di bawah dasbor solusi.

Misalnya, jika Anda memiliki dua aplikasi Tomcat yang berjalan sama Akun AWS, satu untuk `billing-system` aplikasi dan satu lagi untuk `order-system` aplikasi, Anda dapat mengatur `ProcessGroupName` dimensi `AppName` dan sesuai dalam konfigurasi agen setiap instance.
+ Untuk instance `billing-system` aplikasi, atur `AppName=billing-system` dan`ProcessGroupName=billing-system`.
+ Untuk instance `order-system` aplikasi, atur `AppName=order-system` dan`ProcessGroupName=order-system`.

Ketika Anda mengikuti panduan ini, solusi akan secara otomatis mengelompokkan metrik berdasarkan `AppName` dan `ProcessGroupName` dimensi. Dasbor akan menyertakan opsi dropdown untuk memilih dan melihat metrik untuk aplikasi Tomcat tertentu, memungkinkan Anda untuk memantau kinerja masing-masing aplikasi secara terpisah.

### Konfigurasi agen untuk host Tomcat
<a name="Solution-Agent-Configuration-Tomcat-Host"></a>

Gunakan konfigurasi CloudWatch agen berikut pada instans EC2 tempat aplikasi Tomcat Anda digunakan. Konfigurasi akan disimpan sebagai parameter di Penyimpanan Parameter SSM, seperti yang dijelaskan nanti. [Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store](#Solution-Tomcat-Agent-Step2)

Ganti *AppName* dengan nama bermakna yang mewakili aplikasi Tomcat yang menjadi bagian dari instance. Ganti *port-number* dengan port JMX server Tomcat Anda. Jika JMX diaktifkan dengan otentikasi kata sandi atau SSL untuk akses jarak jauh, lihat [Kumpulkan metrik Java Management Extensions (JMX)](CloudWatch-Agent-JMX-metrics.md) informasi tentang pengaturan TLS atau otorisasi dalam konfigurasi agen sebagaimana diperlukan.

Metrik EC2 yang ditampilkan dalam konfigurasi ini (konfigurasi ditampilkan di luar blok JMX) hanya berfungsi untuk instance Linux dan macOS. Jika Anda menggunakan instance Windows, Anda dapat memilih untuk menghilangkan metrik ini dalam konfigurasi. Untuk informasi tentang metrik yang dikumpulkan pada instance Windows, lihat. [Metrik yang dikumpulkan oleh CloudWatch agen pada instans Windows Server](metrics-collected-by-CloudWatch-agent.md#windows-metrics-enabled-by-CloudWatch-agent)

```
{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "tomcat": {
            "measurement": [
              "tomcat.sessions",
              "tomcat.errors",
              "tomcat.processing_time",
              "tomcat.traffic",
              "tomcat.max_time",
              "tomcat.request_count",
              "tomcat.threads"
            ]
          },
          "append_dimensions": {
            "AppName": "AppName"
          }
        },
        {
          "endpoint": "localhost:port-number",
          "jvm": {
            "measurement": [
              "jvm.classes.loaded",
              "jvm.gc.collections.count",
              "jvm.gc.collections.elapsed",
              "jvm.memory.heap.committed",
              "jvm.memory.heap.max",
              "jvm.memory.heap.used",
              "jvm.memory.nonheap.committed",
              "jvm.memory.nonheap.max",
              "jvm.memory.nonheap.used",
              "jvm.threads.count"
            ]
          },
          "append_dimensions": {
            "ProcessGroupName": "AppName"
          }
        }
      ],
      "disk": {
        "measurement": [
          "used_percent"
        ]
      },
      "mem": {
        "measurement": [
          "used_percent"
        ]
      },
      "swap": {
        "measurement": [
          "used_percent"
        ]
      },
      "netstat": {
        "measurement": [
          "tcp_established",
          "tcp_time_wait"
        ]
      }
    }
  }
}
```

## Menyebarkan agen untuk solusi Anda
<a name="Solution-Tomcat-Agent-Deploy"></a>

Ada beberapa pendekatan untuk menginstal CloudWatch agen, tergantung pada kasus penggunaan. Sebaiknya gunakan Systems Manager untuk solusi ini. Ini memberikan pengalaman konsol dan membuatnya lebih mudah untuk mengelola armada server yang dikelola dalam satu AWS akun. Petunjuk di bagian ini menggunakan Systems Manager dan ditujukan untuk saat Anda tidak menjalankan CloudWatch agen dengan konfigurasi yang ada. Anda dapat memeriksa apakah CloudWatch agen berjalan dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running).

Jika Anda sudah menjalankan CloudWatch agen di host EC2 tempat aplikasi JVM digunakan dan mengelola konfigurasi agen, Anda dapat melewati instruksi di bagian ini dan mengikuti mekanisme penerapan yang ada untuk memperbarui konfigurasi. Pastikan untuk menggabungkan konfigurasi agen JVM dengan konfigurasi agen Anda yang ada, dan kemudian menerapkan konfigurasi gabungan. Jika Anda menggunakan Systems Manager untuk menyimpan dan mengelola konfigurasi CloudWatch agen, Anda dapat menggabungkan konfigurasi ke nilai parameter yang ada. Untuk informasi selengkapnya, lihat [Mengelola file konfigurasi CloudWatch agen](https://docs.aws.amazon.com/prescriptive-guidance/latest/implementing-logging-monitoring-cloudwatch/create-store-cloudwatch-configurations.html).

**catatan**  
Menggunakan Systems Manager untuk menerapkan konfigurasi CloudWatch agen berikut akan menggantikan atau menimpa konfigurasi CloudWatch agen yang ada pada instans EC2 Anda. Anda dapat memodifikasi konfigurasi ini agar sesuai dengan lingkungan unik atau kasus penggunaan Anda. Metrik yang ditentukan dalam solusi ini adalah minimum yang diperlukan untuk dasbor yang direkomendasikan. 

Proses penyebaran mencakup langkah-langkah berikut:
+ Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan.
+ Langkah 2: Simpan file konfigurasi agen yang direkomendasikan di Systems Manager Parameter Store.
+ Langkah 3: Instal CloudWatch agen pada satu atau lebih instance EC2 menggunakan tumpukan. CloudFormation 
+ Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar.

### Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan
<a name="Solution-Tomcat-Agent-Step1"></a>

Anda harus memberikan izin kepada Systems Manager untuk menginstal dan mengkonfigurasi CloudWatch agen. Anda juga harus memberikan izin kepada CloudWatch agen untuk mempublikasikan telemetri dari instans EC2 Anda ke. CloudWatch Pastikan bahwa peran IAM yang dilampirkan pada instance memiliki kebijakan SSMManaged InstanceCore IAM **CloudWatchAgentServerPolicy**dan **Amazon** yang dilampirkan.
+ Setelah peran dibuat, lampirkan peran ke instans EC2 Anda. Ikuti langkah-langkah dalam [Luncurkan instance dengan peran IAM untuk melampirkan peran](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#launch-instance-with-role) saat meluncurkan instans EC2 baru. Untuk melampirkan peran ke instans EC2 yang ada, ikuti langkah-langkah di [Lampirkan peran IAM ke instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#attach-iam-role).

### Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store
<a name="Solution-Tomcat-Agent-Step2"></a>

Parameter Store menyederhanakan pemasangan CloudWatch agen pada instans EC2 dengan menyimpan dan mengelola parameter konfigurasi dengan aman, menghilangkan kebutuhan akan nilai hard-code. Ini memastikan proses penyebaran yang lebih aman dan fleksibel, memungkinkan manajemen terpusat dan pembaruan konfigurasi yang lebih mudah di beberapa instance.

Gunakan langkah-langkah berikut untuk menyimpan file konfigurasi CloudWatch agen yang direkomendasikan sebagai parameter di Parameter Store.

**Untuk membuat file konfigurasi CloudWatch agen sebagai parameter**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dari panel navigasi, pilih **Manajemen Aplikasi**, **Parameter Store**.

1. Ikuti langkah-langkah ini untuk membuat parameter baru untuk konfigurasi.

   1. Pilih **Buat parameter**.

   1. Di kotak **Nama**, masukkan nama yang akan Anda gunakan untuk mereferensikan file konfigurasi CloudWatch agen di langkah selanjutnya. Misalnya, **AmazonCloudWatch-Tomcat-Configuration**.

   1. (Opsional) Dalam **Deskripsi** kotak, ketikkan deskripsi untuk parameter.

   1. Untuk **tingkat Parameter**, pilih **Standar**. 

   1. Untuk **Type**, pilih **String**.

   1. Untuk **tipe Data**, pilih **teks**.

   1. Di kotak **Nilai**, tempel blok JSON yang sesuai yang terdaftar di[Konfigurasi agen untuk host Tomcat](#Solution-Agent-Configuration-Tomcat-Host). Pastikan untuk menyesuaikan nilai dimensi pengelompokan dan nomor port seperti yang dijelaskan.

   1. Pilih **Buat parameter**. 

### Langkah 3: Instal CloudWatch agen dan terapkan konfigurasi menggunakan CloudFormation templat
<a name="Solution-Tomcat-Agent-Step3"></a>

Anda dapat menggunakan AWS CloudFormation untuk menginstal agen dan mengonfigurasinya untuk menggunakan konfigurasi CloudWatch agen yang Anda buat di langkah sebelumnya.

**Untuk menginstal dan mengkonfigurasi CloudWatch agen untuk solusi ini**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw - agent-installation-template -1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja Tomcat berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**CWAgentInstallationStack**.

1. Di bagian **Parameter**, tentukan yang berikut ini:

   1. Untuk **CloudWatchAgentConfigSSM**, masukkan nama parameter Systems Manager untuk konfigurasi agen yang Anda buat sebelumnya, seperti**AmazonCloudWatch-Tomcat-Configuration**.

   1. Untuk memilih instance target, Anda memiliki dua opsi.

      1. Untuk **InstanceIds**, tentukan daftar instance IDs daftar instance yang dibatasi koma IDs di mana Anda ingin menginstal CloudWatch agen dengan konfigurasi ini. Anda dapat membuat daftar satu contoh atau beberapa contoh.

      1. Jika Anda menerapkan pada skala besar, Anda dapat menentukan **TagKey**dan yang sesuai **TagValue**untuk menargetkan semua instans EC2 dengan tag dan nilai ini. Jika Anda menentukan a **TagKey**, Anda harus menentukan yang sesuai **TagValue**. (Untuk grup Auto Scaling, tentukan **aws:autoscaling:groupName** **TagKey**dan tentukan nama grup Auto Scaling untuk digunakan ke semua **TagValue**instance dalam grup Auto Scaling.)

         Jika Anda menentukan parameter **InstanceIds**dan **TagKeys**parameter, **InstanceIds**akan diutamakan dan tag akan diabaikan.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**. 

Jika Anda ingin mengedit file templat terlebih dahulu untuk menyesuaikannya, pilih opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan berikut untuk mengunduh templat: [ https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw- agent-installation-template -1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json). 

**catatan**  
Setelah langkah ini selesai, parameter Systems Manager ini akan dikaitkan dengan CloudWatch agen yang berjalan dalam instance yang ditargetkan. Ini artinya bahwa:  
Jika parameter Systems Manager dihapus, agen akan berhenti.
Jika parameter Systems Manager diedit, perubahan konfigurasi akan secara otomatis berlaku untuk agen pada frekuensi terjadwal yaitu 30 hari secara default.
Jika Anda ingin segera menerapkan perubahan pada parameter Systems Manager ini, Anda harus menjalankan langkah ini lagi. Untuk informasi selengkapnya tentang asosiasi, lihat [Bekerja dengan asosiasi di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations.html).

### Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar
<a name="Solution-Tomcat-Agent-Step4"></a>

Anda dapat memverifikasi apakah CloudWatch agen diinstal dengan mengikuti langkah-langkah di[Verifikasi bahwa CloudWatch agen sedang berjalan](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-troubleshooting-verify-running). Jika CloudWatch agen tidak diinstal dan berjalan, pastikan Anda telah mengatur semuanya dengan benar.
+ Pastikan Anda telah melampirkan peran dengan izin yang benar untuk instans EC2 seperti yang dijelaskan dalam. [Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan](#Solution-Tomcat-Agent-Step1)
+ Pastikan Anda telah mengkonfigurasi JSON dengan benar untuk parameter Systems Manager. Ikuti langkah-langkah di [Memecahkan masalah pemasangan agen dengan CloudWatch CloudFormation](Install-CloudWatch-Agent-New-Instances-CloudFormation.md#CloudWatch-Agent-CloudFormation-troubleshooting).

Jika semuanya diatur dengan benar, maka Anda akan melihat metrik Tomcat dipublikasikan. CloudWatch Anda dapat memeriksa CloudWatch konsol untuk memverifikasi bahwa mereka sedang dipublikasikan.

**Untuk memverifikasi bahwa metrik Tomcat sedang dipublikasikan ke CloudWatch**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pilih **Metrik**, **Semua Metrik**.

1. Pastikan Anda telah memilih Wilayah tempat Anda menerapkan solusi, dan pilih **Ruang nama khusus**,. **CWAgent**

1. Cari metrik yang disebutkan di bagian konfigurasi agen dokumen ini, seperti`tomcat.errors`. Jika Anda melihat hasil untuk metrik ini, maka metrik sedang dipublikasikan ke. CloudWatch

## Buat dasbor solusi Tomcat
<a name="Solution-Tomcat-Dashboard"></a>

Dasbor ini menampilkan metrik yang baru dipancarkan, menunjukkan server aplikasi Tomcat dan JVM yang mendasarinya. Dasbor ini memberikan tampilan kontributor teratas untuk kesehatan beban kerja Tomcat Anda. Tampilan kontributor teratas menampilkan 10 teratas per widget metrik. Ini memungkinkan Anda untuk mengidentifikasi outlier secara sekilas. Dasbor juga mencakup ikhtisar cluster dengan menggabungkan dan menyajikan metrik di semua instance, memberikan ringkasan tingkat tinggi tentang kesehatan dan keadaan operasional klaster secara keseluruhan.

Dasbor solusi tidak menampilkan metrik EC2. Untuk melihat metrik EC2, Anda harus menggunakan dasbor otomatis EC2 untuk melihat metrik penjual EC2 dan menggunakan dasbor konsol EC2 untuk melihat metrik EC2 yang dikumpulkan oleh agen. CloudWatch Untuk informasi selengkapnya tentang dasbor otomatis Layanan AWS, lihat[Melihat CloudWatch dasbor untuk satu AWS layanan](CloudWatch_Automatic_Dashboards_Focus_Service.md).

Untuk membuat dasbor, Anda dapat menggunakan opsi berikut:
+ Gunakan CloudWatch konsol untuk membuat dasbor.
+ Gunakan AWS CloudFormation konsol untuk menyebarkan dasbor.
+ Unduh AWS CloudFormation infrastruktur sebagai kode dan integrasikan sebagai bagian dari otomatisasi integrasi berkelanjutan (CI) Anda.

Dengan menggunakan CloudWatch konsol untuk membuat dasbor, Anda dapat melihat pratinjau dasbor sebelum benar-benar membuat dan mengisi daya.

**catatan**  
Dasbor yang dibuat dengan CloudFormation solusi ini menampilkan metrik dari Wilayah tempat solusi diterapkan. Pastikan untuk membuat CloudFormation tumpukan di Wilayah tempat metrik Tomcat Anda diterbitkan.  
Jika Anda telah menentukan namespace khusus selain `CWAgent` dalam konfigurasi CloudWatch agen, Anda harus mengubah CloudFormation template untuk dasbor untuk diganti `CWAgent` dengan namespace khusus yang Anda gunakan.

**Untuk membuat dasbor melalui CloudWatch Konsol**
**catatan**  
Dasbor solusi saat ini menampilkan metrik terkait pengumpulan sampah hanya untuk G1 Garbage Collector, yang merupakan kolektor default untuk versi Java terbaru. Jika Anda menggunakan algoritma pengumpulan sampah yang berbeda, widget yang berkaitan dengan pengumpulan sampah kosong. Namun, Anda dapat menyesuaikan widget ini dengan mengubah CloudFormation templat dasbor dan menerapkan jenis pengumpulan sampah yang sesuai ke dimensi nama metrik terkait pengumpulan sampah. Misalnya, jika Anda menggunakan pengumpulan sampah paralel, ubah **name=\$1"G1 Young Generation\$1"** ke **name=\$1"Parallel GC\$1"** metrik jumlah pengumpulan sampah`jvm.gc.collections.count`.

1. Buka **Dasbor Buat CloudWatch ** Konsol menggunakan tautan ini: [ https://console.aws.amazon.com/cloudwatch/beranda? \$1dashboards? DashboardTemplate= 2&referrer=os-catalog ApacheTomcatOnEc](https://console.aws.amazon.com/cloudwatch/home?#dashboards?dashboardTemplate=ApacheTomcatOnEc2&referrer=os-catalog). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja Tomcat berjalan.

1. Masukkan nama dasbor, lalu pilih **Create Dashboard**.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **TomcatDashboard-us-east-1**

1. Pratinjau dasbor dan pilih **Simpan** untuk membuat dasbor.

**Untuk membuat dasbor melalui CloudFormation**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Tomcat\$1EC2/CloudWatch/CFN/v1.0.0/dashboard -template-1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Tomcat_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat beban kerja Tomcat berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**TomcatDashboard-us-east-1**.

1. Di bagian **Parameter**, tentukan nama dasbor di bawah **DashboardName**parameter.

1. Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **TomcatDashboard-us-east-1**

1. Akui kemampuan akses untuk transformasi di bawah **Kemampuan dan** transformasi. Perhatikan bahwa CloudFormation tidak menambahkan sumber daya IAM apa pun.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**. 

1. Setelah status tumpukan **CREATE\$1COMPLETE**, pilih tab **Resources** di bawah tumpukan yang dibuat dan kemudian pilih tautan di bawah **Physical ID** untuk pergi ke dasbor. Anda juga dapat mengakses dasbor di CloudWatch konsol dengan memilih **Dasbor** di panel navigasi kiri konsol, dan menemukan nama dasbor di bawah Dasbor **Kustom**.

Jika Anda ingin mengedit file templat untuk menyesuaikannya untuk tujuan apa pun, Anda dapat menggunakan opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan ini untuk mengunduh templat: [https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Tomcat\$1EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Tomcat_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json). 

**catatan**  
Dasbor solusi saat ini menampilkan metrik terkait pengumpulan sampah hanya untuk G1 Garbage Collector, yang merupakan kolektor default untuk versi Java terbaru. Jika Anda menggunakan algoritma pengumpulan sampah yang berbeda, widget yang berkaitan dengan pengumpulan sampah kosong. Namun, Anda dapat menyesuaikan widget ini dengan mengubah CloudFormation templat dasbor dan menerapkan jenis pengumpulan sampah yang sesuai ke dimensi nama metrik terkait pengumpulan sampah. Misalnya, jika Anda menggunakan pengumpulan sampah paralel, ubah **name=\$1"G1 Young Generation\$1"** ke **name=\$1"Parallel GC\$1"** metrik jumlah pengumpulan sampah`jvm.gc.collections.count`. 

### Memulai dasbor pemantauan Tomcat
<a name="Solution-Tomcat-GetStarted"></a>

Berikut adalah beberapa tugas yang dapat Anda coba dengan dasbor Tomcat baru. Tugas-tugas ini memungkinkan Anda untuk memvalidasi bahwa dasbor berfungsi dengan benar dan memberi Anda pengalaman langsung menggunakannya untuk memantau aplikasi Tomcat. Saat Anda mencobanya, Anda akan terbiasa dengan menavigasi dasbor dan menafsirkan metrik yang divisualisasikan.

**Menggunakan daftar dropdown**

Dasbor menyediakan daftar dropdown di bagian atas yang dapat Anda gunakan untuk memfilter dan memilih aplikasi Tomcat tertentu yang ingin Anda pantau. Untuk menampilkan metrik untuk aplikasi Tomcat tertentu, pilih nama aplikasi tersebut di daftar dropdown **Aplikasi Tomcat**. 

**Verifikasi kesehatan aplikasi**

Dari bagian **Ikhtisar Aplikasi**, temukan widget **Permintaan**, **Kesalahan****, dan Tingkat Kesalahan**. Ini memberikan ringkasan tingkat tinggi dari kinerja penanganan permintaan aplikasi. Carilah jumlah atau tingkat kesalahan yang sangat tinggi, yang dapat mengindikasikan masalah yang perlu diselidiki.

**Memantau pemrosesan permintaan**

Di bagian **Request Processing Time**, temukan widget **Max Time** dan **Total Time to Process All Requests**. Metrik ini membantu Anda mengidentifikasi potensi kemacetan kinerja dalam pemrosesan permintaan. Cari server apa pun dengan waktu pemrosesan maks yang jauh lebih tinggi dibandingkan dengan yang lain. 

**Menganalisis lalu lintas jaringan**

Di bagian **Lalu Lintas Jaringan, temukan widget Lalu** Lintas **Terkirim dan Lalu Lintas** **yang Diterima**. Ini menunjukkan jumlah data yang dikirim dan diterima oleh aplikasi melalui jaringan. Tingkat lalu lintas yang tinggi secara tak terduga dapat mengindikasikan potensi masalah dengan saturasi jaringan atau transfer data yang tidak efisien.

**Selidiki penggunaan utas**

Di bagian **Sessions and Threads**, temukan widget **Busy Threads Count**, **Threads Count**, dan **Sessions**. Metrik ini memberikan wawasan tentang manajemen thread aplikasi dan sesi pengguna aktif. Cari server apa pun dengan jumlah utas atau sesi sibuk yang sangat tinggi, yang dapat menunjukkan potensi kendala sumber daya.

# CloudWatch solusi: Kesehatan Amazon EC2
<a name="Solution-EC2-Health"></a>

Solusi ini membantu Anda mengonfigurasi pengumpulan out-of-the-box metrik menggunakan CloudWatch agen untuk beban kerja yang berjalan pada instans EC2. Selain itu, ini membantu Anda mengatur CloudWatch dasbor yang telah dikonfigurasi sebelumnya.

**Topics**
+ [Persyaratan](#Solution-EC2-Health-Requirements)
+ [Manfaat](#Solution-EC2-Health-Benefits)
+ [Biaya](#Solution-EC2-Health-Costs)
+ [CloudWatch konfigurasi agen untuk solusi ini](#Solution-EC2-Health-Agent-Config)
+ [Menyebarkan agen untuk solusi Anda](#Solution-EC2-Health-Deploy)
+ [Buat dasbor solusi Kesehatan EC2](#Solution-EC2-Health-Dashboard)
+ [Memulai dasbor solusi Kesehatan EC2](#Solution-EC2-Health-Dashboard-Usage)

## Persyaratan
<a name="Solution-EC2-Health-Requirements"></a>

Solusi ini relevan untuk kondisi berikut:
+ Hitung: Amazon EC2
+ Platform: Linux dan macOS
+ Mendukung hingga 500 instans EC2 dalam satu Wilayah AWS
+ Versi terbaru dari CloudWatch agent
+ Agen SSM diinstal pada instans EC2
**catatan**  
AWS Systems Manager (Agen SSM) sudah diinstal sebelumnya pada beberapa [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html) yang disediakan oleh AWS dan pihak ketiga tepercaya. Jika agen tidak diinstal, Anda dapat menginstalnya secara manual menggunakan prosedur untuk jenis sistem operasi Anda.  
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-macos.html)
[Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-windows.html)

## Manfaat
<a name="Solution-EC2-Health-Benefits"></a>

Solusi ini memberikan pemantauan server EC2 menggunakan CloudWatch Agen, menyediakan metrik tingkat sistem tambahan di atas metrik namespace EC2 standar untuk kasus penggunaan berikut:
+ Mendeteksi masalah kinerja CPU dan kendala sumber daya.
+ Pantau pemanfaatan disk dan kapasitas penyimpanan di berbagai disk di seluruh instans EC2 Anda.
+ Lacak pola penggunaan memori dan potensi kebocoran memori.
+ Menganalisis I/O operasi dan dampaknya terhadap kinerja secara keseluruhan.
+ Amati pola lalu lintas jaringan dan potensi anomali.

Di bawah ini adalah keuntungan utama dari solusi ini:
+ Mengotomatiskan pengumpulan metrik untuk instans EC2 yang menghilangkan instrumentasi manual.
+ Menyediakan CloudWatch dasbor terkonsolidasi yang telah dikonfigurasi sebelumnya untuk metrik instans EC2. Dasbor akan secara otomatis menangani metrik dari instans EC2 baru yang dikonfigurasi menggunakan solusi, bahkan jika metrik tersebut tidak ada saat Anda pertama kali membuat dasbor. Ini juga memungkinkan Anda untuk mengamati instans EC2 yang dikelola melalui grup Auto Scaling.

Gambar berikut adalah contoh dasbor untuk solusi ini.

![\[Contoh dasbor EC2 Health\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/monitoring/images/EC2HealthDashboard.png)


## Biaya
<a name="Solution-EC2-Health-Costs"></a>

Solusi ini membuat dan menggunakan sumber daya di akun Anda. Anda dikenakan biaya untuk penggunaan standar, termasuk yang berikut:
+ Semua metrik yang dikumpulkan oleh CloudWatch agen dikenakan biaya sebagai metrik khusus. Jumlah metrik yang digunakan oleh solusi ini tergantung pada jumlah host EC2.

  Jumlah total metrik CloudWatch agen tergantung pada konfigurasi disk. Tidak termasuk metrik disk dan diskio, solusinya menerbitkan enam metrik. Jumlah metrik disk (`disk_used_percent`,`disk_inodes_free`) tergantung pada jumlah `device/fstype/path` dimensi. Metrik diskio (`diskio_io_time`) tergantung pada jumlah dimensi. `name` Misalnya, satu t2.micro dengan pengaturan default sesuai pengalaman konsol EC2, menghasilkan total 22 metrik CloudWatch agen (4 CPU, 12 disk, 4 disk, 1 memori, dan 1 swap). Metrik yang dijual seperti `AWS/EC2` disediakan secara gratis.
+ Satu dasbor khusus.
+ Operasi API yang diminta oleh CloudWatch agen untuk mempublikasikan metrik. Dengan konfigurasi default untuk solusi ini, CloudWatch agen memanggil **PutMetricData**sekali setiap menit. Ini berarti **PutMetricData**API akan dipanggil `30*24*60=43,200` dalam bulan 30 hari untuk setiap host EC2.

Untuk informasi selengkapnya tentang CloudWatch harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/).

Kalkulator harga dapat membantu Anda memperkirakan perkiraan biaya bulanan untuk menggunakan solusi ini.

**Untuk menggunakan kalkulator harga untuk memperkirakan biaya solusi bulanan Anda**

1. Buka [kalkulator CloudWatch harga Amazon](https://calculator.aws/#/createCalculator/CloudWatch).

1. Di bagian **Metrik**, untuk **Jumlah metrik, masukkan**. **(6 \$1 total count of disk and diskio metrics per EC2 host as described above) \$1 number of EC2 instances configured for this solution**

1. Di **APIs**bagian ini, untuk **Jumlah permintaan API**, masukkan**43200 \$1 number of EC2 instances configured for this solution**.

1. Secara default, solusi melakukan satu **PutMetricData**operasi setiap menit untuk setiap host EC2.

1. Di bagian **Dasbor dan Alarm**, untuk **Jumlah Dasbor**, masukkan. **1**

1. Anda dapat melihat perkiraan biaya bulanan Anda di bagian bawah kalkulator harga.

## CloudWatch konfigurasi agen untuk solusi ini
<a name="Solution-EC2-Health-Agent-Config"></a>

 CloudWatch Agen adalah perangkat lunak yang berjalan terus menerus dan mandiri di server Anda dan di lingkungan kontainer. Ini mengumpulkan metrik, log, dan jejak dari infrastruktur dan aplikasi Anda dan mengirimkannya ke dan CloudWatch X-Ray.

Untuk informasi selengkapnya tentang CloudWatch agen, lihat [Mengumpulkan metrik, log, dan jejak dengan CloudWatch agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html).

Konfigurasi agen dalam solusi ini mengumpulkan sekumpulan metrik untuk membantu Anda mulai memantau dan mengamati instans EC2 Anda. CloudWatch Agen dapat dikonfigurasi untuk mengumpulkan lebih banyak metrik EC2 daripada tampilan dasbor secara default. Untuk daftar metrik Amazon EC2, lihat [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) macOS. Untuk informasi tentang metrik yang dikumpulkan pada instance Windows, lihat [Metrik yang dikumpulkan oleh CloudWatch agen pada instans Windows Server](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#windows-metrics-enabled-by-CloudWatch-agent).

### Konfigurasi agen untuk solusi EC2 Health
<a name="Solution-EC2-Health-Agent-Config-Details"></a>

Metrik yang dikumpulkan oleh agen ditentukan dalam konfigurasi agen. Solusi ini menyediakan konfigurasi agen untuk mengumpulkan metrik yang direkomendasikan dengan dimensi yang sesuai untuk dasbor solusi.

Langkah-langkah untuk menerapkan solusi dijelaskan nanti di[Menyebarkan agen untuk solusi Anda](#Solution-EC2-Health-Deploy). Informasi berikut dimaksudkan untuk membantu Anda memahami cara menyesuaikan konfigurasi agen untuk lingkungan Anda.

**catatan**  
Jika instans EC2 bukan bagian dari grup Auto Scaling, agen akan menurunkan CloudWatch `AutoScalingGroupName` dimensi seluruhnya. Perilaku ini membantu mencegah nama dimensi dengan null/empty nilai. Setiap widget metrik yang disertakan dalam dasbor solusi mencari metrik yang menyertakan dan mengecualikan dimensi. `AutoScalingGroup` Ini membantu memastikan bahwa semua instans EC2 di mana solusi diterapkan didukung oleh dasbor yang sama.

Jika Anda ingin melakukan modifikasi pada konfigurasi agen, Anda harus menerapkan perubahan yang sama pada dasbor yang menyertainya. Misalnya, jika Anda memutuskan untuk menghilangkan ImageId dimensi, dimensi yang sama harus dihapus dari ekspresi pencarian metrik yang digunakan dalam widget dasbor.

### Konfigurasi agen untuk Instans EC2
<a name="Solution-EC2-Health-Agent-Config-Instance"></a>

Gunakan konfigurasi CloudWatch agen berikut pada instans Amazon EC2 tempat beban kerja Anda diterapkan.

```
{
    "agent": {
      "metrics_collection_interval": 60,
      "run_as_user": "cwagent"
    },
    "metrics": {
      "append_dimensions": {
        "InstanceId": "${aws:InstanceId}",
        "InstanceType": "${aws:InstanceType}",
        "ImageId": "${aws:ImageId}",
        "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
      },
      "metrics_collected": {
        "cpu": {
          "measurement": [
            "cpu_usage_idle",
             "cpu_usage_iowait",
             "cpu_usage_user",
             "cpu_usage_system"
          ],
          "totalcpu": true
        },
        "disk": {
          "measurement": [
            "used_percent",
            "inodes_free"
          ],
          "resources": [
            "*"
          ],
          "dimensions": [
            ["device", "fstype", "path"]
          ]
        },
        "diskio": {
           "measurement": [
             "io_time"
           ],
           "resources": [
             "*"
           ]
          },
        "mem": {
          "measurement": [
            "used_percent"
          ]
        },
        "swap": {
          "measurement": [
            "used_percent"
          ]
        }
      }
    }
  }
```

## Menyebarkan agen untuk solusi Anda
<a name="Solution-EC2-Health-Deploy"></a>

Ada beberapa pendekatan untuk menginstal CloudWatch agen, tergantung pada kasus penggunaan. Sebaiknya gunakan Systems Manager untuk solusi ini. Ini memberikan pengalaman konsol dan membuatnya lebih mudah untuk mengelola armada server yang dikelola dalam satu AWS akun. Petunjuk di bagian ini menggunakan Systems Manager dan ditujukan untuk saat Anda tidak menjalankan CloudWatch agen dengan konfigurasi yang ada. Anda dapat memeriksa apakah CloudWatch agen berjalan dengan mengikuti langkah-langkah di [Verifikasi bahwa CloudWatch agen sedang berjalan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html#CloudWatch-Agent-troubleshooting-verify-running).

Jika Anda sudah menjalankan CloudWatch agen di host EC2 dan mengelola konfigurasi agen, Anda dapat melewati instruksi di bagian ini dan mengikuti mekanisme penerapan yang ada untuk memperbarui konfigurasi. Pastikan untuk menggabungkan konfigurasi agen Kesehatan EC2 dengan konfigurasi agen yang ada, lalu gunakan konfigurasi gabungan. Jika Anda menggunakan Systems Manager untuk menyimpan dan mengelola konfigurasi CloudWatch agen, Anda dapat menggabungkan konfigurasi ke nilai parameter yang ada. Untuk informasi selengkapnya, lihat [Mengelola file konfigurasi CloudWatch agen](https://docs.aws.amazon.com/prescriptive-guidance/latest/implementing-logging-monitoring-cloudwatch/create-store-cloudwatch-configurations.html).

**catatan**  
Menggunakan Systems Manager untuk menerapkan konfigurasi CloudWatch agen berikut akan menggantikan atau menimpa konfigurasi CloudWatch agen yang ada pada instans EC2 Anda. Anda dapat memodifikasi konfigurasi ini agar sesuai dengan lingkungan unik atau kasus penggunaan Anda. Metrik yang ditentukan dalam konfigurasi adalah minimum yang diperlukan untuk dasbor yang disediakan solusinya.

Proses penyebaran mencakup langkah-langkah berikut:
+ Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan.
+ Langkah 2: Simpan file konfigurasi agen yang direkomendasikan di Systems Manager Parameter Store.
+ Langkah 3: Instal CloudWatch agen pada satu atau lebih instance EC2 menggunakan tumpukan. CloudFormation 
+ Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar.

### Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan
<a name="Solution-EC2-Health-Deploy-Step1"></a>

Anda harus memberikan izin kepada Systems Manager untuk menginstal dan mengkonfigurasi CloudWatch agen. Anda juga harus memberikan izin kepada CloudWatch agen untuk mempublikasikan telemetri dari instans EC2 Anda ke. CloudWatch Pastikan bahwa peran IAM yang dilampirkan pada instance memiliki kebijakan SSMManaged InstanceCore IAM **CloudWatchAgentServerPolicy**dan **Amazon** yang dilampirkan.
+ Setelah peran dibuat, lampirkan peran ke instans EC2 Anda. Untuk melampirkan peran ke instans EC2, ikuti langkah-langkah di [Lampirkan peran IAM ke instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/attach-iam-role.html).

### Langkah 2: Simpan file konfigurasi CloudWatch agen yang direkomendasikan di Systems Manager Parameter Store
<a name="Solution-EC2-Health-Deploy-Step2"></a>

Parameter Store menyederhanakan pemasangan CloudWatch agen pada instans EC2 dengan menyimpan dan mengelola parameter konfigurasi dengan aman, menghilangkan kebutuhan akan nilai hard-code. Ini memastikan proses penyebaran yang lebih aman dan fleksibel, memungkinkan manajemen terpusat dan pembaruan konfigurasi yang lebih mudah di beberapa instance.

Gunakan langkah-langkah berikut untuk menyimpan file konfigurasi CloudWatch agen yang direkomendasikan sebagai parameter di Parameter Store. 

**Untuk membuat file konfigurasi CloudWatch agen sebagai parameter**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat instans EC2 berjalan.

1. Dari panel navigasi, pilih **Manajemen Aplikasi**, **Parameter Store**.

1. Ikuti langkah-langkah ini untuk membuat parameter baru untuk konfigurasi.

   1. Pilih **Buat parameter**.

   1. Di kotak **Nama**, masukkan nama yang akan Anda gunakan untuk mereferensikan file konfigurasi CloudWatch agen di langkah selanjutnya. Misalnya, **AmazonCloudWatch-EC2Health-Configuration**.

   1. (Opsional) Dalam **Deskripsi** kotak, ketikkan deskripsi untuk parameter.

   1. Untuk **tingkat Parameter**, pilih **Standar**.

   1. Untuk **Type**, pilih **String**.

   1. Untuk **tipe Data**, pilih **teks**.

   1. Di kotak **Nilai**, tempel konfigurasi agen JSON yang disediakan sebelumnya dalam dokumen ini.

   1. Pilih **Buat parameter**.

### Langkah 3: Instal CloudWatch agen dan terapkan konfigurasi menggunakan CloudFormation templat
<a name="Solution-EC2-Health-Deploy-Step3"></a>

Anda dapat menggunakan CloudFormation untuk menginstal agen dan mengonfigurasinya untuk menggunakan konfigurasi CloudWatch agen yang Anda buat di langkah sebelumnya.

**Untuk menginstal dan mengkonfigurasi CloudWatch agen untuk solusi ini**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw - agent-installation-template -1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json).

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat instans EC2 berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti**CWAgentInstallationStack**.

1. Di bagian **Parameter**, tentukan yang berikut ini:

   1. Untuk **CloudWatchAgentConfigSSM**, masukkan nama parameter Systems Manager untuk konfigurasi agen yang Anda buat sebelumnya, seperti**AmazonCloudWatch-EC2Health-Configuration**.

   1. Untuk memilih instance target, Anda memiliki dua opsi.

      1. Untuk **InstanceIds**, tentukan daftar instance IDs daftar instance yang dibatasi koma IDs di mana Anda ingin menginstal CloudWatch agen dengan konfigurasi ini. Anda dapat membuat daftar satu contoh atau beberapa contoh.

      1. Jika Anda menerapkan pada skala besar, Anda dapat menentukan **TagKey**dan yang sesuai **TagValue**untuk menargetkan semua instans EC2 dengan tag dan nilai ini. Jika Anda menentukan a **TagKey**, Anda harus menentukan yang sesuai **TagValue**. (Untuk grup Auto Scaling, tentukan **aws:autoscaling:groupName** **TagKey**dan tentukan nama grup Auto Scaling untuk digunakan ke semua **TagValue**instance dalam grup Auto Scaling.)

      Jika Anda menentukan parameter **InstanceIds**dan **TagKeys**parameter, **InstanceIds**akan diutamakan dan tag akan diabaikan.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**.

Jika Anda ingin mengedit file templat terlebih dahulu untuk menyesuaikannya, pilih opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan berikut untuk mengunduh templat: [ https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw- agent-installation-template -1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json).

**catatan**  
Setelah langkah ini selesai, parameter Systems Manager ini akan dikaitkan dengan CloudWatch agen yang berjalan dalam instance yang ditargetkan. Ini artinya bahwa:  
Jika parameter Systems Manager dihapus, agen akan berhenti.
Jika parameter Systems Manager diedit, perubahan konfigurasi akan secara otomatis berlaku untuk agen pada frekuensi terjadwal yaitu 30 hari secara default.
Jika Anda ingin segera menerapkan perubahan pada parameter Systems Manager ini, Anda harus menjalankan langkah ini lagi. Untuk informasi selengkapnya tentang asosiasi, lihat [Bekerja dengan asosiasi di AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations.html).

### Langkah 4: Verifikasi pengaturan agen dikonfigurasi dengan benar
<a name="Solution-EC2-Health-Deploy-Step4"></a>

Anda dapat memverifikasi apakah CloudWatch agen diinstal dengan mengikuti langkah-langkah di [Verifikasi bahwa CloudWatch agen sedang berjalan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html#CloudWatch-Agent-troubleshooting-verify-running). Jika CloudWatch agen tidak diinstal dan berjalan, pastikan Anda telah mengatur semuanya dengan benar.
+ Pastikan Anda telah melampirkan peran dengan izin yang benar untuk instans EC2 seperti yang dijelaskan dalam. [Langkah 1: Pastikan instans EC2 target memiliki izin IAM yang diperlukan](#Solution-EC2-Health-Deploy-Step1)
+ Pastikan Anda telah mengkonfigurasi JSON dengan benar untuk parameter Systems Manager. Ikuti langkah-langkah dalam [Mengatasi masalah pemasangan CloudWatch agen dengan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent-New-Instances-CloudFormation.html#CloudWatch-Agent-CloudFormation-troubleshooting). CloudFormation

**Untuk memverifikasi bahwa metrik kesehatan EC2 sedang dipublikasikan ke CloudWatch**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pilih **Metrik**, **Semua Metrik**.

1. Pastikan Anda telah memilih Wilayah tempat Anda menerapkan solusi, dan pilih **Ruang nama khusus**,. **CWAgent**

1. Cari metrik yang disebutkan di bagian konfigurasi agen dokumen ini, seperti`mem_used_percent`. Jika Anda melihat hasil untuk metrik ini, maka metrik sedang dipublikasikan ke. CloudWatch

## Buat dasbor solusi Kesehatan EC2
<a name="Solution-EC2-Health-Dashboard"></a>

Dasbor ini menampilkan metrik yang baru dipancarkan, menunjukkan metrik EC2 Health. Dasbor ini menyediakan tampilan kontributor teratas untuk kesehatan instans EC2 Anda di satu wilayah. Tampilan kontributor teratas menampilkan 10 teratas per widget metrik. Ini memungkinkan Anda untuk mengidentifikasi outlier secara sekilas.

Untuk membuat dasbor, Anda dapat menggunakan opsi berikut:
+ Gunakan CloudWatch konsol untuk membuat dasbor.
+ Gunakan AWS CloudFormation konsol untuk menyebarkan dasbor.
+ Unduh AWS CloudFormation infrastruktur sebagai kode dan integrasikan sebagai bagian dari otomatisasi integrasi berkelanjutan (CI) Anda.

Dengan menggunakan CloudWatch konsol untuk membuat dasbor, Anda dapat melihat pratinjau dasbor sebelum benar-benar membuat dan mengisi daya.

**catatan**  
Dasbor yang dibuat dengan CloudFormation solusi ini menampilkan metrik dari Wilayah tempat solusi diterapkan. Pastikan untuk membuat CloudFormation tumpukan di Wilayah tempat metrik EC2 Anda diterbitkan.  
Jika Anda telah menentukan namespace khusus selain `CWAgent` dalam konfigurasi CloudWatch agen, Anda harus mengubah CloudFormation template untuk dasbor untuk diganti `CWAgent` dengan namespace khusus yang Anda gunakan.

**Untuk membuat dasbor melalui CloudWatch Konsol**

1. Buka **Dasbor Buat CloudWatch ** Konsol menggunakan tautan ini: [ https://console.aws.amazon.com/cloudwatch/beranda? \$1dashboards? dashboardTemplate=EC2 &referrer=os-catalog LinuxMacOsHealth](https://console.aws.amazon.com/cloudwatch/home?#dashboards?dashboardTemplate=Ec2LinuxMacOsHealth&referrer=os-catalog). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat instans EC2 berjalan.

1. Masukkan nama dasbor, lalu pilih **Create Dashboard**.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **EC2HealthDashboard-us-east-1**

1. Pratinjau dasbor dan pilih **Simpan** untuk membuat dasbor.

**Untuk membuat dasbor melalui CloudFormation**

1. Buka wizard CloudFormation **Quick create stack** menggunakan link ini: [ https://console.aws.amazon.com/cloudformation/home? \$1/ stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/EC2\$1Health/CloudWatch/CFN/v1.0.0/dashboard - template-linux-macos -1.0.0.json](https://console.aws.amazon.com/cloudformation/home?#/stacks/quickcreate?templateURL=https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/EC2_Health/CloudWatch/CFN/v1.0.0/dashboard-template-linux-macos-1.0.0.json). 

1. Verifikasi bahwa Wilayah yang dipilih di konsol adalah Wilayah tempat instans EC2 berjalan.

1. Untuk **nama Stack**, masukkan nama untuk mengidentifikasi tumpukan ini, seperti`EC2HealthDashboardStack`.

1. Di bagian **Parameter**, tentukan nama dasbor di bawah **DashboardName**parameter.

   Untuk membedakan dasbor ini dengan mudah dari dasbor serupa di Wilayah lain, sebaiknya sertakan nama Wilayah di nama dasbor, seperti. **EC2HealthDashboard-us-east-1**

1. Akui kemampuan akses untuk transformasi di bawah **Kemampuan dan** transformasi. Perhatikan bahwa CloudFormation tidak menambahkan sumber daya IAM apa pun.

1. Tinjau pengaturan, lalu pilih **Buat tumpukan**.

1. Setelah status tumpukan **CREATE\$1COMPLETE**, pilih tab **Resources** di bawah tumpukan yang dibuat dan kemudian pilih tautan di bawah **Physical ID** untuk pergi ke dasbor. Anda juga dapat mengakses dasbor di CloudWatch konsol dengan memilih **Dasbor** di panel navigasi kiri konsol, dan menemukan nama dasbor di bawah Dasbor **Kustom**.

Jika Anda ingin mengedit file templat untuk menyesuaikannya untuk tujuan apa pun, Anda dapat menggunakan opsi **Unggah file templat** di bawah **Buat Wisaya Tumpukan** untuk mengunggah templat yang diedit. Untuk informasi selengkapnya, lihat [Membuat tumpukan di CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). Anda dapat menggunakan tautan ini untuk mengunduh templat: [ https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/EC2\$1Health/CloudWatch/CFN/v1.0.0/dashboard- template-linux-macos -1.0.0.json](https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/EC2_Health/CloudWatch/CFN/v1.0.0/dashboard-template-linux-macos-1.0.0.json) 

## Memulai dasbor solusi Kesehatan EC2
<a name="Solution-EC2-Health-Dashboard-Usage"></a>

Berikut adalah beberapa tugas yang dapat Anda coba dengan dasbor pemantauan EC2 baru. Tugas-tugas ini memungkinkan Anda untuk memvalidasi bahwa dasbor berfungsi dengan benar dan memberi Anda beberapa pengalaman langsung menggunakannya untuk memantau instans EC2. Saat Anda mencobanya, Anda akan terbiasa dengan menavigasi dasbor dan menafsirkan metrik yang divisualisasikan.

Pantau berbagai metrik pemanfaatan CPU  
Di bagian **CPU**, periksa array metrik penggunaan CPU. Ini memberikan wawasan tentang bagaimana sumber daya CPU digunakan di berbagai aktivitas seperti proses pengguna, tugas sistem, dan I/O operasi. Cari contoh dengan pemanfaatan tinggi secara konsisten atau pola yang tidak biasa, yang mungkin menunjukkan perlunya penskalaan atau pengoptimalan.

Analisis pemanfaatan disk di berbagai perangkat  
Arahkan ke bagian **Disk** untuk menemukan penggunaan penyimpanan dan metrik ketersediaan inode. Ini membantu Anda mengidentifikasi instance yang kehabisan ruang penyimpanan atau sumber daya sistem file. Perhatikan setiap contoh yang mendekati tingkat penggunaan disk yang tinggi, karena ini dapat menyebabkan masalah kinerja atau gangguan layanan.

Selidiki pola pemanfaatan memori  
Di bagian **Memori**, amati grafik yang memplot pemanfaatan memori dari waktu ke waktu. Ini menunjukkan berapa banyak memori yang tersedia digunakan oleh setiap instance. Cari pola atau lonjakan penggunaan memori yang mungkin berkorelasi dengan waktu atau peristiwa tertentu. Pemanfaatan memori yang tinggi dapat menunjukkan perlunya pengubahan ukuran misalnya atau pengoptimalan aplikasi.

Mengkorelasikan pola di seluruh metrik pemanfaatan inti  
Bandingkan dan waspadai pola pemanfaatan terkait. Misalnya, beban kerja yang menjalankan proses rotasi log dapat menghadirkan peningkatan reguler dalam pemanfaatan **CPU** dan **memori**, diikuti oleh penurunan pemanfaatan **disk**.

Periksa aktivitas jaringan  
Di bagian **Jaringan**, periksa metrik lalu lintas jaringan masuk dan keluar, baik dari segi volume data maupun jumlah paket. Ini memberi Anda wawasan tentang aktivitas jaringan untuk instans EC2 Anda. Perhatikan lonjakan reguler atau anomali dalam lalu lintas jaringan, atau ketidakseimbangan antara data masuk dan keluar.