Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Préparation de l'indexation de la flotte

Avec l'indexation de AWS IoT flotte, vous pouvez rechercher et agréger des données en utilisant le nom réservé shadow ($package). Vous pouvez également regrouper AWS IoT des objets en interrogeant les groupes Ombre nommée réservée d'objets dynamiques. Par exemple, vous pouvez trouver des informations sur AWS IoT les éléments qui utilisent une version de package spécifique, sur lesquels aucune version de package spécifique n'est installée ou sur lesquels aucune version de package n'est installée. Vous pouvez obtenir des informations supplémentaires en combinant les attributs. Par exemple, identifier les objets dotés d'une version spécifique et d'un type d'objet spécifique (tels que la version 1.0.0 et le type d'objet pump_sensor). Pour plus d'informations, veuillez consulter la rubrique Fleet indexing.

Définir l'$packageombre comme source de données

Pour utiliser l'indexation de flotte avec le Catalogue de Logiciels, vous devez activer l'indexation de flotte, définir l'ombre nommée comme source de données et définir $package comme filtre d'ombre nommé. Si vous n'avez pas activé l'indexation de la flotte, vous pouvez l'activer dans le cadre de ce processus. A partir deAWS IoT Core dans la console, ouvrez Paramètres, choisissez Gérer l'indexation, puis Ajouter des ombres nommées, Ajouter des packages logiciels et des versions de l'appareil, et Mettre à jour. Pour de plus amples informations, veuillez consulter la section Gestion de l'indexation des objets.

Vous pouvez également activer l'indexation de la flotte lorsque vous créez votre premier package. Lorsque la boîte de dialogue Activer les dépendances pour la gestion des packages apparaît, choisissez l'option permettant d'ajouter les packages logiciels et les versions des appareils en tant que sources de données pour l'indexation de la flotte. En sélectionnant cette option, vous activez également l'indexation de la flotte.

Métriques affichées dans la console

Sur la page de détails du package logiciel de la AWS IoT console, le panneau Discovery affiche les métriques standard ingérées dans l'$packageombre.

Pour une autre méthode permettant de mieux comprendre la collecte de la distribution des versions de packages, voir Collecte de la distribution des versions de packages via getBucketsAggregation.

Modèles de requête

L'indexation des flottes avec Software Package Catalog utilise la plupart des fonctionnalités prises en charge (par exemple, les termes, les phrases et les champs de recherche) qui sont standard pour l'indexation des flottes. L'exception est que les requêtes comparison et range ne sont pas disponibles pour la ($package)version clé de l’ombre réservée nommée. Toutefois, ces requêtes sont disponibles pour la attributes clé. Pour plus d'informations, consultez Syntaxe de requête..

Exemple de données

Remarque : pour plus d'informations sur l'ombre nommée réservée et sa structure, consultez Ombre nommée réservée.

Dans cet exemple, un premier périphérique est nommé AnyThing et les packages suivants sont installés :

L'ombre ressemble à ce qui suit :

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

Un deuxième périphérique est nommé AnotherThing et le package suivant est installé :

L'ombre ressemble à ce qui suit :

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

Exemples de requêtes

Le tableau suivant répertorie des exemples de requêtes basés sur les exemples d'ombres du périphérique pour AnyThing etAnotherThing. Pour plus d'informations, consultez Exemples de requêtes.

Collecte de la distribution des versions de packages via getBucketsAggregation

Outre le panneau Discovery de la AWS IoT console, vous pouvez également obtenir des informations sur la distribution des versions des packages à l'aide de cette GetBucketsAggregationAPIopération. Pour obtenir des informations de distribution de la version du package, vous devez procéder comme suit :

Pour plus d'informations, consultez la section Champs personnalisés dans l'indexation des AWS IoT flottes.