Indicizzazione degli oggetti Indicizzazione di gruppi di oggetti Campi gestiti Campi personalizzati

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 AWS IoT Device Shadow fornisce ombre che aiutano a memorizzare i 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 vedere esempi di comandi CLI, vedi Gestione dell'indicizzazione degli oggetti.

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

Connettività: i dati di connettività dei dispositivi consentono di identificare lo stato della 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, tra cui l'ID client, la durata del mantenimento in vita, il flag di sessione pulita e la scadenza della sessione. 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},
  {name:connectivity.clientId, type:String},
  {name:connectivity.keepAliveDuration, type:Number},
  {name:connectivity.cleanSession, type:Boolean},
  {name:connectivity.sessionExpiry, type:Number}
]

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. Puoi utilizzare il comando CLI update-indexing-configuration per creare o aggiornare i campi personalizzati. Vedi un esempio di comando in Updating indexing configuration examples (Esempi di aggiornamento della configurazione di aggiornamento).

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.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Indicizzazione della flotta

Gestione dell’indicizzazione degli oggetti