Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Metrik kustom dan metrik diperpanjang yang dapat Anda kirim CloudWatch
Secara default, monitor aplikasi RUM mengirim metrik ke CloudWatch. Metrik dan dimensi default ini tercantum dalam [CloudWatch metrik yang dapat Anda kumpulkan dengan CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-metrics.html) RUM.
Anda juga dapat mengatur monitor aplikasi untuk mengekspor metrik. Monitor aplikasi dapat mengirim metrik yang diperluas, metrik khusus, atau keduanya. Itu dapat mengirim mereka ke CloudWatch.
+ **Metrik kustom** — Metrik kustom adalah metrik yang Anda tentukan. Dengan metrik kustom, Anda dapat menggunakan nama metrik dan namespace apa pun. Untuk mendapatkan metrik, Anda dapat menggunakan peristiwa kustom, peristiwa bawaan, atribut kustom, atau atribut default.
Anda dapat mengirim metrik khusus ke CloudWatch.
+ **Metrik yang diperluas** — Anda dapat mengirim salah satu metrik CloudWatch RUM default CloudWatch dengan dimensi tambahan. Dengan cara ini, metrik ini dapat memberi Anda tampilan yang lebih halus.
**Topics**
+ [Metrik-metrik kustom](#CloudWatch-RUM-custom-metrics)
+ [Metrik yang diperluas](#CloudWatch-RUM-vended-metrics)
## Metrik-metrik kustom
Untuk mengirim metrik khusus, Anda harus menggunakan AWS APIs atau AWS CLI bukan konsol. Untuk informasi lebih lanjut tentang menggunakan AWS APIs, lihat [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)dan [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html).
Jumlah maksimum definisi metrik yang diperluas dan metrik kustom yang dapat memuat satu tujuan adalah 2000. Untuk setiap metrik kustom atau metrik yang diperluas yang Anda kirim ke setiap tujuan, setiap kombinasi nama dimensi dan nilai dimensi diperhitungkan dalam batas ini. Anda tidak dikenakan biaya untuk metrik khusus yang berasal dari segala jenis peristiwa atau atribut CloudWatch RUM.
Contoh berikut menunjukkan cara membuat metrik kustom yang berasal dari peristiwa kustom. Berikut adalah contoh peristiwa kustom yang digunakan:
```
cwr('recordEvent', {
type: 'my_custom_event',
data: {
location: 'IAD',
current_url: 'amazonaws.com',
user_interaction: {
interaction_1 : "click",
interaction_2 : "scroll"
},
visit_count:10
}
})
```
Dengan peristiwa kustom ini, Anda dapat membuat metrik kustom yang menghitung jumlah kunjungan ke URL `amazonaws.com` dari browser Chrome. Definisi berikut membuat metrik yang disebut `AmazonVisitsCount` di akun Anda, di namespace `RUM/CustomMetrics/PageVisits`.
```
{
"AppMonitorName":"customer-appMonitor-name",
"Destination":"CloudWatch",
"MetricDefinitions":[
{
"Name":"AmazonVisitsCount",
"Namespace":"PageVisit",
"ValueKey":"event_details.visit_count",
"UnitLabel":"Count",
"DimensionKeys":{
"event_details.current_url": "URL"
},
"EventPattern":"{\"metadata\":{\"browserName\":[\"Chrome\"]},\"event_type\":[\"my_custom_event\"],\"event_details\": {\"current_url\": [\"amazonaws.com\"]}}"
}
]
}
```
## Metrik yang diperluas
Jika Anda menyiapkan metrik yang diperluas, Anda dapat mengirim salah satu metrik CloudWatch RUM default CloudWatch dengan dimensi tambahan sehingga metrik memberi Anda tampilan yang lebih halus.
Untuk informasi selengkapnya tentang metrik CloudWatch RUM default, lihat[CloudWatch metrik yang dapat Anda kumpulkan dengan CloudWatch RUM](CloudWatch-RUM-metrics.md).
Jumlah maksimum definisi metrik yang diperluas dan metrik kustom yang dapat memuat satu tujuan adalah 2000. Untuk setiap metrik kustom atau metrik yang diperluas yang Anda kirim ke setiap tujuan, setiap kombinasi nama dimensi dan nilai dimensi diperhitungkan untuk batas ini.
Saat Anda mengirim metrik yang diperluas ke CloudWatch, Anda dapat menggunakan konsol CloudWatch RUM untuk membuat CloudWatch alarm pada mereka.
Anda tidak dikenakan biaya untuk metrik tambahan yang dibuat untuk metrik default RUM. CloudWatch
### Metrik Diperpanjang Aplikasi Web
Dimensi berikut didukung untuk metrik yang diperluas aplikasi web:
+ `BrowserName`
Contoh nilai dimensi: `Chrome`, `Firefox`, `Chrome Headless`
+ `CountryCode` Ini menggunakan format ISO-3166, dengan kode dua huruf.
Contoh nilai dimensi: `US`, `JP`, `DE`
+ `DeviceType`
Contoh nilai dimensi: `desktop`, `mobile`, `tablet`, `embedded`
+ `FileType`
Contoh nilai dimensi: `Image`, `Stylesheet`
+ `OSName`
Contoh nilai dimensi: `Linux`, `Windows`, `iOS`, `Android`
+ `PageId`
### Metrik yang Diperpanjang Aplikasi Seluler
Dimensi berikut didukung untuk metrik yang diperluas aplikasi seluler:
+ `ScreenName`
+ Nilai dari atribut nama layar - `attributes.screen.name` aplikasi Anda
+ Contoh nilai: HomeScreen, SettingsView, ProfilePage
+ `DeviceModel`
+ Nilai dari atribut model perangkat - `resource.attributes.device.model.name`
+ Contoh nilai: iPhone14,3, SM-G998B
+ `OSVersion`
+ Nilai dari atribut versi sistem operasi - `resource.attributes.os.version`
+ Contoh nilai: 16.0, 13.0
**catatan**
Metrik default yang saat ini didukung untuk aplikasi seluler:`ScreenLoadTime`,`ScreenLoadCount`,`NetworkLatency`,`Http4xxCount`,`Http5xxCount`,`CrashCount`,`ANRCount`,`AppHangCount`,`ColdLaunchTime`,, `WarmLaunchTime``SessionCount`, `SpanPayloadSize` dan`LogPayloadSize`.
### Atur metrik yang diperluas menggunakan konsol
Untuk menggunakan konsol untuk mengirim metrik yang diperluas CloudWatch, gunakan langkah-langkah berikut.
Untuk informasi tentang menggunakan metrik AWS APIs untuk mengirim diperluas ke salah satu CloudWatch, lihat [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)dan [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html).
**Untuk menggunakan konsol untuk menyiapkan monitor aplikasi dan mengirim metrik diperpanjang RUM ke CloudWatch**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih **Sinyal Aplikasi**, **RUM**.
1. Pilih nama monitor aplikasi yang akan mengirim metrik.
1. Pilih tab **Konfigurasi** dan kemudian pilih **metrik yang diperluas RUM**.
1. Pilih **Kirim metrik**.
1. Pilih satu atau beberapa nama metrik untuk dikirim dengan dimensi tambahan.
1. Pilih satu faktor atau lebih untuk digunakan sebagai dimensi untuk metrik ini. Saat Anda membuat pilihan, jumlah metrik tambahan yang dibuat pilihan Anda ditampilkan di **Jumlah metrik terekstensi**.
Angka ini dihitung dengan mengalikan jumlah nama metrik yang dipilih dengan jumlah dimensi berbeda yang Anda buat.
1. Untuk mengirim metrik dengan ID halaman sebagai dimensi, pilih **Browse for page ID** lalu pilih halaman IDs yang akan digunakan.
1. Untuk mengirim metrik dengan tipe perangkat sebagai dimensi, pilih **perangkat Desktop** atau **Ponsel dan tablet**.
1. Untuk mengirim metrik dengan sistem operasi sebagai dimensi, pilih satu atau beberapa sistem operasi di bawah **Sistem operasi**.
1. Untuk mengirim metrik dengan jenis browser sebagai dimensi, pilih satu browser atau lebih di bawah **Browser**.
1. Untuk mengirim metrik dengan geolokasi sebagai dimensi, pilih satu lokasi atau lebih di bawah **Lokasi**.
Hanya lokasi tempat monitor aplikasi ini melaporkan metrik yang akan muncul dalam daftar yang akan dipilih.
1. Setelah Anda selesai dengan pilihan Anda, pilih **Kirim metrik**.
1. (Opsional) Dalam daftar **Metrik yang diperluas**, untuk membuat alarm yang mengawasi salah satu metrik, pilih **Buat alarm** di baris metrik tersebut.
Untuk informasi umum tentang CloudWatch alarm, lihat[Menggunakan CloudWatch alarm Amazon](CloudWatch_Alarms.md). Untuk tutorial untuk mengatur alarm pada metrik diperpanjang CloudWatch RUM, lihat[Tutorial: membuat metrik yang diperluas dan membuatnya menjadi alarm](#CloudWatch-RUM-extended-metrics-alarmtutorial).
**Berhenti mengirim metrik terekstensi**
**Untuk menggunakan konsol untuk berhenti mengirim metrik terekstensi**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih **Sinyal Aplikasi**, **RUM**.
1. Pilih nama monitor aplikasi yang akan mengirim metrik.
1. Pilih tab **Konfigurasi** dan kemudian pilih **metrik yang diperluas RUM**.
1. Pilih satu atau beberapa kombinasi nama dan dimensi metrik untuk berhenti mengirim. Kemudian pilih **Tindakan**, **Hapus**.
### Tutorial: membuat metrik yang diperluas dan membuatnya menjadi alarm
Tutorial ini menunjukkan cara mengatur metrik yang diperluas untuk dikirim CloudWatch, dan kemudian cara mengatur alarm pada metrik itu. Dalam tutorial ini, Anda membuat metrik yang melacak JavaScript kesalahan pada browser Chrome.
**Untuk mengatur metrik yang diperluas ini dan mengatur alarm di atasnya**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih **Sinyal Aplikasi**, **RUM**.
1. Pilih nama monitor aplikasi yang akan mengirim metrik.
1. Pilih tab **Konfigurasi** dan kemudian pilih **metrik yang diperluas RUM**.
1. Pilih **Kirim metrik**.
1. Pilih **JSErrorHitung**.
1. Di bawah **Browser**, pilih **Chrome**.
Kombinasi **JSErrorCount** dan **Chrome** ini akan mengirimkan satu metrik yang diperluas ke CloudWatch. Metrik menghitung JavaScript kesalahan hanya untuk sesi pengguna yang menggunakan browser Chrome. Nama metrik akan menjadi **JsErrorCount**dan nama dimensi akan menjadi **Browser**.
1. Pilih **Kirim metrik**.
1. Dalam daftar **Metrik diperpanjang**, pilih **Buat alarm** di baris yang ditampilkan **JsErrorCount**di bawah **Nama** dan menampilkan **Chrome** di bawah **BrowserName**.
1. Di bawah **Tentukan metrik dan kondisi**, konfirmasikan bahwa **nama dan **BrowserName**bidang Metrik** telah diisi sebelumnya dengan nilai yang benar.
1. Untuk **Statistik**, pilih statistik yang ingin Anda gunakan untuk alarm. **Rata-rata** adalah pilihan yang baik untuk jenis metrik penghitungan ini.
1. Untuk **Periode**, pilih **5 menit**.
1. Pada **Kondisi**, lakukan hal berikut:
+ Pilih **Statis**.
+ Pilih **Lebih Besar** untuk menentukan bahwa alarm harus masuk ke status ALARM ketika jumlah kesalahan lebih tinggi dari ambang batas yang akan Anda tentukan.
+ Di bawah **dari...** , masukkan angka untuk ambang batas alarm. Alarm masuk ke status ALARM ketika jumlah kesalahan selama periode 5 menit melebihi angka ini.
1. (Opsional) Secara default, alarm masuk ke status ALARM segera setelah jumlah kesalahan melebihi angka ambang batas yang Anda tetapkan selama periode 5 menit. Anda dapat mengubah ini secara opsional sehingga alarm masuk ke status ALARM hanya jika jumlah ini terlampaui selama lebih dari satu periode 5 menit.
Untuk melakukan hal itu, pilih **Konfigurasi tambahan** dan kemudian untuk **Titik data untuk alarm**, tentukan berapa periode 5 menit yang perlu memiliki jumlah kesalahan melebihi ambang batas untuk memicu alarm. Sebagai contoh, Anda dapat memilih 2 dari 2 untuk membuat alarm hanya berbunyi saat dua periode 5 menit berturut-turut melampaui ambang batas, atau 2 dari 3 untuk membuat alarm berbunyi jika dua dari tiga periode 5 menit berturut-turut melampaui ambang batas.
Untuk informasi selengkapnya tentang jenis evaluasi alarm ini, silakan lihat [Evaluasi alarm](alarm-evaluation.md).
1. Pilih **Berikutnya**.
1. Untuk **Mengonfigurasi tindakan**, tentukan apa yang harus terjadi ketika alarm masuk ke status alarm. Untuk menerima notifikasi dengan Amazon SNS, lakukan hal berikut:
+ Pilih **Tambahkan notifikasi**.
+ Pilih **Dalam alarm**.
+ Pilih topik SNS yang ada atau buat yang baru. Jika Anda membuat yang baru, tentukan nama untuk itu dan tambahkan setidaknya satu alamat email ke dalamnya.
1. Pilih **Berikutnya**.
1. Masukkan nama dan deskripsi opsional untuk alarm, lalu pilih **Berikutnya**.
1. Tinjau detailnya dan pilih **Buat alarm**.