Consultas do status de conectividade do dispositivo - AWS IoT Core
Como funcionaRecursosBenefíciosPré-requisitosExemplos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Consultas do status de conectividade do dispositivo

AWS IoTA indexação de frota oferece suporte à consulta de conectividade de dispositivos individuais, permitindo que você recupere com eficiência o status da conectividade e os metadados relacionados para dispositivos específicos. Esse recurso complementa os recursos existentes de indexação e consulta em toda a frota.

Como funciona

O suporte à consulta de conectividade de dispositivos pode ser usado para recuperação otimizada do status de conectividade de um único dispositivo. Essa API fornece acesso de baixa latência e alto throughput às informações mais recentes de conectividade específicas do dispositivo. Depois de habilitar a indexação de conectividade, você terá acesso a essa API de consulta, que será cobrada como consultas padrão. Para acessar mais informações, consulte Preços do AWS IoT Device Management.

Recursos

Com o suporte à consulta de conectividade de dispositivos, você pode:

  1. Consultar o estado atual de conectividade (conectado ou desconectado) de determinado dispositivo usando o respectivo thingName.

  2. Recuperar metadados adicionais de conectividade, incluindo:

    1. Motivo da desconexão

    2. Carimbos de data/hora do evento de conexão ou desconexão mais recente.

nota

A indexação da frota indexa o status de conectividade de um dispositivo cuja conexão clientId é a mesma de thingName de um objeto registrada no Registro.

Benefícios

  1. Baixa latência: reflete o estado mais recente de conectividade do dispositivo e oferece baixa latência para refletir as alterações do estado de conexão do IoT Core. O IoT Core determina que um dispositivo está desconectado assim que recebe uma solicitação de desconexão dele ou no caso de um dispositivo se desconectar sem enviar uma solicitação de desconexão. O IoT Core aguardará 1,5x do tempo de keep-alive configurado antes de decidir desconectar o cliente. A API de status da conectividade exibirá essas alterações normalmente em menos de um segundo após o IoT Core determinar a mudança de estado conectado de um dispositivo.

  2. Alto throughput: aceita 350 transações por segundo (TPS) por padrão e pode ser ajustável para um valor maior mediante solicitação.

  3. Retenção de dados: armazena dados de eventos indefinidamente quando o ConnectivityIndexing modo Fleet Indexing (FI) está ativado e o item não é excluído. Se você desabilitar a indexação de conectividade, os registros não serão retidos.

nota

Se a indexação do status de conectividade tiver sido habilitada antes do lançamento dessa API, o Fleet Indexing começará a rastrear as alterações do status de conectividade após o lançamento da API e exibirá o status atualizado com base nessas alterações.

Pré-requisitos

Para usar o suporte à consulta de conectividade do dispositivo:

  1. Configurar uma AWS conta

  2. Integre e registre dispositivos AWS IoT Core na sua região preferida

  3. Habilite o Fleet Indexing com indexação de conectividade.

nota

Nenhuma configuração adicional será necessária se você já tiver a indexação de conectividade habilitada.

Para receber instruções detalhadas de configuração, consulte o Guia do desenvolvedor da AWS IoT.

Exemplos

aws iot get-thing-connectivity-data --thing-name myThingName

{
   "connected": true,
   "disconnectReason": "NONE",
   "thingName": "myThingName",
   "timestamp": "2024-12-19T10:00:00.000000-08:00"
}

  • thingName: o nome do dispositivo conforme indicado na solicitação. Isso também corresponde ao clientId usado para se conectar ao AWS IoT Core.

  • disconnectReason: motivo da desconexão. Será NONE para um dispositivo conectado.

  • connected: o valor booliano verdadeiro indicando que esse dispositivo está conectado no momento.

  • timestamp: o carimbo de data/hora que representa a desconexão mais recente do dispositivo em milissegundos.

aws iot get-thing-connectivity-data --thing-name myThingName

{
   "connected": false,
   "disconnectReason": "CLIENT_INITIATED_DISCONNECT",
   "thingName": "myThingName",
   "timestamp": "2024-12-19T10:30:00.000000-08:00"
}

  • thingName: o nome do dispositivo conforme indicado na solicitação. Isso também corresponde ao clientId usado para se conectar ao AWS IoT Core.

  • disconnectReason: O motivo da desconexão é CLIENT_INITIATED_DISCONNECT indicando que o cliente indicou que ele se desconectaria. AWS IoT Core

  • connected: o valor booliano falso indicando que esse dispositivo está desconectado no momento.

  • timestamp: o carimbo de data/hora que representa a desconexão mais recente do dispositivo em milissegundos.

aws iot get-thing-connectivity-data --thing-name neverConnectedThing

{
   "connected": false,
   "disconnectReason": "UNKNOWN",
   "thingName": "neverConnectedThing"
}

  • thingName: o nome do dispositivo conforme indicado na solicitação. Isso também corresponde ao clientId usado para se conectar ao AWS IoT Core.

  • disconnectReason: motivo da desconexão. Será “UNKNOWN” para um dispositivo que nunca foi conectado ou para o qual o Fleet Indexing não tenha o último motivo de desconexão armazenado.

  • connected: o valor booliano falso indicando que esse dispositivo está desconectado no momento.

  • timestamp: o carimbo de data/hora não é exibido para um dispositivo que nunca foi conectado ou para o qual o Fleet Indexing não tem o último carimbo de data/hora armazenado.