Gerenciamento da indexação de frotas

A indexação de frotas gerencia dois tipos de índices: indexação de objetos e indexação de grupos de objetos.

Indexação de objetos

O índice criado para todas as suas objetos é chamado de AWS_Things. A indexação de objetos é compatível com as seguintes fontes de dados: dados de registro do AWS IoT, dados da sombra do dispositivo do AWS IoT, dados de conectividade do AWS IoT e dados de violações do AWS IoT Device Defender. Ao adicionar essas fontes de dados à sua configuração de indexação de frotas, é possível pesquisar objetos, consultar dados agregados e criar grupos dinâmicos de objetos e métricas de frota com base em suas consultas de pesquisa.

Registro -AWS IoT fornece um registro que ajuda você a gerenciar coisas. É possível adicionar os dados do registro à configuração de indexação da frota para pesquisar dispositivos com base nos nomes, descrições e outros atributos do registro das objetos. Para acessar mais informações sobre o registro, consulte Como gerenciar objetos com o registro.

Sombra- o serviço de sombra do dispositivo do AWS IoT oferece sombras que ajudam você a armazenar os dados de estado de um dispositivo. A indexação de objetos é compatível tanto com sombras clássicas sem nome quanto sombras nomeadas. Para indexar sombras nomeadas, ative as configurações de sombra nomeada e especifique os nomes de sombra na configuração de indexação de objetos. Por padrão, você pode adicionar até 10 nomes de sombra por Conta da AWS. Para saber como aumentar o limite de número de nomes de sombras, consulte AWS IoT Device Management Cotas na Referência geral da AWS .

Para adicionar sombras nomeadas para indexação:

• Se você usa o console do AWS IoT, ative a Indexação de objetos, selecione Adicionar sombras nomeadas e adicione os nomes das sombras por meio da Seleção de sombras nomeadas.

• Se você usar o AWS Command Line Interface (AWS CLI), namedShadowIndexingMode defina como ser ON e especifique os nomes das sombras em IndexingFilter. Para ver exemplos de comandos da CLI, consulte Gerenciamento da indexação de objetos.

Importante

20 de julho de 2022 é a versão de Disponibilidade Geral (GA) da integração de indexação de frotas de gerenciamento de AWS IoT dispositivos com sombras AWS IoT Core nomeadas e AWS IoT Device Defender detecção de violações. Com esta versão do GA, é possível indexar sombras nomeadas específicas especificando nomes das sombras. Caso tenha adicionado suas sombras nomeadas para indexação durante o período de pré-visualização pública desse atributo, de 30 de novembro de 2021 a 19 de julho de 2022, recomendamos que você reconfigure suas definições de indexação de frotas e escolha nomes de sombra específicos para reduzir o custo de indexação e otimizar o desempenho.

Para acessar mais informações sobre as sombras, consulte Serviço de sombra do dispositivo do AWS IoT.

Conectividade - os dados de conectividade do dispositivo ajudam você a identificar o status da conexão dos dispositivos. Esses dados de conectividade são orientados por eventos do ciclo de vida. Quando um cliente se conecta ou desconecta, AWS IoT publica eventos do ciclo de vida com mensagens para tópicos do MQTT. Uma mensagem de conexão ou desconexão pode ser uma lista de elementos JSON fornecendo detalhes sobre o status da conexão. Para acessar mais informações sobre a conectividade de dispositivos, consulte Eventos de ciclo de vida.

Violações do Device Defender - os dados de AWS IoT Device Defender violações ajudam a identificar comportamentos anômalos do dispositivo em relação aos comportamentos normais que você define em um Perfil de Segurança. Um perfil de segurança contém um conjunto de comportamentos esperados. Cada comportamento utiliza uma métrica que especifica o comportamento normal dos dispositivos. Para obter mais informações sobre violações do Device Defender, consulte AWS IoT Device Defender detectar.

Para acessar mais informações, consulte Gerenciamento da indexação de objetos.

Indexação de grupo de objetos

AWS_ThingGroupsé o índice que contém todos os seus grupos de coisas e grupos de cobrança. Você pode usar esse índice para pesquisar grupos com base no nome do grupo, na descrição, nos atributos e em todos os nomes de grupo pai.

Para acessar mais informações, consulte Gerenciamento da indexação de grupos de objetos.

Campos gerenciados

Os campos gerenciados contêm dados associados a coisas, grupos de coisas, sombras de dispositivos, conectividade de dispositivos e violações do Device Defender. AWS IoT define o tipo de dados nos campos gerenciados. Você especifica os valores de cada campo gerenciado ao criar AWS IoT algo. Por exemplo, nomes de objetos, grupos de objetos e descrições de objetos são todos os campos gerenciados. A indexação de frotas indexa campos gerenciados com base no modo de indexação especificado por você. Os campos gerenciados não podem ser alterados e não aparecem em customFields. Para acessar mais informações, consulte Campos personalizados.

A seguir está uma lista dos campos gerenciados para indexação de objetos:

• Campos gerenciados para o 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 gerenciados para sombras clássicas sem nome

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

• Campos gerenciados para sombras nomeadas

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

• Campos gerenciados para conectividade de objetos

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

• Campos gerenciados para o 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 gerenciados para grupos de objetos

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

A tabela a seguir lista os campos gerenciados que não podem ser pesquisados.

Fonte de dados	Campo gerenciado que não pode ser pesquisado
Registro	registry.version
Sombra nomeada	shadow.version
Sombra nomeada	shadow.name.*.version
Device Defender	deviceDefender.version
Grupos de objetos	version

Campos personalizados

Você pode agregar atributos de objetos, dados de sombra do dispositivo e dados de violações do Device Defender criando campos personalizados para indexá-los. O atributo customFields é uma lista de pares de nomes de campos e tipos de dados. É possível realizar consultas de agregação com base no tipo de dados. O modo de indexação selecionado afeta os campos que podem ser especificados em customFields. Por exemplo, ao especificar o modo de indexação REGISTRY, não será possível especificar um campo personalizado de uma sombra de um objeto. Você pode usar o comando update-indexing-configuration da CLI para criar ou atualizar os campos personalizados (consulte um exemplo de comando em Atualização de exemplos de configuração de indexação).

• Nomes de campos personalizados

Os nomes de campo personalizados para atributos de objetos e grupos de objetos iniciam com attributes., seguidos pelo nome do atributo. Se a indexação de sombra sem nome estiver ativada, as objetos podem ter nomes de campos personalizados que iniciem com shadow.desired ou shadow.reported, seguidos pelo nome do valor de dados da sombra sem nome. Se a indexação de sombra nomeada estiver ativada, as objetos podem ter nomes de campos personalizados que iniciem com shadow.name.*.desired. ou shadow.name.*.reported., seguidos pelo valor de dados da sombra nomeada. Se a indexação de violações do Device Defender estiver ativada, as objetos poderão ter nomes de campos personalizados que iniciem comdeviceDefender., seguidos pelo valor dos dados de violações do Device Defender.

O nome do valor de dados ou atributo que acompanha o prefixo só pode possuir caracteres alfanuméricos, - (hífen) e _ (sublinhado). Ele não pode ter espaços.

Caso haja uma inconsistência de tipo entre um campo personalizado na configuração e o valor sendo indexado, a indexação de frotas ignorará o valor inconsistente para consultas de agregação. CloudWatch Os registros são úteis para solucionar problemas de consulta de agregação. Para ter mais informações, consulte Solução de problemas de consultas de agregação para o serviço de indexação de frota.

• Nomes de campos personalizados

Os tipos de campos personalizados têm os seguintes valores compatíveis: Number, String e Boolean.