Gestion de l'indexation de la flotte

L'indexation de flotte gère deux types d'index pour vous : l'indexation des objets et l'indexation des groupes d'objets.

Indexation d'objets

L'index créé pour l'ensemble de vos objets est AWS_Things. L'indexation d’objet prend en charge les sources de données suivantes : données de AWS IoT registre, données AWS IoT Device Shadow, données de AWS IoT connectivité et données de AWS IoT Device Defenderviolations. En ajoutant ces sources de données à la configuration d'indexation de votre flotte, vous pouvez rechercher des objets, demander des données agrégées et créer des groupes d'objets dynamiques et des métriques de flotte en fonction de vos requêtes de recherche.

Registre :AWS IoT fournit un registre qui vous aide à gérer les choses. Vous pouvez ajouter les données du registre à la configuration d'indexation de votre flotte pour rechercher des appareils en fonction des noms d'objets, des descriptions et d'autres attributs du registre. Pour plus d'informations sur le registre, consultez la section Comment gérer les objets avec le registre.

Shadow -Le service AWS IoT Device Shadow fournit des shadows qui vous aident à stocker les données d'état de votre appareil. L'indexation des objets prend en charge à la fois les shadows anonymes classiques et nommées. Pour indexer les shadows nommées, activez vos paramètres shadows nommées et spécifiez les noms de vos shadows dans la configuration d'indexation des objets. Par défaut, vous pouvez ajouter jusqu'à 10 noms d'ombres par zone Compte AWS. Pour savoir comment augmenter la limite du nombre de noms fictifs, consultez la section AWS IoT Device Management Quotas de la Référence AWS générale.

Pour ajouter des shadows nommées à des fins d'indexation :

• Si vous utilisez la AWS IoT console, activez l'indexation des objets, choisissez Ajouter des shadows nommées et ajoutez les noms de vos shadows via la sélection des shadows nommées.

• Si vous utilisez le AWS Command Line Interface (AWS CLI), définissez-le namedShadowIndexingMode comme étant ON et spécifiez les noms des ombres dans IndexingFilter. Pour voir des exemples de commandes CLI, consultez la section Gérer l'indexation des objets.

Important

Le 20 juillet 2022 est la version en disponibilité générale (GA) de l'intégration de l'indexation de la flotte de gestion des AWS IoT appareils avec des ombres AWS IoT Core nommées et de la AWS IoT Device Defender détection des violations. Avec cette version GA, vous pouvez indexer des shadows nommées spécifiques en spécifiant les noms des shadows. Si vous avez ajouté vos shadows nommées pour l'indexation pendant la période de préversion publique de cette fonctionnalité, du 30 novembre 2021 au 19 juillet 2022, nous vous encourageons à reconfigurer les paramètres d'indexation de votre flotte et à choisir des noms shadows spécifiques pour réduire les coûts d'indexation et optimiser les performances.

Pour plus d'informations sur les shadows, consultez AWS IoT Service Device Shadows.

Connectivité - Les données de connectivité des appareils vous aident à identifier l'état de connexion de vos appareils. Ces données de connectivité sont dictées par les événements du cycle de vie. Lorsqu'un client se connecte ou se déconnecte, AWS IoT publie les événements du cycle de vie avec des messages dans des rubriques MQTT. Un message de connexion ou de déconnexion peut être une liste d'éléments JSON fournissant des détails sur l'état de la connexion. Pour plus d’informations sur la connectivité des appareils, consultez Événements du cycle de vie.

Violations de Device Defender : les données relatives aux AWS IoT Device Defender violations permettent d'identifier les comportements anormaux des appareils par rapport aux comportements normaux que vous définissez dans un profil de sécurité. Un profil de sécurité contient un ensemble de comportements attendus de l'appareil. Chaque comportement utilise une métrique qui indique le comportement normal de vos appareils. Pour plus d'informations sur les violations de Device Defender, consultez la section AWS IoT Device Defender détecter.

Pour de plus amples informations, veuillez consulter la section Gestion de l'indexation des objets.

