Gestione dell'indicizzazione del parco istanze

L'indicizzazione del parco istanze consente di gestire automaticamente due tipi di indici: l'indicizzazione di oggetti e l'indicizzazione di gruppi di oggetti.

Indicizzazione degli oggetti

L'indice creato per tutti i tuoi oggetti è chiamato AWS_Things. L'indicizzazione degli oggetti supporta le seguenti origini dati: dati di registro di AWS IoT, dati di AWS IoT Device Shadow , dati di connettività di AWS IoT e dati di violazioni di AWS IoT Device Defender. Aggiungendo queste origini dei dati alla configurazione di indicizzazione del parco istanze, puoi cercare oggetti, eseguire query su dati aggregati e creare gruppi di oggetti dinamici e parametri del parco istanze in base alle tue query di ricerca.

Registro:AWS IoT fornisce un registro che ti aiuta a gestire le cose. È possibile aggiungere i dati di registro alla configurazione di indicizzazione del parco istanze per cercare i dispositivi in base ai nomi degli oggetti, alle descrizioni e ad altri attributi del registro. Per ulteriori informazioni sul registro, consulta Come gestire gli oggetti con il registro.

Shadow: il servizio Device Shadow AWS IoT fornisce copie shadow che facilitano l'archiviazione dei dati sullo stato del dispositivo. L'indicizzazione degli oggetti supporta sia le classiche copie shadow senza nome che le copie shadow con nome. Per indicizzare le copie shadow denominate, attiva le impostazioni delle tue copie shadow denominate e specificane i nomi nella configurazione di indicizzazione oggetti. Per impostazione predefinita, è possibile aggiungere fino a 10 nomi shadow per persona Account AWS. Per informazioni su come aumentare il limite del numero di nomi delle copie shadow, consulta AWS IoT Device Management Quotas nella Guida di riferimento di AWS .

Per aggiungere copie shadow specifiche per l'indicizzazione:

• Se utilizzi la console AWS IoT, attiva l'indicizzazione di oggetti, scegli Add named shadows (Aggiungi copie shadow denominate), quindi aggiungi i nomi delle copie shadow tramite Named shadow selection (Selezione della copia shadow denominata).

• Se usate il AWS Command Line Interface (AWS CLI), impostate su namedShadowIndexingMode be e ON specificate i nomi delle ombre in IndexingFilter. Per gli esempi di comandi della CLI, consulta Manage thing indexing (Gestione dell'indicizzazione di oggetti).

Importante

Il 20 luglio 2022 è disponibile la versione General Availability (GA) dell'integrazione dell'indicizzazione della flotta di AWS IoT Device Management con shadow AWS IoT Core denominati e AWS IoT Device Defender rilevamento delle violazioni. Con questo rilascio pubblico, potrai indicizzare copie shadow denominate specificando i nomi delle copie shadow. Se hai aggiunto le tue copie shadow denominate per l'indicizzazione durante il periodo di anteprima pubblica di questa funzione, ovvero dal 30 novembre 2021 al 19 luglio 2022, ti invitiamo a riconfigurare le impostazioni di indicizzazione del parco istanze e scegliere nomi di copie shadow specifici per ridurre i costi di indicizzazione e ottimizzare le prestazioni.

Per ulteriori informazioni sulle shadow, consulta Servizio Device Shadow AWS IoT.

Connettività: i dati di connettività del dispositivo consentono di identificare lo stato di connessione dei dispositivi. Questi dati di connettività sono guidati da eventi del ciclo di vita. Quando un client si connette o si disconnette, AWS IoT pubblica eventi del ciclo di vita con messaggi su argomenti MQTT. Un messaggio di connessione o disconnessione può essere un elenco di elementi JSON che forniscono dettagli sullo stato della connessione. Per ulteriori informazioni sulla connettività del dispositivo, consulta Eventi del ciclo di vita.

Violazioni di Device Defender: i dati AWS IoT Device Defender sulle violazioni aiutano a identificare i comportamenti anomali dei dispositivi rispetto ai comportamenti normali definiti in un profilo di sicurezza. Un profilo di sicurezza contiene un set di comportamenti previsti del dispositivo. Ogni comportamento utilizza un parametro che specifica il comportamento normale dei dispositivi. Per ulteriori informazioni sulle violazioni di Device Defender, consulta detect.AWS IoT Device Defender

Per ulteriori informazioni, consulta Gestione dell'indicizzazione degli oggetti.

Indicizzazione di gruppi di oggetti

AWS_ThingGroups è l'indice che contiene tutti i tuoi gruppi di oggetti. Questo indice consente di cercare gruppi in base al nome del gruppo, alla descrizione, agli attributi e a tutti i nomi del gruppo padre.

Per ulteriori informazioni, consulta Gestione dell'indicizzazione di gruppi di oggetti.

Campi gestiti

I campi gestiti contengono dati associati a oggetti, gruppi di oggetti, ombre dei dispositivi, connettività dei dispositivi e violazioni di Device Defender. AWS IoT definisce il tipo di dati nei campi gestiti. Si specificano i valori di ogni campo gestito quando si crea un AWS IoT oggetto. Ad esempio i nomi degli oggetti, i gruppi di oggetti e le descrizioni degli oggetti sono tutti campi gestiti. L'indicizzazione del parco istanze indica i campi gestiti in base alla modalità di indicizzazione che specifici. I campi gestiti non possono essere modificati o visualizzati in customFields. Per ulteriori informazioni, consulta Custom fields (Personalizza campi).

Di seguito sono elencati i campi gestiti per l'indicizzazione delle cose:

• Campi gestiti per il Registro di sistema

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

• Campi gestiti per shadow classiche senza nome

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

• Campi gestiti per shadow con nome

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

• Campi gestiti per la connettività degli oggetti

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

• Campi gestiti per 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}
  ]

