View a markdown version of this page

Mengelola pengindeksan armada - AWS IoT Core
Pengindeksan bendaPengindeksan kelompok bendaBidang yang dikelolaBidang kustom

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengelola pengindeksan armada

Pengindeksan armada mengelola dua jenis indeks untuk Anda: pengindeksan benda dan pengindeksan grup benda.

Pengindeksan benda

Indeks yang dibuat untuk semua hal Anda disebutAWS_Things. Pengindeksan hal mendukung sumber data berikut: data AWS IoT registri, data AWS IoT Device Shadow, data AWS IoT konektivitas, dan data AWS IoT Device Defender pelanggaran. Dengan menambahkan sumber data ini ke konfigurasi pengindeksan armada Anda, Anda dapat mencari hal-hal, menanyakan data agregat, dan membuat grup benda dinamis dan metrik armada berdasarkan kueri penelusuran Anda.

Registri - AWS IoT menyediakan registri yang membantu Anda mengelola berbagai hal. Anda dapat menambahkan data registri ke konfigurasi pengindeksan armada untuk mencari perangkat berdasarkan nama benda, deskripsi, dan atribut registri lainnya. Untuk informasi selengkapnya tentang registri, lihat Cara mengelola hal-hal dengan registri.

Bayangan - Layanan AWS IoT Device Shadow menyediakan bayangan yang membantu Anda menyimpan data status perangkat Anda. Pengindeksan benda mendukung bayangan klasik tanpa nama dan bayangan bernama. Untuk mengindeks bayangan bernama, aktifkan pengaturan bayangan bernama Anda dan tentukan nama bayangan Anda dalam konfigurasi pengindeksan benda. Secara default, Anda dapat menambahkan hingga 10 nama bayangan per Akun AWS. Untuk melihat cara meningkatkan jumlah batas nama bayangan, lihat Ku AWS IoT Device Management ota di Refer AWS ensi Umum.

Untuk menambahkan bayangan bernama untuk pengindeksan:

  • Jika Anda menggunakan AWS IoT konsol, aktifkan pengindeksan Thing, pilih Tambahkan bayangan bernama, dan tambahkan nama bayangan Anda melalui pemilihan bayangan bernama.

  • Jika Anda menggunakan AWS Command Line Interface (AWS CLI), setel namedShadowIndexingMode menjadiON, dan tentukan nama bayangan di IndexingFilter. Untuk melihat contoh perintah CLI, lihat M engelola pengindeksan benda.

Untuk informasi selengkapnya tentang bayangan, lihat Layanan AWS IoT Device Shadow.

Konektivitas - Data konektivitas perangkat membantu Anda mengidentifikasi status koneksi perangkat Anda. Data konektivitas ini didorong oleh peristiwa siklus hidup. Ketika klien terhubung atau memutuskan sambungan, AWS IoT menerbitkan peristiwa siklus hidup dengan pesan ke topik MQTT. Pesan sambungkan atau pemutusan dapat berupa daftar elemen JSON yang memberikan rincian status koneksi, termasuk ID klien, durasi keep-alive, bendera sesi bersih, dan kedaluwarsa sesi. Untuk informasi selengkapnya tentang konektivitas perangkat, lihat Per istiwa siklus hidup.

Pelanggaran Device Defender - data AWS IoT Device Defender pelanggaran membantu mengidentifikasi perilaku perangkat yang tidak normal terhadap perilaku normal yang Anda tetapkan dalam Profil Keamanan. Profil Keamanan berisi serangkaian perilaku perangkat yang diharapkan. Setiap perilaku menggunakan metrik yang menentukan perilaku normal perangkat Anda. Untuk informasi selengkapnya tentang pelanggaran Device Defender, lihat AWS IoT Device Defender mendeteksi.

Untuk informasi selengkapnya, lihat M engelola pengindeksan benda.

Pengindeksan kelompok benda

AWS_ThingGroupsadalah indeks yang berisi semua grup benda Anda. Anda dapat menggunakan indeks ini untuk mencari grup berdasarkan nama grup, deskripsi, atribut, dan semua nama grup induk.

Untuk informasi selengkapnya, lihat M engelola pengindeksan grup benda.

Bidang yang dikelola

Bidang terkelola berisi data yang terkait dengan hal-hal, grup benda, bayangan perangkat, konektivitas perangkat, dan pelanggaran Device Defender. AWS IoT mendefinisikan tipe data di bidang yang dikelola. Anda menentukan nilai dari setiap bidang yang dikelola saat Anda membuat AWS IoT sesuatu. Misalnya, nama benda, grup benda, dan deskripsi benda semuanya adalah bidang yang dikelola. Indeks pengindeksan armada menampilkan bidang yang dikelola berdasarkan mode pengindeksan yang Anda tentukan. Bidang yang dikelola tidak dapat diubah atau muncul dicustomFields. Untuk informasi selengkapnya, lihat Bid ang kustom.