Indexation du groupe d'objets

AWS_ThingGroups est l'index qui contient tous les groupes de votre objet. Cet index vous permet de rechercher des groupes en fonction de leur nom, de la description, des attributs et de tous les noms de groupes parents.

Pour de plus amples informations, veuillez consulter la section Gestion de l'indexation du groupe d'objet.

Champs gérés

Les champs gérés contiennent des données associées aux objets, aux groupes d'objets, aux ombres des appareils, à la connectivité des appareils et aux violations de Device Defender. AWS IoT définit le type de données dans les champs gérés. Vous spécifiez les valeurs de chaque champ géré lorsque vous créez un AWS IoT objet. Par exemple, les noms d'objets, les groupes d'objets et les descriptions d'objets sont tous des champs gérés. L'indexation de flotte indexe les champs gérés en fonction du mode d'indexation que vous spécifiez. Les champs gérés ne peuvent pas être modifiés ni s'afficher dans customFields. Pour plus d’informations, consultez Champs personnalisés.

La liste suivante répertorie les champs gérés pour l'indexation des objets :

• Champs gérés pour le registre

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

• Champs gérés pour les shadows classiques sans nom

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

• Champs gérés pour les shadows nommées

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

• Champs gérés pour la connectivité d'objets

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

• Champs gérés pour 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}
  ]

• Champs gérés pour les groupes d'objets

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

Le tableau suivant répertorie les champs gérés qui ne sont pas consultables.

Source de données	Champ géré impossible à rechercher
Registre	registry.version
Shadows anonymes	shadow.version
Shadows nommés	shadow.name.*.version
Device Defender	deviceDefender.version
Groupes d'objets	version

Champs personnalisés

Vous pouvez agréger les attributs des objets, les données de Device Shadow et les données relatives aux violations de Device Defender en créant des champs personnalisés pour les indexer. L'attribut customFields est une liste de paires de noms de champs et de types de données. Vous pouvez effectuer des requêtes d'agrégation en fonction du type de données. Le mode d'indexation que vous choisissez et qui affecte les champs peut être spécifié dans customFields. Par exemple, si vous spécifiez le mode d'indexation REGISTRY, vous ne pouvez pas spécifier un champ personnalisé à partir d'une shadow d'objet. Vous pouvez utiliser la commande update-indexing-configurationCLI pour créer ou mettre à jour les champs personnalisés (voir un exemple de commande dans la section Mise à jour des exemples de configuration d'indexation).

• Noms de champs personnalisés

Les noms de champs personnalisés pour les attributs d'objets et de groupes d'objets commencent par attributes., suivis du nom de l'attribut. Si l'indexation anonyme est activée, les éléments peuvent avoir des noms de champs personnalisés commençant par shadow.desired ou shadow.reported, suivis du nom de la valeur des données shadows sans nom. Si l'indexation de la shadow nommée est activée, les éléments peuvent avoir des noms de champs personnalisés commençant par shadow.name.*.desired. ou shadow.name.*.reported., suivis de la valeur des données shadows nommées. Si l'indexation des violations de Device Defender est activée, les éléments peuvent avoir des noms de champs personnalisés commençant par deviceDefender., suivi de la valeur des données relatives aux violations de Device Defender.

Le nom de l'attribut ou de la valeur de données qui suit le préfixe ne peut contenir que des caractères alphanumériques, - (trait d'union) et _ (trait de soulignement). Il ne peut pas y avoir d'espaces.

S'il existe une incohérence de type entre un champ personnalisé dans votre configuration et la valeur en cours d'indexation, l'indexation de flotte ignore la valeur incohérente pour les requêtes d'agrégation. CloudWatch Les journaux sont utiles pour résoudre les problèmes liés aux requêtes d'agrégation. Pour plus d’informations, consultez Dépannage des requêtes d'agrégation pour le service d'indexation de parc.

• Types de champs personnalisés

Les types de champs personnalisés ont les valeurs prises en charge suivantes : NumberString, et Boolean.