Administración de la indexación de flotas - AWS IoT Core
Indexación de objetosIndexación de grupos de objetosCampos administradosCampos personalizados

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 administrar objetos. 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 agregar hasta 10 nombres de sombra por cada 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 la AWS Command Line Interface (AWS CLI), ajuste namedShadowIndexingMode en 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 saldrá a la venta la versión de disponibilidad general (GA) de la integración de indexación de flotas de AWS IoT Device Management, que incluye sombras con nombre de AWS IoT Core y detección de infracciones de AWS IoT Device Defender. 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 los 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 infracciones de AWS IoT Device Defender ayudan a identificar los comportamientos anómalos de los dispositivos frente a 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 detect.

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 administrados contienen datos asociados a objetos, grupos de objetos, dispositivos ocultos, conectividad de los dispositivos e infracciones de Device Defender. AWS IoT define el tipo de datos en los campos administrados. El usuario especifica los valores de cada campo administrado cuando se crea un objeto de AWS IoT. 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 de la CLI update-indexing-configuration 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. Los registros de Registros de CloudWatch 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.