View a markdown version of this page

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) yang dicadangkan. Anda juga dapat mengelompokkan AWS IoT hal-hal dengan menanyakan Cadangan bernama bayangan dan grup https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html benda dinamis. Misalnya, Anda dapat menemukan informasi tentang AWS IoT hal-hal 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 benda tertentu (seperti versi 1.0.0 dan tipe benda pump_sensor). Untuk informasi selengkapnya, lihat Pengindeksan Ar https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html mada.

Mengatur bayangan $package sebagai sumber data

Untuk menggunakan pengindeksan armada dengan Katalog Paket Perangkat Lunak, Anda harus mengaktifkan pengindeksan armada, menetapkan 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 konsol, buka Peng aturan, pilih Kelola pengindeksan, lalu Tambahkan bayangan bernama, Tambahkan paket dan versi perangkat lunak perangkat, dan Per barui. Untuk informasi selengkapnya, lihat Mengel ola pengindeksan benda.

Sebagai alternatif, Anda dapat mengaktifkan pengindeksan armada saat 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 $package bayangan.

  • 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 diberi label dalam bagan, Anda dapat menemukannya dikelompokkan dalam Lainnya.

  • Bagan histor is 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 Peng aturan. Data yang ditampilkan di 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 di bagan Historis. Catatan: Saat Anda memilih versi paket untuk divisualisasikan, itu dihitung terhadap jumlah maksimum batas metrik armada. Untuk informasi selengkapnya, lihat B atas dan kuota pengindeksan Armada.

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

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 bernama shadow ($package) yang dicadangkan. Kueri ini tersedia untuk attributes kunci. Untuk informasi selengkapnya, lihat Sintak s kueri.

Contoh data

Catatan: untuk informasi tentang bayangan bernama cadangan dan strukturnya, lihat Cadangan bernama Cadangan.

Dalam contoh ini, perangkat pertama diberi nama AnyThing dan memiliki paket berikut yang diinstal:

  • Paket perangkat lunak: SamplePackage

    Versi paket: 1.0.0

    Paket 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 yang diinstal:

  • Paket perangkat lunak: SamplePackage

    Versi paket: 1.0.0

    Paket ID: 1111

  • Paket perangkat lunak: OtherPackage

    Versi paket: 1.2.5

    Paket 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 untuk FreeRTOS

Informasi yang diminta

Kueri

Hasil

Hal-hal yang memiliki versi paket tertentu yang diinstal

shadow.name.$package.reported.SamplePackage.version:1.0.0

AnyThing, OtherThing

Hal-hal yang tidak memiliki versi paket tertentu yang 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 yang diinstal

shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2

OtherThing

Mengumpulkan distribusi versi paket melalui get BucketsAggregation

Selain panel Discovery di dalam AWS IoT konsol, Anda juga bisa mendapatkan informasi distribusi versi paket dengan menggunakan operasi GetBucketsAggregation 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 khusus diperhitungkan dalam kuota layanan pengindeksan AWS IoT armada.

  • Format bidang kustom sebagai berikut:

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

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