Mengelola pengindeksan armada

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

Pengindeksan hal

Indeks yang dibuat untuk semua barang 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 Defenderpelanggaran. Dengan menambahkan sumber data ini ke konfigurasi pengindeksan armada, Anda dapat mencari sesuatu, meminta data agregat, dan membuat grup benda dinamis dan metrik armada berdasarkan kueri penelusuran Anda.

Registry -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 sesuatu dengan registri.

Shadow -Layanan AWS IoT Device Shadow menyediakan bayangan yang membantu Anda menyimpan data status perangkat Anda. Pengindeksan hal 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 AWS IoT Device Management Kuota di Referensi AWS 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), atur namedShadowIndexingMode menjadiON, dan tentukan nama bayangan di IndexingFilter. Untuk melihat contoh perintah CLI, lihat Mengelola pengindeksan hal.

penting

20 Juli 2022 adalah rilis General Availability (GA) dari integrasi pengindeksan armada Manajemen AWS IoT Perangkat dengan bayangan AWS IoT Core bernama dan AWS IoT Device Defender mendeteksi pelanggaran. Dengan rilis GA ini, Anda dapat mengindeks bayangan bernama tertentu dengan menentukan nama bayangan. Jika Anda menambahkan bayangan bernama untuk pengindeksan selama periode pratinjau publik fitur ini dari 30 November 2021 hingga 19 Juli 2022, kami mendorong Anda untuk mengonfigurasi ulang pengaturan pengindeksan armada Anda dan memilih nama bayangan tertentu untuk mengurangi biaya pengindeksan dan mengoptimalkan kinerja.

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. Saat klien tersambung atau terputus, AWS IoT menerbitkan peristiwa siklus hidup dengan pesan ke topik MQTT. Pesan sambungkan atau putuskan sambungan dapat berupa daftar elemen JSON yang memberikan rincian status koneksi. Untuk informasi selengkapnya tentang konektivitas perangkat, lihat Peristiwa siklus hidup.

Pelanggaran Device Defender - data AWS IoT Device Defender pelanggaran membantu mengidentifikasi perilaku perangkat anomali terhadap perilaku normal yang Anda tentukan 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 Mengelola pengindeksan hal.

Pengindeksan kelompok hal

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

Untuk informasi selengkapnya, lihat Mengelola pengindeksan grup hal.

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 terkelola. Anda menentukan nilai dari setiap bidang terkelola saat Anda membuat AWS IoT sesuatu. Misalnya, nama benda, grup benda, dan deskripsi benda semuanya adalah bidang yang dikelola. Pengindeksan armada mengindeks bidang terkelola berdasarkan mode pengindeksan yang Anda tentukan. Kolom terkelola tidak dapat diubah atau ditampilkancustomFields. Untuk informasi selengkapnya, lihat Bidang kustom.

Berikut daftar bidang terkelola untuk pengindeksan hal:

• Bidang terkelola 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 yang tidak disebutkan namanya

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

• Bidang terkelola 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}
  ]

• 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 terkelola 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 yang tidak disebutkan namanya	shadow.version
Bayangan bernama	shadow.name.*.version
Pertahanan Perangkat	deviceDefender.version
Kelompok benda	version

Bidang kustom

Anda dapat menggabungkan atribut benda, data Device Shadow, dan data pelanggaran Device Defender dengan membuat bidang khusus untuk mengindeksnya. customFieldsAtribut adalah daftar nama bidang dan pasangan tipe data. Anda dapat melakukan kueri agregasi berdasarkan tipe data. Mode pengindeksan yang Anda pilih mempengaruhi bidang dapat ditentukan. customFields Misalnya, jika Anda menentukan mode REGISTRY pengindeksan, Anda tidak dapat menentukan bidang kustom dari bayangan benda. Anda dapat menggunakan perintah update-indexing-configurationCLI untuk membuat atau memperbarui bidang khusus (lihat perintah contoh di Memperbarui contoh konfigurasi pengindeksan).

• Nama bidang khusus

Nama bidang khusus untuk atribut grup benda dan benda dimulai denganattributes., diikuti dengan 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 dimulaideviceDefender., diikuti dengan nilai data pelanggaran Device Defender.

Atribut atau nama 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 kustom

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