Colete FleetWise dados de AWS IoT com campanhas - AWS IoT FleetWise

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á.

Colete FleetWise dados de AWS IoT com campanhas

Importante

O acesso a determinados FleetWise recursos de AWS IoT está atualmente bloqueado. Para obter mais informações, consulte AWS Disponibilidade de regiões e recursos na AWS IoT FleetWise.

Uma campanha é uma orquestração de regras de coleta de dados. As campanhas fornecem instruções ao FleetWise software Edge Agent para AWS IoT sobre como selecionar, coletar e transferir dados para a nuvem.

Você cria as campanhas na nuvem. Depois que você ou sua equipe aprovam uma campanha, a AWS IoT a implanta FleetWise automaticamente nos veículos. Você pode escolher implantar uma campanha em um veículo ou em uma frota de veículos. O software Edge Agent não inicia a coleta de dados até que uma campanha em execução seja implantada no veículo.

Importante

As campanhas não funcionarão até que você tenha o seguinte.

  • O software Edge Agent está em execução no seu veículo. Para obter mais informações sobre como desenvolver, instalar e trabalhar com o software Edge Agent, faça o seguinte.

    1. Abra o console AWS de IoT. FleetWise

    2. Na página inicial do serviço, na FleetWise seção Introdução à AWS IoT, escolha Explore o Edge Agent.

  • Você se configurou AWS IoT Core para provisionar seu veículo. Para obter mais informações, consulte Provisionar AWS veículos de IoT FleetWise .

nota

Você também pode Monitore o último estado conhecido de seus veículos (não frotas) quase em tempo real usando modelos de estado que permitem transmitir dados de telemetria com uma estratégia de atualização “On Change” ou “Periódica”. O recurso também fornece recursos “On Demand” para ativar ou desativar modelos implantados anteriormente ou solicitar o estado atual do veículo uma única vez (busca).

O acesso ao último estado conhecido está atualmente bloqueado. Para obter mais informações, consulte AWS Disponibilidade de regiões e recursos na AWS IoT FleetWise.

Cada item da lista contém as seguintes informações.

signalCatalogArn

O Amazon Resource Name (ARN) do catálogo de sinais associado à campanha.

(Opcional) tags

Tags são metadados que podem ser usados para gerenciar a campanha. Você pode atribuir a mesma tag a recursos de serviços diferentes para indicar que os recursos estão relacionados.

TargetArn

O ARN de um veículo ou frota no qual a campanha é implantada.

name

Um nome exclusivo que ajuda a identificar a campanha.

collectionScheme

Os esquemas de coleta de dados fornecem instruções ao software Edge Agent sobre quais dados coletar ou quando coletá-los. AWS FleetWise Atualmente, a IoT suporta o esquema de coleta baseado em condições e o esquema de coleta baseado em tempo.

  • conditionBasedCollectionScheme— o esquema de coleta baseado em condições usa uma expressão lógica para reconhecer quais dados coletar. O software Edge Agent coleta dados quando a condição é atendida.

    • expression— a expressão lógica usada para reconhecer quais dados coletar. Por exemplo, se a expressão $variable.`myVehicle.InVehicleTemperature` > 50.0 for especificada, o software Edge Agent coletará valores de temperatura superiores a 50,0. Consulte instruções de como escrever expressões em Expressões lógicas para campanhas AWS de IoT FleetWise.

    • (Opcional) conditionLanguageVersion — a versão da linguagem de expressão condicional.

    • (Opcional) minimumTriggerIntervalMs — a duração mínima entre dois eventos de coleta de dados, em milissegundos. Se um sinal mudar com frequência, você poderá coletar dados em uma taxa mais lenta.

    • (Opcional) triggerMode — pode ser um dos seguintes valores:

      • RISING_EDGE— o software Edge Agent coleta dados somente quando a condição é atendida pela primeira vez. Por exemplo, $variable.`myVehicle.AirBagDeployed` == true.

      • ALWAYS — O software Edge Agent coleta dados sempre que a condição é atendida.​

  • timeBasedCollectionScheme— ao definir um esquema de coleta baseado em tempo, especifique um período em milissegundos. O software Edge Agent usa o período de tempo para decidir com que frequência coletar dados. Por exemplo, se o período for de 120.000 milissegundos, o software Edge Agent coletará dados uma vez a cada dois minutos.

    • periodMs— o período de tempo (em milissegundos) para decidir com que frequência coletar dados.

(Opcional) compression

Para economizar largura de banda sem fio e reduzir o tráfego de rede, você pode especificar SNAPPYa compactação de dados em veículos.

Por padrão (OFF), o software Edge Agent não compacta dados.

dataDestinationConfigs

Escolha o único destino para o qual a campanha transferirá os dados do veículo. Você pode enviar os dados para um MQTTtópico ou armazená-los no Amazon S3 ou no Amazon Timestream.

MQTT(Message Queuing Telemetry Transport) é um protocolo de mensagens leve e amplamente adotado. Você pode publicar dados em um MQTT tópico para criar suas próprias arquiteturas orientadas por eventos usando regras. AWS IoT AWS IoT o suporte para MQTT é baseado na especificação MQTTv3.1.1 e na especificação MQTT v5.0, com algumas diferenças. Para obter mais informações, consulte MQTTas diferenças.

O S3 pode ser um mecanismo de armazenamento de dados econômico que oferece recursos duráveis de gerenciamento de dados e serviços de dados downstream. Você pode usar o S3 para dados relacionados ao comportamento de direção ou análise de manutenção de longo prazo.

