Preparazione dell'indicizzazione del parco istanze

Con l'indicizzazione AWS IoT della flotta, puoi cercare e aggregare i dati utilizzando il nome riservato shadow (). $package Puoi anche raggruppare gli AWS IoT oggetti interrogando i gruppi di oggetti Copia shadow con nome riservata dinamici. Ad esempio, è possibile trovare informazioni su quali AWS IoT elementi utilizzano una versione specifica del pacchetto, su quali non è installata una versione specifica del pacchetto o su quali non è installata alcuna versione del pacchetto. Puoi ottenere ulteriori informazioni dettagliate combinando gli attributi. Ad esempio, identificare gli elementi che hanno una versione specifica e sono di un tipo di oggetto specifico (come la versione 1.0.0 e il tipo di oggetto di pump_sensor). Per ulteriori informazioni, consulta Indicizzazione del parco istanze.

Impostazione della copia shadow $package come un'origine dati

Per utilizzare l'indicizzazione del parco istanze con Software Package Catalog, devi abilitare l'indicizzazione del parco istanze, impostare la copia shadow con nome come l'origine dati e definire $package come il filtro della copia shadow con nome. Se non hai abilitato l'indicizzazione del parco istanze, puoi abilitarla all'interno di questo processo. Da AWS IoT Core nella console, apri Impostazioni, scegli Gestisci indicizzazione, quindi seleziona Aggiungi copie shadow denominate, Aggiunta di pacchetti software del dispositivo e versioni e Aggiorna. Per ulteriori informazioni, consulta Gestione dell'indicizzazione degli oggetti.

In alternativa, puoi abilitare l'indicizzazione del parco istanze quando crei il primo pacchetto. Quando viene visualizzata la finestra di dialogo Abilita dipendenze per la gestione dei pacchetti, scegli l'opzione per aggiungere pacchetti e versioni software del dispositivo come origini dati all'indicizzazione del parco istanze. Selezionando questa opzione, abiliti anche l'indicizzazione del parco istanze.

Nota

L'abilitazione dell'indicizzazione del parco istanze per Software Package Catalog comporta costi di servizio standard. Per ulteriori informazioni, consulta Prezzi di AWS IoT Device Management.

Parametri visualizzati nella console

Nella pagina dei dettagli del pacchetto software della AWS IoT console, il pannello Discovery mostra le metriche standard acquisite dall'ombra. $package

• Il grafico di distribuzione della versione corrente mostra il numero di dispositivi e la percentuale per le 10 versioni del pacchetto più recenti associate a un AWS IoT elemento tra tutti i dispositivi associati a questo pacchetto software. Nota: se il pacchetto software dispone di più versioni del pacchetto di quelle etichettate nel grafico, puoi trovarle raggruppate in Altro.

• Nel Grafico storico viene visualizzato il numero di dispositivi associati alle versioni dei pacchetti selezionate in un periodo di tempo specificato. Il grafico è inizialmente vuoto finché non si seleziona un massimo di 5 versioni del pacchetto e si definisce l'intervallo di date e l'intervallo di tempo. Per selezionare i parametri del grafico, scegli Impostazioni. I dati visualizzati nel Grafico storico potrebbero essere diversi da quelli del grafico Distribuzione della versione corrente a causa della differenza nel numero di versioni del pacchetto visualizzate e anche perché puoi scegliere quali versioni del pacchetto analizzare nel Grafico storico. Nota: quando selezioni una versione del pacchetto da visualizzare, questa viene conteggiata ai fini del numero massimo di limiti dei parametri del parco istanze. Per ulteriori informazioni, consulta Limiti e quote per l'indicizzazione del parco istanze.

Per un altro metodo per ottenere informazioni dettagliate sulla raccolta della distribuzione delle versioni dei pacchetti, consulta Raccolta della distribuzione delle versioni dei pacchetti tramite getBucketsAggregation.

Modelli di query

L'indicizzazione del parco istanze con Software Package Catalog utilizza la maggior parte delle funzionalità supportate (ad esempio, termini e frasi e campi di ricerca) che sono standard per l'indicizzazione del parco istanze. L'eccezione è che le query comparison e range non sono disponibili per la chiave version ($package) della copia shadow con nome riservata. Tuttavia, queste query sono disponibili per la chiave attributes. Per ulteriori informazioni, consulta Sintassi delle query.

Dati di esempio

Nota: per informazioni sulla copia shadow con nome riservata e la struttura relativa, consulta Copia shadow denominata riservata.

In questo esempio, un primo dispositivo viene denominato AnyThing e dispone dei seguenti pacchetti installati:

• Pacchetto software: SamplePackage

  Versione del pacchetto: 1.0.0

  ID pacchetto: 1111

L'aspetto della copia shadow è il seguente:

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                    }
            }
        }
    }
}

Un secondo dispositivo viene denominato AnotherThing e dispone dei seguenti pacchetti installati:

• Pacchetto software: SamplePackage

  Versione del pacchetto: 1.0.0

  ID pacchetto: 1111

• Pacchetto software: OtherPackage

  Versione del pacchetto: 1.2.5

  ID pacchetto: 2222

L'aspetto della copia shadow è il seguente:

{
    "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"
                    }
            },
        }
    }
}

Query di esempio

Nella tabella seguente vengono elencate query campione basate sulle device shadow di esempio per AnyThing e AnotherThing. Per ulteriori informazioni, consulta Esempio di query per oggetti.

Versione più recente di AWS IoT Device Tester for FreerTOS
Informazioni richieste	Query	Risultato
Oggetti con installata una versione del pacchetto specifica	shadow.name.$package.reported.SamplePackage.version:1.0.0	AnyThing, OtherThing
Oggetti che non hanno una versione del pacchetto specifica installata	NOT shadow.name.$package.reported.OtherPackage.version:1.2.5	AnyThing
Qualsiasi dispositivo che utilizza una versione del pacchetto il cui ID pacchetto è maggiore di 1500	shadow.name.$package.reported.*.attributes.packageID>1500"	OtherThing
Oggetti con installato un pacchetto specifico e con installati più pacchetti	shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2	OtherThing

Raccolta della distribuzione delle versioni dei pacchetti tramite getBucketsAggregation

Oltre al pannello Discovery all'interno della AWS IoT console, puoi anche ottenere informazioni sulla distribuzione della versione del pacchetto utilizzando l'operazione GetBucketsAggregationAPI. Per ottenere informazioni sulla distribuzione delle versioni dei pacchetti, devi eseguire le seguenti operazioni:

• Definisci un campo personalizzato all'interno dell'indicizzazione del parco istanze per ogni pacchetto software. Nota: la creazione di campi personalizzati conta ai fini delle Service Quotas di indicizzazione del parco istanze AWS IoT.

• Formatta il campo personalizzato come segue:

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

Per ulteriori informazioni, consulta la sezione Campi personalizzati nell'indicizzazione del AWS IoT parco veicoli.