Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mempersiapkan pengindeksan armada
Dengan pengindeksan AWS IoT armada, Anda dapat mencari dan mengumpulkan data dengan menggunakan shadow () `$package` bernama reserved. Anda juga dapat mengelompokkan AWS IoT hal-hal dengan menanyakan [grup hal yang dinamis [Cadangan bernama bayangan](preparing-to-use-software-package-catalog.md#reserved-named-shadow) dan dinamis](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html). Misalnya, Anda dapat menemukan informasi tentang AWS IoT hal-hal mana yang menggunakan versi paket tertentu, tidak menginstal versi paket tertentu, atau tidak menginstal versi paket apa pun. Anda dapat memperoleh wawasan lebih lanjut dengan menggabungkan atribut. Misalnya, mengidentifikasi hal-hal yang memiliki versi tertentu dan jenis hal tertentu (seperti versi 1.0.0 dan jenis pump\$1sensor). Untuk informasi selengkapnya, lihat [Pengindeksan armada](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html).
## Mengatur `$package` bayangan sebagai sumber data
Untuk menggunakan pengindeksan armada dengan Katalog Paket Perangkat Lunak, Anda harus mengaktifkan pengindeksan armada, mengatur bayangan bernama sebagai sumber data, dan mendefinisikan `$package` sebagai filter bayangan bernama. Jika Anda belum mengaktifkan pengindeksan armada, Anda dapat mengaktifkannya dalam proses ini. Dari [AWS IoT Core](https://console.aws.amazon.com/iot/home)konsol, buka **Pengaturan**, pilih **Kelola pengindeksan**, lalu **Tambahkan bayangan bernama**, **Tambahkan paket dan versi perangkat lunak perangkat, dan** **Perbarui**. Untuk informasi selengkapnya, lihat [Mengelola pengindeksan hal](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index).
Sebagai alternatif, Anda dapat mengaktifkan pengindeksan armada saat Anda membuat paket pertama Anda. Saat kotak dialog **Aktifkan dependensi untuk manajemen paket** muncul, pilih opsi untuk menambahkan paket perangkat lunak dan versi sebagai sumber data ke pengindeksan armada. Dengan memilih opsi ini, Anda juga mengaktifkan pengindeksan armada.
**catatan**
Mengaktifkan pengindeksan armada untuk Katalog Paket Perangkat Lunak menimbulkan biaya layanan standar. Untuk informasi lebih lanjut, lihat [AWS IoT Device Management, Harga](https://aws.amazon.com/iot-device-management/pricing/).
## Metrik ditampilkan di konsol
![\[Gambar metrik standar\]](http://docs.aws.amazon.com/id_id/iot/latest/developerguide/images/package-catalog-discovery-metrics.png)
Pada halaman detail paket perangkat lunak AWS IoT konsol, panel **Discovery** menampilkan metrik standar yang dicerna melalui bayangan. `$package`
+ Bagan **distribusi versi saat ini** menunjukkan jumlah perangkat dan persentase untuk 10 versi paket terbaru yang terkait dengan AWS IoT sesuatu dari semua perangkat yang terkait dengan paket perangkat lunak ini. **Catatan:** **Jika paket perangkat lunak memiliki lebih banyak versi paket daripada yang berlabel dalam bagan, Anda dapat menemukannya dikelompokkan dalam Lainnya.**
+ **Bagan Historis** menunjukkan jumlah perangkat yang terkait dengan versi paket yang dipilih selama periode waktu tertentu. Bagan awalnya kosong sampai Anda memilih hingga 5 versi paket dan menentukan rentang tanggal dan interval waktu. Untuk memilih parameter bagan, pilih **Pengaturan**. Data yang ditampilkan dalam **bagan Historis** mungkin berbeda dari bagan **distribusi versi saat ini** karena perbedaan jumlah versi paket yang ditampilkan dan juga karena Anda dapat memilih versi paket mana yang akan dianalisis dalam **bagan Historis**. **Catatan:** Saat Anda memilih versi paket untuk divisualisasikan, versi tersebut dihitung dalam jumlah maksimum batas metrik armada. Untuk informasi selengkapnya, lihat [Batas dan kuota pengindeksan armada](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
Untuk metode lain untuk mendapatkan wawasan tentang pengumpulan distribusi versi paket, lihat [Mengumpulkan distribusi versi paket melalui `getBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution).
## Pola kueri
Pengindeksan armada dengan Katalog Paket Perangkat Lunak menggunakan sebagian besar fitur standar yang didukung (seperti istilah, frasa, dan bidang pencarian). Namun, operator perbandingan (misalnya, kurang dari `<` dan lebih besar dari`>`) dan `range` kueri tidak tersedia untuk `version` kunci shadow (`$package`) bernama cadangan. Kueri ini tersedia untuk `attributes` kuncinya. Untuk informasi selengkapnya, lihat [Sintaks kueri](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html).
### Contoh data
**Catatan:** untuk informasi tentang bayangan bernama yang dicadangkan dan strukturnya, lihat [Bayangan bernama cadangan](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow).
Dalam contoh ini, perangkat pertama diberi nama `AnyThing` dan memiliki paket berikut diinstal:
+ Paket perangkat lunak: `SamplePackage`
Versi Package: `1.0.0`
Package ID: `1111`
Bayangan terlihat sebagai berikut:
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
}
}
}
}
```
Perangkat kedua diberi nama `AnotherThing` dan memiliki paket berikut diinstal:
+ Paket perangkat lunak: `SamplePackage`
Versi Package: `1.0.0`
Package ID: `1111`
+ Paket perangkat lunak: `OtherPackage`
Versi Package: `1.2.5`
Package ID: `2222`
Bayangan terlihat sebagai berikut:
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
},
"OtherPackage": {
"version": "1.2.5",
"attributes": {
"s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
"packageID": "2222"
}
},
}
}
}
```
### Kueri Sampel
Tabel berikut mencantumkan contoh kueri berdasarkan contoh bayangan perangkat untuk `AnyThing` dan`AnotherThing`. Untuk informasi selengkapnya, lihat [Contoh kueri hal](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html).
**Versi terbaru dari AWS IoT Device Tester untuk FreeRTOS**
| **Informasi yang diminta** | **Kueri** | **Hasil** |
| --- | --- | --- |
| Hal-hal yang memiliki versi paket tertentu diinstal | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| Hal-hal yang tidak menginstal versi paket tertentu | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| Perangkat apa pun yang menggunakan versi paket yang ID paketnya lebih besar dari 1500 | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| Hal-hal yang memiliki paket tertentu diinstal dan memiliki lebih dari satu paket yang diinstal | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## Mengumpulkan distribusi versi paket melalui `getBucketsAggregation`
Selain panel **Discovery** dalam AWS IoT konsol, Anda juga bisa mendapatkan informasi distribusi versi paket dengan menggunakan operasi [https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html)API. Untuk mendapatkan informasi distribusi versi paket, Anda harus melakukan hal berikut:
+ Tentukan bidang khusus dalam pengindeksan armada untuk setiap paket perangkat lunak. **Catatan:** Membuat bidang kustom dihitung terhadap [kuota layanan pengindeksan AWS IoT armada](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
+ Format bidang kustom sebagai berikut:
`shadow.name.$package.reported..version`
Untuk informasi selengkapnya, lihat bagian [Bidang kustom](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field) dalam pengindeksan AWS IoT armada.