Berikut ini mencantumkan bidang yang dikelola untuk pengindeksan benda:

  • Bidang yang dikelola untuk registri

    "managedFields" : [
  {name:thingId, type:String},
  {name:thingName, type:String},
  {name:registry.version, type:Number},
  {name:registry.thingTypeName, type:String},
  {name:registry.thingGroupNames, type:String},
]

  • Bidang terkelola untuk bayangan klasik tanpa nama

    "managedFields" : [
  {name:shadow.version, type:Number},
  {name:shadow.hasDelta, type:Boolean}
]

  • Bidang yang dikelola untuk bayangan bernama

    "managedFields" : [
  {name:shadow.name.shadowName.version, type:Number},
  {name:shadow.name.shadowName.hasDelta, type:Boolean}
]

  • Bidang terkelola untuk konektivitas benda

    "managedFields" : [
  {name:connectivity.timestamp, type:Number},
  {name:connectivity.version, type:Number},
  {name:connectivity.connected, type:Boolean},
  {name:connectivity.disconnectReason, type:String},
  {name:connectivity.clientId, type:String},
  {name:connectivity.keepAliveDuration, type:Number},
  {name:connectivity.cleanSession, type:Boolean},
  {name:connectivity.sessionExpiry, type:Number}
]

  • Bidang terkelola untuk Device Defender

    "managedFields" : [
  {name:deviceDefender.violationCount, type:Number},
  {name:deviceDefender.securityprofile.behaviorname.metricName, type:String},
  {name:deviceDefender.securityprofile.behaviorname.lastViolationTime, type:Number},
  {name:deviceDefender.securityprofile.behaviorname.lastViolationValue, type:String},
  {name:deviceDefender.securityprofile.behaviorname.inViolation, type:Boolean}
]

  • Bidang yang dikelola untuk grup benda

    "managedFields" : [
  {name:description, type:String},
  {name:parentGroupNames, type:String},
  {name:thingGroupId, type:String},
  {name:thingGroupName, type:String},
  {name:version, type:Number},
]

Tabel berikut mencantumkan bidang terkelola yang tidak dapat dicari.

Sumber data Bidang terkelola yang tidak dapat dicari
Registri registry.version
Bayangan tanpa nama shadow.version
Bayangan bernama shadow.name.*.version
Pertahanan Perangkat deviceDefender.version
Grup benda version

Bidang kustom

Anda dapat menggabungkan atribut benda, data Device Shadow, dan data pelanggaran Device Defender dengan membuat bidang khusus untuk mengindeksnya. A customFields tribut adalah daftar nama bidang dan pasangan tipe data. Anda dapat melakukan kueri agregasi berdasarkan tipe data. Mode pengindeksan yang Anda pilih memengaruhi bidang dapat ditentukan dicustomFields. Misalnya, jika Anda menentukan mode peng REGISTRY indeksan, Anda tidak dapat menentukan bidang kustom dari bayangan benda. Anda dapat menggunakan perintah update-indexing-configuration CLI untuk membuat atau memperbarui bidang kustom (lihat contoh perintah dalam Memper barui contoh konfigurasi pengindeksan).

Nama bidang kustom

Nama bidang khusus untuk atribut grup benda dan benda dimulai denganattributes., diikuti oleh nama atribut. Jika pengindeksan bayangan tanpa nama aktif, hal-hal dapat memiliki nama bidang khusus yang dimulai dengan shadow.desired ataushadow.reported, diikuti oleh nama nilai data bayangan yang tidak disebutkan namanya. Jika pengindeksan bayangan bernama aktif, hal-hal dapat memiliki nama bidang khusus yang dimulai dengan shadow.name.*.desired. ataushadow.name.*.reported., diikuti oleh nilai data bayangan bernama. Jika pengindeksan pelanggaran Device Defender aktif, hal-hal dapat memiliki nama bidang khusus yang dimulai dengandeviceDefender., diikuti oleh nilai data pelanggaran Device Defender.

Nama atribut atau nilai data yang mengikuti awalan hanya dapat memiliki karakter alfanumerik, - (tanda hubung), dan _ (garis bawah). Itu tidak bisa memiliki spasi.

Jika ada inkonsistensi tipe antara bidang kustom dalam konfigurasi Anda dan nilai yang diindeks, pengindeksan armada mengabaikan nilai yang tidak konsisten untuk kueri agregasi. CloudWatch Log sangat membantu saat memecahkan masalah kueri agregasi. Untuk informasi selengkapnya, lihat Memecahkan masalah kueri agregasi untuk layanan pengindeksan armada.

Jenis bidang khusus

Jenis bidang kustom memiliki nilai yang didukung berikut:Number,String, danBoolean.