• Campi gestiti per i gruppi di oggetti

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

Nella tabella seguente sono elencati i campi gestiti che non sono ricercabili.

Origine dati	Il campo gestito non è ricercabile
Registro	registry.version
Copie shadow senza nome	shadow.version
Copie shadow con nome	shadow.name.*.version
Device Defender	deviceDefender.version
Gruppi di oggetti	version

Campi personalizzati

È possibile aggregare gli attributi degli oggetti, i dati di Device Shadow e i dati delle violazioni di Device Defender creando campi personalizzati per indicizzarli. L'attributo customFields è un elenco di coppie di nomi di campi e tipi di dati. È possibile eseguire query di aggregazione in base al tipo di dati. La modalità di indicizzazione che scegli influenza i campi che è possibile specificare in customFields. Ad esempio, se si specifica la modalità di indicizzazione REGISTRY, non è possibile specificare un campo personalizzato da una copia shadow dell'oggetto. È possibile utilizzare il comando update-indexing-configurationCLI per creare o aggiornare i campi personalizzati (vedere un comando di esempio in Aggiornamento degli esempi di configurazione dell'indicizzazione).

• Nomi di campo personalizzati

I nomi dei campi personalizzati per gli attributi di oggetti e gruppi di oggetti iniziano con attributes., seguito dal nome dell'attributo. Se l'indicizzazione delle copie shadow senza nome è attiva, gli oggetti possono avere nomi di campo personalizzati che iniziano con shadow.desired o shadow.reported, seguito dal nome del valore dei dati delle copie shadow senza nome. Se l'indicizzazione delle copie shadow con nome è attiva, gli oggetti possono avere nomi di campo personalizzati che iniziano con shadow.name.*.desired. o shadow.name.*.reported., seguito dal valore dei dati delle copie shadow con nome. Se l'indicizzazione delle violazioni di Device Defender è attiva, gli oggetti possono avere nomi di campo personalizzati che iniziano con deviceDefender., seguito dal valore dei dati delle violazioni di Device Defender.

Il nome dell'attributo o del valore dei dati che segue il prefisso può contenere solo caratteri alfanumerici, - (trattino) e _ (carattere di sottolineatura). Non può avere spazi.

Se è presente un'incongruenza di tipo tra un campo personalizzato nella configurazione e il valore indicizzato, il servizio di indicizzazione del parco istanze ignora il valore incoerente per le query di aggregazione. CloudWatch I log sono utili per la risoluzione dei problemi relativi alle query di aggregazione. Per ulteriori informazioni, consulta Risoluzione dei problemi delle query di aggregazione per il servizio di indicizzazione del parco istanze.

• Tipi di campo personalizzati

I tipi di campo personalizzati hanno i seguenti valori supportati: Number, String, e Boolean.