Administración de la indexación de flotas

La indexación de flotas administra dos tipos de índices por usted: la indexación de objetos y la indexación de grupos de objetos.

Indexación de objetos

El índice creado para todos sus objetos se llama AWS_Things. La indexación de objetos admite los siguientes orígenes de datos: datos de registro de AWS IoT, datos de AWS IoT Device Shadow, datos de conectividad de AWS IoT y datos de infracciones de AWS IoT Device Defender. Al agregar estos orígenes de datos a la configuración de indexación de su flota, puede buscar objetos, consultar datos agregados y crear grupos de objetos dinámicos y métricas de flota basados en sus consultas de búsqueda.

Registro:AWS IoT proporciona un registro que le ayuda a gestionar las cosas. Puede agregar los datos de registro a la configuración de indexación de su flota para buscar dispositivos en función de los nombres, las descripciones y otros atributos del registro. Para obtener más información acerca del registro, consulte Cómo administrar objetos con el registro.

Sombra: el servicio AWS IoT Device Shadow proporciona sombras que le ayudan a almacenar los datos de estado del dispositivo. La indexación de objetos admite tanto las sombras clásicas sin nombre como las sombras con nombre. Para indexar sombras con nombre, active la configuración de sombras guardadas y especifique los nombres de las sombras en la configuración de indexación de objetos. De forma predeterminada, puede añadir hasta 10 nombres ocultos por cada uno Cuenta de AWS. Para ver cómo aumentar el límite del número de nombres ocultos, consulte Cuotas de AWS IoT Device Management en la Referencia general de AWS .

Para agregar sombras con nombre para la indexación:

• Si utiliza la consola de AWS IoT, active Indexación de objetos, seleccione Agregar sombras con nombre y agregue los nombres de las sombras en Selección de sombra con nombre.

• Si usa AWS Command Line Interface (AWS CLI), namedShadowIndexingMode configúrelo en be ON y especifique los nombres de las sombras en IndexingFilter. Para ver ejemplos de comandos de la CLI, consulte Administración de la indexación de objetos.

importante

El 20 de julio de 2022 estará disponible para el público general (GA) de la integración de indexación de flotas de AWS IoT Device Management, que incluye sombras AWS IoT Core nombradas y AWS IoT Device Defender detección de infracciones. Con esta versión GA, puede indexar sombras con nombres específicos especificando nombres de sombras. Si ha agregado sombras con nombre para indexarlas durante el período de vista previa pública de esta característica, del 30 de noviembre de 2021 al 19 de julio de 2022, le recomendamos que vuelva a configurar los ajustes de indexación de su flota y elija nombres de sombras específicos para reducir los costes de indexación y optimizar el rendimiento.

Para obtener información sobre las sombras, consulte el servicio AWS IoT Device Shadow.

Conectividad: los datos de conectividad de los dispositivos le ayudan a identificar el estado de conexión de sus dispositivos. Estos datos de conectividad dependen de los eventos del ciclo de vida. Cuando un cliente se conecta o se desconecta, AWS IoT publica los eventos del ciclo de vida con mensajes sobre temas de MQTT. Un mensaje de conexión o desconexión puede ser una lista de elementos JSON que proporcionan detalles del estado de la conexión. Para obtener información sobre la conectividad de los dispositivos, consulte Eventos del ciclo de vida.

Infracciones de Device Defender: los datos sobre AWS IoT Device Defender infracciones ayudan a identificar los comportamientos anómalos de los dispositivos en comparación con los comportamientos normales que se definen en un perfil de seguridad. Un perfil de seguridad contiene un conjunto de comportamientos esperados del dispositivo. Cada comportamiento utiliza una métrica que especifica el comportamiento normal de los dispositivos. Para obtener más información sobre las infracciones de Device Defender, consulte AWS IoT Device Defender detectar.

Para obtener más información, consulte Administración de la indexación de flotas.

Indexación de grupos de objetos

AWS_ThingGroups es el índice que contiene todos sus grupos de objetos. Puede usar este índice para buscar grupos en función de su nombre, descripción, atributos y todos los nombres de grupos principales.

Para obtener más información, consulte Administración de la indexación de grupos de objetos.

Campos administrados

Los campos gestionados contienen datos asociados a cosas, grupos de cosas, dispositivos ocultos, conectividad de los dispositivos e infracciones de Device Defender. AWS IoT define el tipo de datos en los campos gestionados. Los valores de cada campo gestionado se especifican al crear cualquier AWS IoT cosa. Por ejemplo, los nombres de objetos, los grupos de objetos y las descripciones de objetos son todos campos administrados. La indexación de flotas indexa los campos administrados en función del modo de indexación que usted especifique. Los campos administrados no se pueden cambiar ni pueden aparecer en customFields. Para obtener más información, consulte Campos personalizados.

A continuación se enumeran los campos administrados para la indexación de objetos:

• Campos administrados del registro

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

• Campos administrados para sombras clásicas sin nombre

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

• Campos administrados para sombras con nombre

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

• Campos administrados de conectividad de objetos

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

• Campos administrados para 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}
  ]

• Campos administrados de grupos de objetos

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

En la siguiente tabla se muestran los campos administrados que no se pueden buscar.

Origen de datos	Campo administrado que no se puede buscar
Registro	registry.version
Sombras sin nombre	shadow.version
Sombras con nombre	shadow.name.*.version
Device Defender	deviceDefender.version
Grupos de objetos	version

Campos personalizados

Puede agregar atributos de objetos, datos de Device Shadow y datos de infracciones de Device Defender creando campos personalizados para indexarlos. El atributo customFields es una lista de pares de campos y tipos de datos con nombre. Puede realizar consultas de agregación en función del tipo de datos. El modo de indexación que elija afecta a los campos se puede especificar en customFields. Por ejemplo, si especifica el modo de indexación REGISTRY, no puede especificar un campo personalizado de una sombra de objeto. Puede usar el comando update-indexing-configurationCLI para crear o actualizar los campos personalizados (consulte un comando de ejemplo en Actualización de ejemplos de configuración de indexación).

• Nombres de campos personalizados

Los nombres de los campos personalizados para los atributos objetos y grupos de objetos comienzan por attributes. seguidos del nombre del atributo. Si la indexación de sombras sin nombre está activada, los objetos pueden tener nombres de campo personalizados que comiencen por shadow.desired o shadow.reported, seguidos del nombre del valor de los datos de sombras sin nombre. Si la indexación de sombras sin nombre está activada, los objetos pueden tener nombres de campo personalizados que comiencen por shadow.name.*.desired. o shadow.name.*.reported., seguidos del valor de los datos de sombras sin nombre. Si la indexación de infracciones de Device Defender está activada, los objetos pueden tener nombres de campo personalizados que comiencen por deviceDefender., seguidos del valor de los datos de infracciones de Device Defender.

El nombre de atributo o valor de datos que sigue al prefijo puede tener solo caracteres alfanuméricos, - (guion) y _ (guion bajo). No puede tener ningún espacio.

Si existe una incoherencia de tipo entre un campo personalizado de su configuración y el valor que se indexa, la indexación de flotas ignora el valor incoherente para las consultas de agregación. CloudWatch Los registros son útiles para solucionar problemas de consultas de agregación. Para obtener más información, consulte Solución de problemas de consultas de agregación en el servicio de indexación de flotas.

• Tipos de campos personalizados

Los tipos de campos personalizados tienen los siguientes valores admitidos: Number, String y Boolean.