Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Metrik-metrik kustom
Dengan metrik AWS IoT Device Defender khusus, Anda dapat menentukan dan memantau metrik yang unik untuk armada atau kasus penggunaan Anda, seperti jumlah perangkat yang terhubung ke gateway Wi-Fi, tingkat pengisian daya untuk baterai, atau jumlah siklus daya untuk colokan pintar. Perilaku metrik kustom didefinisikan dalam Profil Keamanan, yang menentukan perilaku yang diharapkan untuk sekelompok perangkat (grup benda) atau untuk semua perangkat. Anda dapat memantau perilaku dengan mengatur alarm, yang dapat Anda gunakan untuk mendeteksi dan merespons masalah yang spesifik pada perangkat.
**Topics**
+ [Cara menggunakan metrik khusus di konsol](#dd-detect-custom-metrics-how-to-console)
+ [Cara menggunakan metrik khusus dari CLI](#dd-detect-custom-metrics-how-to-cli)
+ [Perintah CLI metrik khusus](#dd-detect-custom-metrics-cli-commands)
+ [Metrik kustom APIs](#dd-detect-custom-metrics-apis)
## Cara menggunakan metrik khusus di konsol
**Topics**
+ [AWS IoT Device Defender Agen SDK (Python)](#dd-detect-custom-metrics-device-agent)
+ [Buat metrik khusus dan tambahkan ke Profil Keamanan](#dd-detect-console-create)
+ [Lihat detail metrik khusus](#dd-detect-console-read)
+ [Perbarui metrik khusus](#dd-detect-console-edit)
+ [Hapus metrik kustom](#dd-detect-console-delete)
### AWS IoT Device Defender Agen SDK (Python)
Untuk memulai, unduh AWS IoT Device Defender agen sampel Agen SDK (Python). Agen mengumpulkan metrik dan menerbitkan laporan. Setelah metrik sisi perangkat dipublikasikan, Anda dapat melihat metrik yang dikumpulkan dan menentukan ambang batas untuk menyiapkan alarm. Petunjuk untuk menyiapkan agen perangkat tersedia di Device [Defender Agent SDK (Python](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python/blob/master/README.rst)) Readme.AWS IoT Untuk informasi selengkapnya, lihat [AWS IoT Device Defender Agen SDK (Python)](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python).
### Buat metrik khusus dan tambahkan ke Profil Keamanan
Prosedur berikut menunjukkan cara membuat metrik khusus di konsol.
1. Di [AWS IoT konsol](https://console.aws.amazon.com/iot), di panel navigasi, perluas **Defend**, lalu pilih **Detect**, **Metrics**.
1. Pada halaman **Metrik kustom**, pilih **Buat**.
1. Pada halaman **Buat metrik kustom**, lakukan hal berikut.
1. Di bawah **Nama**, masukkan nama untuk metrik kustom Anda. Anda tidak dapat mengubah nama ini setelah membuat metrik kustom.
1. Di bawah **Nama tampilan (opsional)**, Anda dapat memasukkan nama ramah untuk metrik kustom Anda. Itu tidak harus unik dan dapat dimodifikasi setelah pembuatan.
1. Di bawah **Jenis**, pilih jenis metrik yang ingin Anda pantau. **Jenis metrik termasuk **daftar string,, daftar** **nomor **ip-address-list**, dan angka**.** Jenis tidak dapat dimodifikasi setelah pembuatan.
**catatan**
Deteksi ML hanya memungkinkan jenis **nomor**.
1. Di bawah **Tag**, Anda dapat memilih tag yang akan dikaitkan dengan sumber daya.
Setelah selesai, pilih **Konfirmasi**.
1. Setelah membuat metrik kustom, halaman **Metrik kustom** akan muncul, di mana Anda dapat melihat metrik kustom yang baru dibuat.
1. Selanjutnya, Anda perlu menambahkan metrik kustom Anda ke Profil Keamanan. Di [AWS IoT konsol](https://console.aws.amazon.com/iot), di panel navigasi, perluas **Defend**, lalu pilih **Detect**, **Security profiles**.
1. Pilih Profil Keamanan yang ingin Anda tambahkan metrik kustom.
1. Pilih **Tindakan**, **Edit**.
1. Pilih **Metrik Tambahan untuk dipertahankan**, lalu pilih metrik kustom Anda. Pilih **Berikutnya** di layar berikut hingga Anda mencapai halaman **Konfirmasi**. Pilih **Simpan** dan **Lanjutkan**. Setelah metrik kustom Anda berhasil ditambahkan, halaman detail Profil Keamanan akan muncul.
**catatan**
Statistik persentil tidak tersedia untuk metrik ketika nilai metrik merupakan angka negatif.
### Lihat detail metrik khusus
Prosedur berikut menunjukkan cara melihat detail metrik kustom di konsol.
1. Di [AWS IoT konsol](https://console.aws.amazon.com/iot), di panel navigasi, perluas **Defend**, lalu pilih **Detect**, **Metrics**.
1. Pilih **nama Metrik** dari metrik kustom yang ingin Anda lihat detailnya.
### Perbarui metrik khusus
Prosedur berikut menunjukkan cara memperbarui metrik khusus di konsol.
1. Di [AWS IoT konsol](https://console.aws.amazon.com/iot), di panel navigasi, perluas **Defend**, lalu pilih **Detect**, **Metrics**.
1. Pilih tombol opsi di sebelah metrik khusus yang ingin Anda perbarui. Kemudian, untuk **Tindakan**, pilih **Edit**.
1. Pada halaman **Perbarui metrik kustom**, Anda dapat mengedit nama tampilan dan menghapus atau menambahkan tag.
1. Setelah selesai, pilih **Perbarui**. Halaman **metrik kustom**.
### Hapus metrik kustom
Prosedur berikut menunjukkan cara menghapus metrik khusus di konsol.
1. Pertama, hapus metrik kustom Anda dari Profil Keamanan yang direferensikan. Anda dapat melihat Profil Keamanan mana yang berisi metrik kustom Anda di halaman detail metrik kustom Anda. Di [AWS IoT konsol](https://console.aws.amazon.com/iot), di panel navigasi, perluas **Defend**, lalu pilih **Detect**, **Metrics**.
1. Pilih metrik khusus yang ingin Anda hapus. Hapus metrik kustom dari Profil Keamanan apa pun yang tercantum di bawah **Profil Keamanan** pada halaman detail metrik kustom.
1. Di [AWS IoT konsol](https://console.aws.amazon.com/iot), di panel navigasi, perluas **Defend**, lalu pilih **Detect**, **Metrics**.
1. Pilih tombol opsi di sebelah metrik khusus yang ingin Anda hapus. Kemudian, untuk **Tindakan**, pilih **Hapus**.
1. Di **Apakah Anda yakin ingin menghapus metrik khusus?** pesan, pilih **Hapus metrik kustom**.
**Awas**
Setelah menghapus metrik kustom, Anda kehilangan semua data yang terkait dengan metrik. Tindakan ini tidak dapat dibatalkan.
## Cara menggunakan metrik khusus dari CLI
**Topics**
+ [AWS IoT Device Defender Agen SDK (Python)](#dd-detec-custom-metrics-cli-sdk)
+ [Buat metrik khusus dan tambahkan ke Profil Keamanan](#dd-detect-custom-cli-create)
+ [Lihat detail metrik khusus](#dd-detect-custom-cli-read)
+ [Perbarui metrik khusus](#dd-detect-custom-cli-edit)
+ [Hapus metrik kustom](#dd-detect-custom-cli-delete)
### AWS IoT Device Defender Agen SDK (Python)
Untuk memulai, unduh AWS IoT Device Defender agen sampel Agen SDK (Python). Agen mengumpulkan metrik dan menerbitkan laporan. Setelah metrik sisi perangkat dipublikasikan, Anda dapat melihat metrik yang dikumpulkan dan menentukan ambang batas untuk menyiapkan alarm. Petunjuk untuk menyiapkan agen perangkat tersedia di Device [Defender Agent SDK (Python](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python/blob/master/README.rst)) Readme.AWS IoT Untuk informasi selengkapnya, lihat [AWS IoT Device Defender Agen SDK (Python)](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python).
### Buat metrik khusus dan tambahkan ke Profil Keamanan
Prosedur berikut menunjukkan cara membuat metrik khusus dan menambahkannya ke Profil Keamanan dari CLI.
1. Gunakan `[create-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/create-custom-metric.html)` perintah untuk membuat metrik kustom Anda. Contoh berikut membuat metrik kustom yang mengukur persentase baterai.
```
aws iot create-custom-metric \
--metric-name "batteryPercentage" \
--metric-type "number" \
--display-name "Remaining battery percentage." \
--region us-east-1
--client-request-token "02ccb92b-33e8-4dfa-a0c1-35b181ed26b0" \
```
Output:
```
{
"metricName": "batteryPercentage",
"metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage"
}
```
1. Setelah membuat metrik kustom, Anda dapat menambahkan metrik kustom ke profil yang ada menggunakan `[update-security-profile](https://docs.aws.amazon.com/cli/latest/reference/iot/update-security-profile.html)` atau membuat profil keamanan baru untuk menambahkan metrik kustom untuk digunakan`[create-security-profile](https://docs.aws.amazon.com/cli/latest/reference/iot/create-security-profile.html)`. Di sini, kami membuat profil keamanan baru yang dipanggil *batteryUsage* untuk menambahkan metrik *batteryPercentage* kustom baru kami. Kami juga menambahkan metrik Rules Detect yang disebut*cellularBandwidth*.
```
aws iot create-security-profile \
--security-profile-name batteryUsage \
--security-profile-description "Shows how much battery is left in percentile." \
--behaviors "[{\"name\":\"great-than-75\",\"metric\":\"batteryPercentage\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"number\":75},\"consecutiveDatapointsToAlarm\":5,\"consecutiveDatapointsToClear\":1}},{\"name\":\"cellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]" \
--region us-east-1
```
Output:
```
{
"securityProfileArn": "arn:aws:iot:us-east-1:1234564789012:securityprofile/batteryUsage",
"securityProfileName": "batteryUsage"
}
```
**catatan**
Statistik persentil tidak tersedia untuk metrik ketika nilai metrik merupakan angka negatif.
### Lihat detail metrik khusus
Prosedur berikut menunjukkan kepada Anda cara melihat detail untuk metrik khusus dari CLI.
+ Gunakan `[list-custom-metrics](https://docs.aws.amazon.com/cli/latest/reference/iot/list-custom-metrics.html)` perintah untuk melihat semua metrik kustom Anda.
```
aws iot list-custom-metrics \
--region us-east-1
```
Hasil akhir dari perintah ini adalah sebagai berikut.
```
{
"metricNames": [
"batteryPercentage"
]
}
```
### Perbarui metrik khusus
Prosedur berikut menunjukkan cara memperbarui metrik khusus dari CLI.
+ Gunakan `[update-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/update-custom-metric.html)` perintah untuk memperbarui metrik khusus. Contoh berikut memperbarui`display-name`.
```
aws iot update-custom-metric \
--metric-name batteryPercentage \
--display-name 'remaining battery percentage on device' \
--region us-east-1
```
Hasil akhir dari perintah ini adalah sebagai berikut.
```
{
"metricName": "batteryPercentage",
"metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage",
"metricType": "number",
"displayName": "remaining battery percentage on device",
"creationDate": "2020-11-17T23:01:35.110000-08:00",
"lastModifiedDate": "2020-11-17T23:02:12.879000-08:00"
}
```
### Hapus metrik kustom
Prosedur berikut menunjukkan cara menghapus metrik khusus dari CLI.
1. Untuk menghapus metrik kustom, pertama-tama hapus dari Profil Keamanan apa pun yang dilampirkan. Gunakan `[list-security-profiles](https://docs.aws.amazon.com/cli/latest/reference/iot/list-security-profiles.html)` perintah untuk melihat Profil Keamanan dengan metrik kustom tertentu.
1. Untuk menghapus metrik kustom dari Profil Keamanan, gunakan `[update-security-profiles](https://docs.aws.amazon.com/cli/latest/reference/iot/update-security-profiles.html)` perintah. Masukkan semua informasi yang ingin Anda simpan, tetapi kecualikan metrik khusus.
```
aws iot update-security-profile \
--security-profile-name batteryUsage \
--behaviors "[{\"name\":\"cellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"
```
Hasil akhir dari perintah ini adalah sebagai berikut.
```
{
"behaviors": [{\"name\":\"cellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}],
"securityProfileName": "batteryUsage",
"lastModifiedDate": 2020-11-17T23:02:12.879000-09:00,
"securityProfileDescription": "Shows how much battery is left in percentile.",
"version": 2,
"securityProfileArn": "arn:aws:iot:us-east-1:1234564789012:securityprofile/batteryUsage",
"creationDate": 2020-11-17T23:02:12.879000-09:00
}
```
1. Setelah metrik kustom terlepas, gunakan `[delete-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-custom-metric.html)` perintah untuk menghapus metrik kustom.
```
aws iot delete-custom-metric \
--metric-name batteryPercentage \
--region us-east-1
```
Output dari perintah ini terlihat seperti berikut
```
HTTP 200
```
## Perintah CLI metrik khusus
Anda dapat menggunakan perintah CLI berikut untuk membuat dan mengelola metrik kustom.
+ [create-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/create-custom-metric.html)
+ [describe-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/describe-custom-metric.html)
+ [list-custom-metrics](https://docs.aws.amazon.com/cli/latest/reference/iot/list-custom-metrics.html)
+ [update-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/update-custom-metric.html)
+ [delete-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-custom-metric.html)
+ [list-security-profiles](https://docs.aws.amazon.com/cli/latest/reference/iot/list-security-profiles.html)
## Metrik kustom APIs
Berikut ini APIs dapat digunakan untuk membuat dan mengelola metrik kustom.
+ [CreateCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCustomMetric.html)
+ [DescribeCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCustomMetric.html)
+ [ListCustomMetrics](https://docs.aws.amazon.com/iot/latest/apireference/API_ListCustomMetrics.html)
+ [UpdateCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCustomMetric.html)
+ [DeleteCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCustomMetric.html)
+ [ListSecurityProfiles](https://docs.aws.amazon.com/iot/latest/apireference/API_ListSecurityProfiles.html)