Mempersiapkan pengindeksan armada - AWS IoT Core

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 dan dinamis. 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_sensor). Untuk informasi selengkapnya, lihat Pengindeksan armada.

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 Corekonsol, 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.

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.

Metrik ditampilkan di konsol

Gambar metrik standar

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.

Untuk metode lain untuk mendapatkan wawasan tentang pengumpulan distribusi versi paket, lihat Mengumpulkan distribusi versi paket melalui getBucketsAggregation.

Pola kueri

Pengindeksan armada dengan Katalog Paket Perangkat Lunak menggunakan sebagian besar fitur yang didukung (misalnya, istilah dan frasa dan bidang pencarian) yang merupakan standar untuk pengindeksan armada. Pengecualiannya adalah bahwa range kueri comparison dan tidak tersedia untuk version kunci shadow ($package) bernama yang dicadangkan. Namun, kueri ini tersedia untuk attributes kuncinya. Untuk informasi selengkapnya, lihat Sintaks kueri.

Contoh data

Catatan: untuk informasi tentang bayangan bernama yang dicadangkan dan strukturnya, lihat Bayangan bernama cadangan.

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 danAnotherThing. Untuk informasi selengkapnya, lihat Contoh kueri hal.

Versi terbaru dari AWS IoT Device Tester For Free RTOS

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 memiliki versi paket tertentu diinstal

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 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 di dalam AWS IoT konsol, Anda juga bisa mendapatkan informasi distribusi versi paket dengan menggunakan GetBucketsAggregationAPIoperasi. 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.

  • Format bidang kustom sebagai berikut:

    shadow.name.$package.reported.<packageName>.version

Untuk informasi selengkapnya, lihat bagian Bidang kustom dalam pengindeksan AWS IoT armada.