Coletar e transferir dados 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á.

Coletar e transferir dados com campanhas

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

Você cria as campanhas na nuvem. Após a aprovação das campanhas por você ou por sua equipe, o AWS IoT FleetWise realiza a implantação automática 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.

nota

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. Acesse o console do AWS IoT FleetWise.

    2. Na página inicial do serviço, na seção Comece a usar o AWS IoT FleetWise, selecione Explorar o Edge Agent.

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

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

signalCatalogArn

O nome de recurso da Amazon (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 de uma frota na 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 Atualmente, o IoT FleetWise é compatível com 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 utiliza 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 devem ser coletados. 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.

(Opcional) triggerMode pode ser um dos valores a seguir.

  • 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.​

(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) conditionLanguageVersion

A versão da linguagem de expressão condicional.

timeBasedCollectionScheme

Ao definir um esquema de coleta baseado em tempo, especifique um período de tempo 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.

(Opcional) compression

Para economizar largura de banda sem fio e reduzir o tráfego de rede, você pode especificar SNAPPY para compactar dados em veículos.

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

dataDestinationConfigs

Selecione o destino para onde a campanha transferirá os dados do veículo. Você pode optar por armazenar dados no Amazon S3 ou no Amazon Timestream.

S3 é 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.

(Opcional) dataExtraDimensions

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

(Opcional) description

Você pode adicionar uma descrição para ajudar a identificar o propósito da campanha.

(Opcional) diagnosticsMode

Quando o modo de diagnóstico está configurado para SEND_ACTIVE_DTCS, a campanha envia códigos de problemas de diagnóstico (DTCs) padrão armazenados que ajudam a identificar o que há de errado em 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

Você pode definir 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:00 UTC)

(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) do motor. Mesmo que o RPM ultrapasse 7.000 apenas uma vez, isso poderá 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

Você pode especificar um 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.

Importante

Os sinais utilizados na expressão para o esquema de coleta baseado em condições devem ser especificados neste campo.

name

O nome do sinal do qual os dados são coletados quando o esquema de coleta de dados é invocado.

(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 é chamado.

(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 O 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 operação da API UpdateCampaign. Após a aprovação da campanha, o AWS IoT FleetWise implantará automaticamente a campanha no veículo ou frota alvo. Para obter mais informações, consulte Atualizar uma campanha (AWS CLI).

  • RUNNING — A campanha está ativa.

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

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

  • CreateCampaign — Cria uma campanha.

  • UpdateCampaign — Atualiza uma campanha existente. Após a criação de uma campanha, você deverá usar esta operação de API 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