Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola metrik armada
Topik ini menunjukkan cara menggunakan AWS IoT konsol dan AWS CLI mengelola metrik armada Anda.
**Topics**
+ [Mengelola metrik armada (Konsol)](#managing-fleet-metrics-console)
+ [Mengelola metrik armada (CLI)](#managing-fleet-metrics-cli)
+ [Otorisasi penandaan sumber daya IoT](#managing-fleet-metrics-policy)
## Mengelola metrik armada (Konsol)
Bagian berikut menunjukkan cara menggunakan AWS IoT konsol untuk mengelola metrik armada Anda. Pastikan Anda telah mengaktifkan pengindeksan armada dengan sumber dan konfigurasi data terkait sebelum membuat metrik armada.
### Aktifkan pengindeksan armada
Jika Anda telah mengaktifkan pengindeksan armada, lewati bagian ini.
Jika Anda belum mengaktifkan pengindeksan armada, ikuti petunjuk ini.
1. Buka AWS IoT konsol Anda di [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).
1. Pada AWS IoT menu, pilih **Pengaturan**.
1. Untuk melihat pengaturan terperinci, pada halaman **Pengaturan**, gulir ke bawah ke bagian **pengindeksan Armada**.
1. Untuk memperbarui pengaturan pengindeksan armada, di sebelah kanan bagian **pengindeksan Armada, pilih **Kelola** pengindeksan**.
1. Pada halaman **Kelola pengindeksan armada**, perbarui pengaturan pengindeksan armada berdasarkan kebutuhan Anda.
+ **Konfigurasi**
Untuk mengaktifkan pengindeksan hal, aktifkan **pengindeksan Thing**, lalu pilih sumber data yang ingin Anda indeks.
Untuk mengaktifkan pengindeksan grup hal, aktifkan pengindeksan **grup Thing**.
+ ***Bidang kustom untuk agregasi - opsional***
Bidang kustom adalah daftar nama bidang dan pasangan jenis bidang.
Untuk menambahkan pasangan bidang kustom, pilih **Tambahkan bidang baru**. Masukkan nama bidang khusus seperti`attributes.temperature`, lalu pilih jenis bidang dari menu **Jenis bidang**. Perhatikan bahwa nama bidang kustom dimulai dengan `attributes.` dan akan disimpan sebagai atribut untuk menjalankan kueri [agregasi hal](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html).
Untuk memperbarui dan menyimpan pengaturan, pilih **Perbarui**.
### Buat metrik armada
1. Buka AWS IoT konsol Anda di [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).
1. Pada AWS IoT menu, pilih **Kelola**, lalu pilih **Metrik Armada**.
1. Pada halaman **Metrik Armada**, pilih **Buat metrik armada** dan selesaikan langkah pembuatannya.
1. Pada langkah 1 **Konfigurasikan metrik armada**
+ Di bagian **Kueri**, masukkan string kueri untuk menentukan hal-hal atau kelompok hal yang ingin Anda lakukan pencarian agregat. String query terdiri dari atribut dan nilai. Untuk **Properti**, pilih atribut yang Anda inginkan, atau, jika tidak muncul dalam daftar, masukkan atribut di bidang. Masukkan nilai setelahnya`:`. Sebuah string query contoh bisa`thingName:TempSensor*`. Untuk setiap string kueri yang Anda masukkan, tekan **enter** di keyboard Anda. Jika Anda memasukkan beberapa string kueri, tentukan hubungannya dengan memilih **dan**, **atau**, **dan tidak**, atau **atau tidak** di antara mereka.
+ Di **properti Laporan**, pilih **Nama indeks**, **Jenis agregasi**, dan **bidang Agregasi** dari daftar masing-masing. Selanjutnya, pilih data yang ingin Anda agregat **Pilih data**, di mana Anda dapat memilih beberapa nilai data.
+ Pilih **Berikutnya**.
1. Pada langkah 2 **Tentukan properti metrik armada**
+ Di bidang **nama metrik Armada**, masukkan nama untuk metrik armada yang Anda buat.
+ Di **Deskripsi - bidang *opsional***, masukkan deskripsi untuk metrik armada yang Anda buat. Bidang ini bersifat opsional.
+ Di bidang **Jam** dan **Menit**, masukkan waktu (seberapa sering) metrik armada yang Anda inginkan untuk memancarkan data. CloudWatch
+ Pilih **Berikutnya**.
1. Pada langkah 3 **Tinjau dan buat**
+ Tinjau pengaturan langkah 1 dan langkah 2. Untuk mengedit pengaturan, pilih **Edit**.
+ Pilih **Buat metrik armada**.
Setelah pembuatan berhasil, metrik armada terdaftar di halaman **metrik Armada**.
### Memperbarui metrik armada
1. Pada halaman **metrik Armada**, pilih metrik armada yang ingin Anda perbarui.
1. Pada halaman **Detail** metrik armada, pilih **Edit**. Ini membuka langkah-langkah pembuatan di mana Anda dapat memperbarui metrik armada Anda di salah satu dari tiga langkah.
1. Setelah Anda selesai memperbarui metrik armada, pilih **Perbarui metrik armada**.
### Hapus metrik armada
1. Pada halaman **metrik Armada**, pilih metrik armada yang ingin Anda hapus.
1. Pada halaman berikutnya yang menampilkan detail metrik armada Anda, pilih **Hapus**.
1. Di kotak dialog, masukkan nama metrik armada Anda untuk mengonfirmasi penghapusan.
1. Pilih **Hapus**. Langkah ini menghapus metrik armada Anda secara permanen.
## Mengelola metrik armada (CLI)
Bagian berikut menunjukkan cara menggunakan metrik AWS CLI untuk mengelola armada Anda. Pastikan Anda telah mengaktifkan pengindeksan armada dengan sumber dan konfigurasi data terkait sebelum membuat metrik armada. Untuk mengaktifkan pengindeksan armada untuk hal-hal atau grup benda Anda, ikuti instruksi dalam [Mengelola pengindeksan hal atau Mengelola pengindeksan](managing-index.md#enable-index) [grup hal](thinggroup-index.md#enable-group-index).
### Buat metrik armada
Anda dapat menggunakan perintah create-fleet-metric CLI untuk membuat metrik armada.
```
aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum
```
Output dari perintah ini berisi nama dan Amazon Resource Name (ARN) dari metrik armada Anda. Outputnya terlihat seperti berikut:
```
{
"metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName",
"metricName": "YourFleetMetricName"
}
```
### Daftar metrik armada
Anda dapat menggunakan perintah list-fleet-metric CLI untuk mencantumkan semua metrik armada di akun Anda.
```
aws iot list-fleet-metrics
```
Output dari perintah ini berisi semua metrik armada Anda. Outputnya terlihat seperti berikut:
```
{
"fleetMetrics": [
{
"metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1",
"metricName": "YourFleetMetric1"
},
{
"metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2",
"metricName": "YourFleetMetric2"
}
]
}
```
### Jelaskan metrik armada
Anda dapat menggunakan perintah describe-fleet-metric CLI untuk menampilkan informasi lebih rinci tentang metrik armada.
```
aws iot describe-fleet-metric --metric-name "YourFleetMetricName"
```
Output dari perintah berisi informasi rinci tentang metrik armada yang ditentukan. Outputnya terlihat seperti berikut:
```
{
"queryVersion": "2017-09-30",
"lastModifiedDate": 1625790642.355,
"queryString": "*",
"period": 60,
"metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName",
"aggregationField": "registry.version",
"version": 1,
"aggregationType": {
"values": [
"sum"
],
"name": "Statistics"
},
"indexName": "AWS_Things",
"creationDate": 1625790642.355,
"metricName": "YourFleetMetricName"
}
```
### Memperbarui metrik armada
Anda dapat menggunakan perintah update-fleet-metric CLI untuk memperbarui metrik armada.
```
aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things
```
update-fleet-metricPerintah tidak menghasilkan output apa pun. Anda dapat menggunakan perintah describe-fleet-metric CLI untuk melihat hasilnya.
```
{
"queryVersion": "2017-09-30",
"lastModifiedDate": 1625792300.881,
"queryString": "*",
"period": 120,
"metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName",
"aggregationField": "registry.version",
"version": 2,
"aggregationType": {
"values": [
"sum",
"count"
],
"name": "Statistics"
},
"indexName": "AWS_Things",
"creationDate": 1625792300.881,
"metricName": "YourFleetMetricName"
}
```
### Hapus metrik armada
Gunakan perintah delete-fleet-metric CLI untuk menghapus metrik armada.
```
aws iot delete-fleet-metric --metric-name "YourFleetMetricName"
```
Perintah ini tidak menghasilkan output apa pun jika penghapusan berhasil atau jika Anda menentukan metrik armada yang tidak ada.
Untuk informasi selengkapnya, lihat [Memecahkan masalah metrik armada](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting).
## Otorisasi penandaan sumber daya IoT
Untuk kontrol yang lebih baik atas metrik armada yang dapat Anda buat, modifikasi, atau gunakan, Anda dapat melampirkan tag ke metrik armada.
Untuk menandai metrik armada yang Anda buat dengan menggunakan Konsol Manajemen AWS atau AWS CLI, Anda harus menyertakan `iot:TagResource` tindakan dalam kebijakan IAM untuk memberikan izin kepada pengguna. Jika kebijakan IAM Anda tidak disertakan`iot:TagResource`, tindakan apa pun untuk membuat metrik armada dengan tag akan menampilkan `AccessDeniedException` kesalahan.
Untuk informasi umum tentang menandai sumber daya Anda, lihat [Menandai sumber daya Anda AWS IoT](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html).
### Contoh kebijakan IAM
Lihat contoh kebijakan IAM berikut yang memberikan izin penandaan saat Anda membuat metrik armada:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"iot:TagResource"
],
"Effect": "Allow",
"Resource": [
"arn:aws:iot:*:*:fleetmetric/*"
]
},
{
"Action": [
"iot:CreateFleetMetric"
],
"Effect": "Allow",
"Resource": [
"arn:aws:iot:*:*:index/*",
"arn:aws:iot:*:*:fleetmetric/*"
]
}
]
}
```
Untuk informasi lebih lanjut, lihat [Tindakan, sumber daya, kunci syarat untuk AWS IoT](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html).