

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

# Cara kerja Amazon CloudWatch Application Insights
<a name="appinsights-how-works"></a>

CloudWatch Application Insights menyediakan pemantauan sumber daya aplikasi Anda. Informasi berikut menjelaskan cara kerja Application Insights.

**Topics**
+ [

## Cara Wawasan Aplikasi memantau aplikasi
](#appinsights-how-works-sub)
+ [

## Retensi data
](#appinsights-retention)
+ [

## Kuota
](#appinsights-limits)
+ [

# AWS Paket Systems Manager (SSM) yang digunakan oleh CloudWatch Application Insights
](appinsights-ssm-packages.md)
+ [

# AWS Dokumen Systems Manager (SSM) yang digunakan oleh CloudWatch Application Insights
](appinsights-ssm-documents.md)

## Cara Wawasan Aplikasi memantau aplikasi
<a name="appinsights-how-works-sub"></a>

Informasi berikut menjelaskan cara Application Insights memonitor aplikasi.

**Penemuan dan konfigurasi aplikasi**  
Pertama kali aplikasi ditambahkan ke CloudWatch Application Insights, aplikasi memindai komponen aplikasi untuk merekomendasikan metrik kunci, log, dan sumber data lainnya untuk memantau aplikasi Anda. Kemudian Anda dapat melakukan konfigurasi atas aplikasi Anda dengan berdasarkan rekomendasi ini. 

**Prapemrosesan data**  
CloudWatch Application Insights terus menganalisis sumber data yang dipantau di seluruh sumber daya aplikasi untuk menemukan anomali metrik dan kesalahan log (pengamatan). 

**Deteksi masalah cerdas**  
Mesin CloudWatch Application Insights mendeteksi masalah dalam aplikasi Anda dengan mengkorelasikan pengamatan menggunakan algoritma klasifikasi dan aturan bawaan. Untuk membantu pemecahan masalah, ia membuat CloudWatch dasbor otomatis, yang mencakup informasi kontekstual tentang masalah. 

**Peringatan dan tindakan**  
Ketika CloudWatch Application Insights mendeteksi masalah dengan aplikasi Anda, itu menghasilkan CloudWatch Acara untuk memberi tahu Anda tentang masalah tersebut. Lihat [CloudWatch Peristiwa Wawasan Aplikasi untuk masalah yang terdeteksi](appinsights-cloudwatch-events.md) untuk informasi selengkapnya mengenai cara menyiapkan Event. Selain itu, Anda dapat [mengonfigurasi notifikasi Amazon SNS](appinsights-problem-notifications.md) untuk menerima peringatan untuk masalah yang terdeteksi.

**Contoh skenario**

Anda memiliki sebuah aplikasi ASP .NET yang didukung oleh basis data Server SQL. Tiba-tiba, basis data Anda mulai mengalami malfungsi karena adanya tekanan memori yang tinggi. Hal ini akan menyebabkan penurunan performa aplikasi dan kemungkinan kesalahan HTTP 500 di server web Anda dan penyeimbang beban.

Dengan CloudWatch Application Insights dan analitik cerdasnya, Anda dapat mengidentifikasi lapisan aplikasi yang menyebabkan masalah dengan memeriksa dasbor yang dibuat secara dinamis yang menunjukkan metrik terkait dan cuplikan file log. Dalam hal ini, masalahnya mungkin ada di lapisan basis data SQL.

## Retensi data
<a name="appinsights-retention"></a>

CloudWatch Application Insights mempertahankan masalah selama 55 hari dan pengamatan selama 60 hari.

## Kuota
<a name="appinsights-limits"></a>

Untuk kuota default untuk Wawasan CloudWatch Aplikasi, lihat titik [akhir dan kuota Amazon CloudWatch Application Insights](https://docs.aws.amazon.com/general/latest/gr/applicationinsights.html). Kecuali dinyatakan lain, setiap kuota adalah per AWS Wilayah. Silakan hubungi [AWS Support](https://console.aws.amazon.com/support/home#/case/create?issueType=technical) untuk meminta kenaikan kuota layanan Anda. Banyak layanan yang memiliki kuota yang tidak dapat diubah. Untuk informasi selengkapnya tentang kuota untuk sebuah layanan tertentu, silakan lihat dokumentasi untuk layanan tersebut. 

# AWS Paket Systems Manager (SSM) yang digunakan oleh CloudWatch Application Insights
<a name="appinsights-ssm-packages"></a>

Paket-paket yang tercantum dalam bagian ini digunakan oleh Application Insights, dan dapat dikelola dan digunakan secara independen dengan AWS Systems Manager Distributor. Untuk informasi selengkapnya tentang SSM Distributor, silakan lihat [AWS Distributor Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) di *Panduan Pengguna AWS Systems Manager*.

**Topics**
+ [

## `AWSObservabilityExporter-JMXExporterInstallAndConfigure`
](#configure-java)
+ [

## `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`
](#appinsights-ssm-sap-prometheus)
+ [

## `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`
](#appinsights-ssm-sap-prometheus-ha)
+ [

## `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`
](#appinsights-ssm-sap-host-exporter)
+ [

## `AWSObservabilityExporter-SQLExporterInstallAndConfigure`
](#appinsights-ssm-sql-prometheus)

## `AWSObservabilityExporter-JMXExporterInstallAndConfigure`
<a name="configure-java"></a>

Anda dapat mengambil metrik-metrik Java beban kerja khusus dari [pengekspor Prometheus JMX](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) untuk Wawasan Aplikasi untuk melakukan konfigurasi dan pemantauan alarm. Dalam konsol Wawasan Aplikasi, pada halaman **Mengelola pemantauan**, silakan pilih **Aplikasi JAVA** dari menu geser-turun **Tingkat aplikasi**. Kemudian pada **Konfigurasi pengekspor JAVA Prometheus**, pilih **Metode pengumpulan** dan **Nomor port JMX** Anda. 

Untuk menggunakan [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) untuk mengemas, menginstal, dan mengonfigurasi paket eksportir Prometheus JMX yang AWS disediakan secara independen dari Application Insights, selesaikan langkah-langkah berikut.

**Prasyarat untuk menggunakan paket SSM pengekspor Prometheus JMX**
+ Menginstal agen SSM versi 2.3.1550.0 atau versi yang lebih baru
+ Mengatur variabel lingkungan JAVA\$1HOME

**Menginstal dan mengonfigurasi paket `AWSObservabilityExporter-JMXExporterInstallAndConfigure`**  
Paket `AWSObservabilityExporter-JMXExporterInstallAndConfigure` adalah sebuah paket SSM Distributor yang dapat Anda gunakan untuk melakukan instalasi dan mengonfigurasi [Pengekspor Prometheus JMX](https://github.com/prometheus/jmx_exporter). Ketika metrik Java dikirim oleh eksportir Prometheus JMX, agen dapat dikonfigurasi untuk mengambil metrik CloudWatch untuk layanan. CloudWatch 

1. Berdasarkan preferensi Anda, siapkan file konfigurasi [YAMM eksportir Prometheus JMX](https://github.com/prometheus/jmx_exporter#configuration) yang terletak di repositori Prometheus. GitHub Gunakan contoh konfigurasi dan deskripsi opsi tersebut untuk memandu Anda.

1. Salin file konfigurasi YAML pengekspor Prometheus JMX yang dikodekan sebagai Base64 ke sebuah parameter SSM baru di [Penyimpanan Parameter SSM](https://console.aws.amazon.com/systems-manager/parameters).

1. Navigasikan ke konsol [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) dan buka tab **Dimiliki oleh Amazon**. Pilih **AWSObservabilityExporter-JMXExporterInstallAndConfigure**dan pilih **Instal satu kali**.

1. Perbarui parameter SSM yang sudah Anda buat pada langkah pertama dengan mengganti "Argumen Tambahan" dengan yang berikut ini:

   ```
   {
     "SSM_EXPORTER_CONFIGURATION": "{{ssm:<SSM_PARAMETER_STORE_NAME>}}",
     "SSM_EXPOSITION_PORT": "9404"
   }
   ```
**catatan**  
Port 9404 adalah port default yang digunakan untuk mengirimkan metrik-metrik Prometheus JMX. Anda dapat memperbarui port ini.

**Contoh: Konfigurasikan CloudWatch agen untuk mengambil metrik Java**

1. Instal pengekspor Prometheus JMX, seperti yang telah dijelaskan dalam prosedur sebelumnya. Kemudian lakukan verifikasi bahwa pengekspor tersebut telah diinstal dengan benar pada instans Anda dengan memeriksa status port.

   Instalasi yang berhasil pada contoh instans Windows

   ```
   PS C:\> curl http://localhost:9404 (http://localhost:9404/)
   StatusCode : 200
   StatusDescription : OK
   Content : # HELP jvm_info JVM version info
   ```

   Instalasi yang berhasil pada contoh instans Linux

   ```
   $ curl localhost:9404
   # HELP jmx_config_reload_failure_total Number of times configuration have failed to be reloaded.
   # TYPE jmx_config_reload_failure_total counter
   jmx_config_reload_failure_total 0.0
   ```

1. Membuat file YAML penemuan layanan Prometheus. File penemuan layanan contoh berikut melakukan hal-hal berikut:
   + Menentukan port host pengekspor Prometheus JMX sebagai `localhost: 9404`.
   + Melampirkan label (`Application`,`ComponentName`, dan`InstanceId`) ke metrik, yang dapat ditetapkan sebagai dimensi CloudWatch metrik.

   ```
   $ cat prometheus_sd_jmx.yaml 
   - targets:
     - 127.0.0.1:9404
     labels:
       Application: myApp
       ComponentName: arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/sampl-Appli-MMZW8E3GH4H2/aac36d7fea2a6e5b
       InstanceId: i-12345678901234567
   ```

1. Membuat file YAML konfigurasi pengeskpor Prometheus JMX. File konfigurasi contoh berikut menentukan hal-hal berikut:
   + Interval tugas pengambilan metrik dan periode habis waktu.
   + Pekerjaan pengambilan metrik (`jmx` dan `sap`), juga dikenal sebagai scraping, yang mencakup nama pekerjaan, deret waktu maksimum yang dikembalikan sekaligus pada satu waktu, dan jalur file penemuan layanan. 

   ```
   $ cat prometheus.yaml 
   global:
     scrape_interval: 1m
     scrape_timeout: 10s
   scrape_configs:
     - job_name: jmx
       sample_limit: 10000
       file_sd_configs:
         - files: ["/tmp/prometheus_sd_jmx.yaml"]
     - job_name: sap
       sample_limit: 10000
       file_sd_configs:
         - files: ["/tmp/prometheus_sd_sap.yaml"]
   ```

1. Verifikasi bahwa CloudWatch agen diinstal pada instans Amazon EC2 Anda dan versinya adalah 1.247346.1b249759 atau yang lebih baru. Untuk menginstal CloudWatch agen pada instans EC2 Anda, lihat [Menginstal CloudWatch Agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html). Untuk memverifikasi versi, lihat [Menemukan informasi tentang versi CloudWatch agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html#CloudWatch-Agent-troubleshooting-agent-version).

1. Konfigurasikan CloudWatch agen. Untuk informasi selengkapnya tentang cara mengonfigurasi file konfigurasi CloudWatch agen, lihat [Membuat atau mengedit file konfigurasi CloudWatch agen secara manual](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). Contoh file konfigurasi CloudWatch agen berikut melakukan hal berikut:
   + Menentukan jalur file konfigurasi pengekspor Prometheus JMX.
   + Menentukan grup log target yang akan digunakan untuk menerbitkan log metrik EMF.
   + Menentukan dua set dimensi untuk masing-masing nama metrik.
   + Mengirim 8 (4 nama metrik\$1 2 set dimensi per nama metrik) CloudWatch metrik.

   ```
   {
      "logs":{
         "logs_collected":{
            ....
         },
         "metrics_collected":{
            "prometheus":{
               "cluster_name":"prometheus-test-cluster",
               "log_group_name":"prometheus-test",
               "prometheus_config_path":"/tmp/prometheus.yaml",
               "emf_processor":{
                  "metric_declaration_dedup":true,
                  "metric_namespace":"CWAgent",
                  "metric_unit":{
                     "jvm_threads_current":"Count",
                     "jvm_gc_collection_seconds_sum":"Second",
                     "jvm_memory_bytes_used":"Bytes"
                  },
                  "metric_declaration":[
                     {
                        "source_labels":[
                           "job"
                        ],
                        "label_matcher":"^jmx$",
                        "dimensions":[
                           [
                              "InstanceId",
                              "ComponentName"
                           ],
                           [
                              "ComponentName"
                           ]
                        ],
                        "metric_selectors":[
                           "^java_lang_threading_threadcount$",
                           "^java_lang_memory_heapmemoryusage_used$",
                           "^java_lang_memory_heapmemoryusage_committed$"
                        ]
                     }
                  ]
               }
            }
         }
      },
      "metrics":{
         ....
      }
   }
   ```

## `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`
<a name="appinsights-ssm-sap-prometheus"></a>

Anda dapat mengambil metrik SAP HANA specifik beban kerja dari [pengekspor basis data Prometheus HANA](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) untuk Wawasan Aplikasi untuk mengonfigurasi dan memantau alarm. Untuk informasi selengkapnya, lihat [Menyiapkan basis data SAP HANA Anda untuk pemantauan](appinsights-tutorial-sap-hana.md#appinsights-tutorial-sap-hana-set-up) dalam panduan ini.

Untuk menggunakan [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) untuk mengemas, menginstal, dan mengkonfigurasi paket eksportir database Prometheus HANA yang AWS disediakan secara independen dari Application Insights, selesaikan langkah-langkah berikut.

**Prasyarat untuk menggunakan paket SSM pengekspor basis data Prometheus HANA**
+ Menginstal agen SSM versi 2.3.1550.0 atau versi yang lebih baru
+ Basis data SAP Hana
+ Sistem operasi Linux (SUSE Linux, RedHat Linux)
+ Sebuah rahasia dengan kredensial pemantauan basis data SAP HANA, dengan menggunakan AWS Secrets Manager. Buat rahasia menggunakan format key/value pasangan, tentukan nama pengguna kunci, dan masukkan pengguna database untuk nilainya. Menambahkan sebuah kata sandi kunci kedua, dan memasukkan kata sandi untuk nilainya. Untuk informasi selengkapnya tentang cara membuat sebuah rahasia, silakan lihat [Membuat rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) di *Panduan Pengguna AWS Secrets Manager *. Rahasia harus diformat sebagai berikut:

  ```
  {
    "username": "<database_user>",
    "password": "<database_password>"
  }
  ```

**Menginstal dan mengonfigurasi paket `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`**  
Paket `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure` adalah sebuah paket SSM Distributor yang dapat Anda gunakan untuk melakukan instalasi dan mengonfigurasi [Pengekspor basis data HANA Prometheus](https://github.com/prometheus/jmx_exporter). Ketika metrik database HANA dikirim oleh eksportir database Prometheus HANA, CloudWatch agen dapat dikonfigurasi untuk mengambil metrik untuk layanan. CloudWatch 

1. Membuat sebuah parameter SSM di [SSM Parameter Store](https://console.aws.amazon.com/systems-manager/parameters) untuk menyimpan konfigurasi Pengekspor. Berikut ini adalah sebuah contoh nilai parameter.

   ```
   {\"exposition_port\":9668,\"multi_tenant\":true,\"timeout\":600,\"hana\":{\"host\":\"localhost\",\"port\":30013,\"aws_secret_name\":\"HANA_DB_CREDS\",\"scale_out_mode\":true}}
   ```
**catatan**  
Dalam contoh ini, ekspor hanya berjalan pada instans Amazon EC2 dengan basis data `SYSTEM` aktif, dan ekspor akan tetap menganggur pada instans EC2 lainnya untuk menghindari adanya metrik-metrik duplikat. Pengekspor dapat mengambil semua informasi penyewa basis data dari basis data `SYSTEM`.

1. Membuat sebuah parameter SSM di [SSM Parameter Store](https://console.aws.amazon.com/systems-manager/parameters) untuk menyimpan kueri metrik Pengekspor. Paket tersebut dapat menerima lebih dari satu parameter metrik. Setiap parameter harus memiliki format objek JSON yang benar. Berikut ini adalah sebuah contoh nilai parameter:

   ```
   {\"SELECT MAX(TIMESTAMP) TIMESTAMP, HOST, MEASURED_ELEMENT_NAME CORE, SUM(MAP(CAPTION, 'User Time', TO_NUMBER(VALUE), 0)) USER_PCT, SUM(MAP(CAPTION, 'System Time', TO_NUMBER(VALUE), 0)) SYSTEM_PCT, SUM(MAP(CAPTION, 'Wait Time', TO_NUMBER(VALUE), 0)) WAITIO_PCT, SUM(MAP(CAPTION, 'Idle Time', 0, TO_NUMBER(VALUE))) BUSY_PCT, SUM(MAP(CAPTION, 'Idle Time', TO_NUMBER(VALUE), 0)) IDLE_PCT FROM sys.M_HOST_AGENT_METRICS WHERE MEASURED_ELEMENT_TYPE = 'Processor' GROUP BY HOST, MEASURED_ELEMENT_NAME;\":{\"enabled\":true,\"metrics\":[{\"name\":\"hanadb_cpu_user\",\"description\":\"Percentage of CPU time spent by HANA DB in user space, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"USER_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_system\",\"description\":\"Percentage of CPU time spent by HANA DB in Kernel space, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"SYSTEM_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_waitio\",\"description\":\"Percentage of CPU time spent by HANA DB in IO mode, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"WAITIO_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_busy\",\"description\":\"Percentage of CPU time spent by HANA DB, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"BUSY_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_idle\",\"description\":\"Percentage of CPU time not spent by HANA DB, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"IDLE_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"}]}}
   ```

   Untuk informasi selengkapnya tentang kueri metrik, lihat [https://github.com/SUSE/hanadb_exporter/blob/master/metrics.json](https://github.com/SUSE/hanadb_exporter/blob/master/metrics.json)repo di. GitHub

1. Navigasikan ke konsol [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) dan buka tab **Dimiliki oleh Amazon**. Pilih **AWSObservabilityExporter-SAP- HANADBExporter InstallAndConfigure \$1** dan pilih **Instal satu kali**.

1. Perbarui parameter SSM yang sudah Anda buat pada langkah pertama dengan mengganti "Argumen Tambahan" dengan yang berikut ini:

   ```
   {
     "SSM_EXPORTER_CONFIG": "{{ssm:<*SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>*}}",
     "SSM_SID": "<SAP_DATABASE_SID>",
     "SSM_EXPORTER_METRICS_1": "{{ssm:<SSM_FIRST_METRICS_PARAMETER_STORE_NAME>}}",
     "SSM_EXPORTER_METRICS_2": "{{ssm:<SSM_SECOND_METRICS_PARAMETER_STORE_NAME>}}"
   }
   ```

1. Pilih instans Amazon EC2 dengan basis data SAP HANA, kemudian pilih **Jalankan**.

## `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`
<a name="appinsights-ssm-sap-prometheus-ha"></a>

Anda dapat mengambil metrik-metrik klaster High Availability (HA) spesifik beban kerja dari [pengekspor klaster HANA Prometheus](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) untuk Wawasan Aplikasi untuk mengonfigurasi dan memantau alarm untuk pengaturan Ketersediaan Tinggi basis data SAP HANA. Untuk informasi selengkapnya, silakan lihat [Menyiapkan basis data SAP HANA Anda untuk pemantauan](appinsights-tutorial-sap-hana.md#appinsights-tutorial-sap-hana-set-up) dalam panduan ini.

Untuk menggunakan [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) untuk mengemas, menginstal, dan mengonfigurasi paket eksportir klaster Prometheus HA yang AWS disediakan secara independen dari Application Insights, selesaikan langkah-langkah berikut.

**Prasyarat untuk menggunakan paket SSM pengekspor klaster Prometheus HA**
+ Menginstal agen SSM versi 2.3.1550.0 atau versi yang lebih baru
+ Klaster HA untuk Pacemaker, Corosync, SBD, dan DRBD
+ Sistem operasi Linux (SUSE Linux, RedHat Linux)

**Menginstal dan mengonfigurasi paket `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`**  
Paket `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure` adalah sebuah paket SSM Distributor yang dapat Anda gunakan untuk melakukan instalasi dan mengonfigurasi Pengekspor Klaster Prometheus HA. Ketika metrik klaster dikirim oleh eksportir database Prometheus HANA, agen dapat dikonfigurasi CloudWatch untuk mengambil metrik untuk layanan. CloudWatch 

1. Membuat sebuah parameter SSM di [SSM Parameter Store](https://console.aws.amazon.com/systems-manager/parameters) untuk menyimpan konfigurasi Pengekspor dalam format JSON. Berikut ini adalah sebuah contoh nilai parameter.

   ```
   {\"port\":\"9664\",\"address\":\"0.0.0.0\",\"log-level\":\"info\",\"crm-mon-path\":\"/usr/sbin/crm_mon\",\"cibadmin-path\":\"/usr/sbin/cibadmin\",\"corosync-cfgtoolpath-path\":\"/usr/sbin/corosync-cfgtool\",\"corosync-quorumtool-path\":\"/usr/sbin/corosync-quorumtool\",\"sbd-path\":\"/usr/sbin/sbd\",\"sbd-config-path\":\"/etc/sysconfig/sbd\",\"drbdsetup-path\":\"/sbin/drbdsetup\",\"enable-timestamps\":false}
   ```

   Untuk informasi selengkapnya tentang konfigurasi eksportir, lihat [https://github.com/ClusterLabs/ha_cluster_exporter/blob/master/ha_cluster_exporter.yaml](https://github.com/ClusterLabs/ha_cluster_exporter/blob/master/ha_cluster_exporter.yaml)repo di. GitHub

1. Navigasikan ke konsol [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) dan buka tab **Dimiliki oleh Amazon**. Pilih **AWSObservabilityExporter-HAClusterExporterInstallAndConfigure\$1** dan pilih **Instal satu kali**.

1. Perbarui parameter SSM yang sudah Anda buat pada langkah pertama dengan mengganti "Argumen Tambahan" dengan yang berikut ini:

   ```
   {
     "SSM_EXPORTER_CONFIG": "{{ssm:<*SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>*}}"
   }
   ```

1. Pilih instans Amazon EC2 dengan basis data SAP HANA, kemudian pilih **Jalankan**.

## `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`
<a name="appinsights-ssm-sap-host-exporter"></a>

Anda dapat mengambil NetWeaver metrik SAP khusus beban kerja dari eksportir [host Prometheus SAP untuk Application Insights untuk mengonfigurasi dan memantau alarm untuk penyebaran SAP](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) Distributed dan High Availability. NetWeaver 

Untuk menggunakan [AWS Distributor Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) untuk paket, Anda harus melakukan instalasi, dan mengonfigurasi paket pengekspor Host SAP secara independen dari Wawasan Aplikasi, dan selesaikan langkah-langkah berikut.

**Prasyarat untuk menggunakan paket SSM pengekspor host Prometheus SAP**
+ Menginstal agen SSM versi 2.3.1550.0 atau versi yang lebih baru
+ Server NetWeaver aplikasi SAP
+ Sistem operasi Linux (SUSE Linux, RedHat Linux)

**Menginstal dan mengonfigurasi paket `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`**  
`AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`Paket ini adalah paket Distributor SSM yang dapat Anda gunakan untuk menginstal dan mengkonfigurasi eksportir metrik SAP Prometheus NetWeaver . Ketika NetWeaver metrik SAP dikirim oleh eksportir Prometheus, CloudWatch agen dapat dikonfigurasi untuk mengambil metrik untuk layanan. CloudWatch 

1. Membuat sebuah parameter SSM di [SSM Parameter Store](https://console.aws.amazon.com/systems-manager/parameters) untuk menyimpan konfigurasi Pengekspor dalam format JSON. Berikut ini adalah sebuah contoh nilai parameter.

   ```
   {\"address\":\"0.0.0.0\",\"port\":\"9680\",\"log-level\":\"info\",\"is-HA\":false}
   ```
   + **alamat**

     Alamat target untuk mengirim metrik-metrik Prometheus. Nilai bawaannya adalah `localhost`.
   + **port**

     Port target untuk mengirim metrik-metrik Prometheus. Nilai bawaannya adalah `9680`.
   + **is-HA**

     `true`untuk penerapan SAP NetWeaver High Availability. Untuk semua deployment lainnya nilainya adalah. `false`

1. Navigasikan ke konsol [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) dan buka tab **Dimiliki oleh Amazon**. Pilih **AWSObservabilityExporter-SAP- SAPHost ExporterInstallAndConfigure** dan pilih **Instal satu kali**.

1. Perbarui parameter SSM yang sudah Anda buat pada langkah pertama dengan mengganti "Argumen Tambahan" dengan yang berikut ini:

   ```
   {
     "SSM_EXPORTER_CONFIG": "{{ssm:<SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>}}",
     "SSM_SID": "<SAP_DATABASE_SID>",
     "SSM_INSTANCES_NUM": "<instances_number seperated by comma>"
   }
   ```

   **Contoh**

   ```
   {
     "SSM_EXPORTER_CONFIG": "{{ssm:exporter_config_paramter}}",
     "SSM_INSTANCES_NUM": "11,12,10",
     "SSM_SID": "PR1"
   }
   ```

1. **Pilih instans Amazon EC2 dengan NetWeaver aplikasi SAP, dan pilih Jalankan.**

**catatan**  
Eksportir Prometheus melayani metrik SAP pada titik akhir lokal. NetWeaver Titik akhir lokal tersebut hanya dapat diakses oleh pengguna sistem operasi pada instans Amazon EC2. Oleh karena itu, setelah paket pengekspor diinstal, metrik-metrik tersedia untuk semua pengguna sistem operasi. Titik akhir lokal default-nya adalah `localhost:9680/metrics`.

## `AWSObservabilityExporter-SQLExporterInstallAndConfigure`
<a name="appinsights-ssm-sql-prometheus"></a>

Anda dapat mengambil metrik-metrik Server SQL Server spesifik beban kerja dari [pengekspor Prometheus SQL](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) untuk Wawasan Aplikasi untuk memantau metrik-metrik kunci. 

Untuk menggunakan [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) untuk paket, Anda harus melakukan instalasi, dan mengonfigurasi paket pengekspor SQL secara independen dari Wawasan Aplikasi, dan selesaikan langkah-langkah berikut.

**Prasyarat untuk menggunakan paket SSM pengekspor Prometheus SQL**
+ Menginstal agen SSM versi 2.3.1550.0 atau versi yang lebih baru
+ Instans Amazon EC2 yang menjalankan Server SQL di Windows dengan autentikasi pengguna Server SQL yang diaktifkan.
+ Seorang pengguna Server SQL dengan izin-izin berikut ini:

  ```
  GRANT VIEW ANY DEFINITION TO
  ```

  ```
  GRANT VIEW SERVER STATE TO
  ```
+ Sebuah rahasia yang berisi string koneksi basis data menggunakan AWS Secrets Manager. Untuk informasi selengkapnya tentang cara membuat sebuah rahasia, silakan lihat [Membuat rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) di *Panduan Pengguna AWS Secrets Manager *. Rahasia harus diformat sebagai berikut:

  ```
  {
    "data_source_name":"sqlserver://<username>:<password>@localhost:1433"
  }
  ```
**catatan**  
Jika kata sandi atau nama pengguna berisi karakter khusus, maka Anda harus mengkodekan karakter khusus tersebut untuk memastikan koneksi yang berhasil ke basis data.

**Menginstal dan mengonfigurasi paket `AWSObservabilityExporter-SQLExporterInstallAndConfigure`**  
Paket `AWSObservabilityExporter-SQLExporterInstallAndConfigure` adalah sebuah paket SSM Distributor yang dapat Anda gunakan untuk melakukan instalasi dan mengonfigurasi pengekspor metrik SQL Prometheus. Ketika metrik dikirim oleh eksportir Prometheus, agen dapat dikonfigurasi CloudWatch untuk mengambil metrik untuk layanan. CloudWatch 

1. Berdasarkan pilihan Anda, siapkan konfigurasi YAML Pengekspor SQL. Konfigurasi sampel berikut memiliki satu metrik tunggal yang dikonfigurasi. Gunakan [konfigurasi sampel](https://github.com/burningalchemist/sql_exporter/blob/master/examples/sql_exporter.yml) untuk memperbarui konfigurasi tersebut dengan metrik tambahan atau Anda bisa membuat konfigurasi Anda sendiri.

   ```
   ---
   global:
     scrape_timeout_offset: 500ms
     min_interval: 0s
     max_connections: 3
     max_idle_connections: 3
   target:
     aws_secret_name: <SECRET_NAME>
     collectors:
       - mssql_standard
   collectors:
     - collector_name: mssql_standard
       metrics: 
       - metric_name: mssql_batch_requests
         type: counter
         help: 'Number of command batches received.'
         values: [cntr_value]
         query: |
           SELECT cntr_value
           FROM sys.dm_os_performance_counters WITH (NOLOCK)
           WHERE counter_name = 'Batch Requests/sec'
   ```

1. Salin file konfigurasi YAML pengekspor Prometheus SQL yang dikodekan sebagai Base64 ke sebuah parameter SSM baru di [Penyimpanan Parameter SSM](https://console.aws.amazon.com/systems-manager/parameters).

1. Navigasikan ke konsol [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) dan buka tab **Dimiliki oleh Amazon**. Pilih **AWSObservabilityExporter-SQLExporterInstallAndConfigure**dan pilih **Instal satu kali**.

1. Ganti "Argumen Tambahan" dengan informasi berikut ini. `SSM_PARAMETER_NAME` adalah nama parameter yang sudah Anda buat di Langkah 2.

   ```
   {
     "SSM_EXPORTER_CONFIGURATION": 
       "{{ssm:<SSM_PARAMETER_STORE_NAME>}}",
       "SSM_PROMETHEUS_PORT": "9399",
       "SSM_WORKLOAD_NAME": "SQL"                         
   }
   ```

1. Pilih instans Amazon EC2 dengan basis data Server SQL, kemudian pilih jalankan.

# AWS Dokumen Systems Manager (SSM) yang digunakan oleh CloudWatch Application Insights
<a name="appinsights-ssm-documents"></a>

Wawasan Aplikasi menggunakan Dokumen SSM yang tercantum di bagian ini untuk menentukan tindakan-tindakan yang dilakukan oleh AWS Systems Manager pada instans-instans terkelola Anda. Dokumen-dokumen ini menggunakan kemampuan `Run Command` Systems Manager untuk melakukan otomatisasi pada tugas-tugas yang diperlukan untuk melaksanakan kemampuan pemantauan Wawasan Aplikasi. Jadwal eksekusi untuk dokumen-dokumen ini dikelola oleh Wawasan Aplikasi dan tidak dapat diubah.

Untuk informasi selengkapnya tentang Dokumen SSM, silakan lihat [Dokumen AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html) di *Panduan Pengguna AWS Systems Manager *.

## Dokumen yang dikelola oleh CloudWatch Application Insights
<a name="ssm-documents-appinsights-managed"></a>

Tabel berikut mencantumkan dokumen-dokumen SSM yang dikelola oleh Wawasan Aplikasi.


| Nama dokumen | Deskripsi | Jadwal eksekusi | 
| --- | --- | --- | 
|  `AWSEC2-DetectWorkload`  |  Secara otomatis mendeteksi aplikasi yang berjalan di lingkungan aplikasi Anda yang dapat diatur agar bisa dipantau oleh Wawasan Aplikasi.  |  Dokumen ini berjalan setiap jam di lingkungan aplikasi Anda untuk mendapatkan detail up-to-date aplikasi.  | 
|  `AWSEC2-CheckPerformanceCounterSets`  |  Memeriksa apakah namespace Penghitung Performa sudah diaktifkan pada instans Amazon EC2 Anda.  |  Dokumen ini berjalan setiap jam di lingkungan aplikasi Anda dan hanya memantau metrik-metrik Penghitung Performa jika namespace yang sesuai diaktifkan.  | 
|  `AWSEC2-ApplicationInsightsCloudwatchAgentInstallAndConfigure`  |  Menginstal dan mengonfigurasi CloudWatch Agen berdasarkan konfigurasi pemantauan komponen aplikasi Anda.  |  Dokumen ini berjalan setiap 30 menit untuk memastikan bahwa konfigurasi CloudWatch Agen selalu akurat dan up-to-date. Dokumen tersebut juga akan langsung berjalan setelah ada perubahan yang dilakukan pada pengaturan pemantauan aplikasi Anda, misalnya terjadi penambahan atau penghapusan metrik atau pembaruan konfigurasi log.   | 

## Dokumen yang dikelola oleh AWS Systems Manager
<a name="ssm-documents-aws-managed"></a>

Dokumen-dokumen berikut digunakan oleh CloudWatch Application Insights dan dikelola oleh Systems Manager.

**`AWS-ConfigureAWSPackage`**  
Application Insights menggunakan dokumen ini untuk menginstal dan menghapus paket distributor eksportir Prometheus, untuk mengumpulkan metrik spesifik beban kerja, dan untuk memungkinkan pemantauan komprehensif beban kerja pada instans Amazon EC2 pelanggan. CloudWatch Application Insights menginstal paket distributor eksportir Prometheus hanya jika beban kerja target yang berkorelasi berjalan pada instans Anda. 

Tabel berikut mencantumkan paket distributor pengekspor Prometheus dan beban kerja target yang berkorelasi.


| Nama paket distributor pengekspor Prometheus | Beban kerja target | 
| --- | --- | 
|  `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`  |  SAP HANA HA  | 
|  `AWSObservabilityExporter-JMXExporterInstallAndConfigure`  |  Java/JMX  | 
|  `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`  |  SAP HANA  | 
|  `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`  |  NetWeaver  | 
|  `AWSObservabilityExporter-SQLExporterInstallAndConfigure`  |  Server SQL (Windows) dan SAP ASE (Linux)  | 

**`AmazonCloudWatch-ManageAgent`**  
Application Insights menggunakan dokumen ini untuk mengelola status dan konfigurasi CloudWatch Agen pada instans Anda dan untuk mengumpulkan metrik dan log tingkat sistem internal dari instans Amazon EC2 di seluruh sistem operasi.