Timestream é um mecanismo de persistência de dados que ajuda a identificar tendências e padrões quase em tempo real. Você pode usar o Timestream para dados de séries temporais, por exemplo, para analisar tendências passadas na velocidade ou frenagem do veículo.

nota

O Amazon Timestream não está disponível na região Ásia-Pacífico (Mumbai).

(Opcional) dataExtraDimensions

Você pode adicionar um ou mais atributos para fornecer informações adicionais para um sinal.

(Opcional) dataPartitions

Crie uma partição de dados para armazenar temporariamente os dados do sinal em um veículo. Você configura quando e como encaminhar os dados para a nuvem.

  • Especifique como a AWS IoT FleetWise armazena os dados em um veículo ou frota definindo o tamanho máximo de armazenamento, o tempo mínimo de vida e o local de armazenamento.

  • A campanha spoolingMode deve serTO_DISK.

  • As configurações de upload incluem a definição da versão da linguagem da condição e da expressão lógica.

(Opcional) description

Adicione uma descrição para ajudar a identificar o objetivo da campanha.

(Opcional) diagnosticsMode

Quando o modo de diagnóstico está configurado paraSEND_ACTIVE_DTCS, a campanha envia códigos de problemas de diagnóstico padrão armazenados (DTCs) que ajudam a identificar o que está errado com seu veículo. Por exemplo, P0097 indica que o módulo de controle do motor (ECM) determinou que a entrada do sensor de temperatura do ar de admissão 2 (IAT2) está abaixo da faixa normal do sensor.

Por padrão (OFF), o software Edge Agent não envia códigos de diagnóstico.

(Opcional) expiryTime

Defina a data de expiração da sua campanha. Quando a campanha expira, o software Edge Agent para de coletar dados conforme especificado na campanha. Se diversas campanhas forem implantadas no veículo, o software Edge Agent usará outras campanhas para coletar dados.

Valor padrão: 253402243200 (31 de dezembro de 9999, 00:00:00UTC)

(Opcional) postTriggerCollectionDuration

Você pode definir uma duração de coleta pós-acionamento, para que o software Edge Agent continue coletando dados por um período especificado após um esquema ser invocado. Por exemplo, se um esquema de coleta baseado em condições com a seguinte expressão for invocado:$variable.`myVehicle.Engine.RPM` > 7000.0, o software Edge Agent continuará coletando valores de rotações por minuto (RPM) para o mecanismo. Mesmo que RPM só suba mais de 7000 uma vez, isso pode indicar que há um problema mecânico. Nesse caso, o software Edge Agent pode continuar coletando dados para ajudar a monitorar a condição.

Valor padrão: 0

(Opcional) priority

Especifique um número inteiro para indicar o nível de prioridade da campanha. Campanhas com um número menor têm prioridade mais alta. Se você implantar diversas campanhas em um veículo, as campanhas com maior prioridade serão iniciadas primeiro.

Valor padrão: 0

(Opcional) signalsToCollect

Uma lista de sinais dos quais os dados são coletados quando o esquema de coleta de dados é invocado.

  • name— o nome do sinal a partir do qual os dados são coletados quando o esquema de coleta de dados é invocado.

  • dataPartitionId— o ID da partição de dados a ser usada no sinal. O ID deve corresponder a um dos IDs fornecidos emdataPartitions. Se você carregar um sinal como condição em sua partição de dados, esses mesmos sinais deverão ser incluídossignalsToCollect.

  • (Opcional) maxSampleCount — o número máximo de amostras de dados que o software Edge Agent coleta e transfere para a nuvem quando o esquema de coleta de dados é invocado.

  • (Opcional) minimumSamplingIntervalMs — a duração mínima entre dois eventos de coleta de amostras de dados, em milissegundos. Se um sinal muda frequentemente, você pode usar este parâmetro para coletar dados em uma taxa mais lenta.

    Intervalo válido: de 0 a 4294967295

(Opcional) spoolingMode

Se spoolingMode estiver configurado para TO_DISK, o software Edge Agent armazenará temporariamente os dados localmente quando um veículo não estiver conectado à nuvem. Após o restabelecimento da conexão, os dados armazenados localmente serão transferidos automaticamente para a nuvem.

Valor padrão: OFF

(Opcional) startTime

Uma campanha aprovada é ativada na hora de início.

Valor padrão: 0

O status de uma campanha pode ser um dos valores a seguir.

  • CREATING— AWS A IoT FleetWise está processando sua solicitação para criar a campanha.

  • WAITING_FOR_APPROVAL — Depois que uma campanha é criada, ela entra no estado WAITING_FOR_APPROVAL. Para aprovar a campanha, use a UpdateCampaign API operação. Depois que a campanha é aprovada, a AWS IoT implanta FleetWise automaticamente a campanha no veículo ou frota alvo. Para obter mais informações, consulte Atualizar uma campanha AWS de IoT FleetWise .

  • RUNNING — A campanha está ativa.

  • SUSPENDED — A campanha está suspensa. Para retomar a campanha, use a UpdateCampaign API operação.

AWS A IoT FleetWise fornece as seguintes API operações que você pode usar para criar e gerenciar campanhas.

  • CreateCampaign— Cria uma nova campanha.

  • UpdateCampaign— Atualiza uma campanha existente. Depois que uma campanha é criada, você deve usar essa API operação para aprová-la.

  • DeleteCampaign— Exclui uma campanha existente.

  • ListCampaigns— Recupera uma lista paginada de resumos de todas as campanhas.

  • GetCampaign— Recupera informações sobre uma campanha.

Tutoriais