Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS Paket Systems Manager (SSM) yang digunakan oleh CloudWatch Application Insights
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`
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_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`
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": "",
"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": "",
"SSM_EXPORTER_METRICS_1": "{{ssm:}}",
"SSM_EXPORTER_METRICS_2": "{{ssm:}}"
}
```
1. Pilih instans Amazon EC2 dengan basis data SAP HANA, kemudian pilih **Jalankan**.
## `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`
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`
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_SID": "",
"SSM_INSTANCES_NUM": ""
}
```
**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`
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://:@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:
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_PROMETHEUS_PORT": "9399",
"SSM_WORKLOAD_NAME": "SQL"
}
```
1. Pilih instans Amazon EC2 dengan basis data Server SQL, kemudian pilih jalankan.