Recopile FleetWise datos de AWS IoT con campañas - AWS IoT FleetWise

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Recopile FleetWise datos de AWS IoT con campañas

importante

El acceso a ciertas FleetWise funciones de AWS IoT está actualmente restringido. Para obtener más información, consulte AWS Disponibilidad regional y de funciones en el AWS IoT FleetWise.

Una campaña es una orquestación de reglas de recopilación de datos. Las campañas proporcionan al FleetWise software Edge Agent para AWS IoT instrucciones sobre cómo seleccionar, recopilar y transferir datos a la nube.

Usted crea campañas en la nube. Una vez que tú o tu equipo aprueben una campaña, el AWS IoT la despliega FleetWise automáticamente en los vehículos. Puede optar por implementar una campaña en un vehículo o en una flota de vehículos. El software Edge Agent no comienza a recopilar datos hasta que se implementa una campaña activa en el vehículo.

importante

Para que las campañas funcionen, debe disponer de lo siguiente:

  • El software Edge Agent ejecutándose en el vehículo. Para obtener más información sobre cómo desarrollar, instalar y trabajar con el software Edge Agent, haga lo siguiente.

    1. Abre la FleetWise consola AWS de IoT.

    2. En la página de inicio del servicio, en la FleetWise sección Comenzar con AWS IoT, elija Explore Edge Agent.

  • Lo has configurado AWS IoT Core para aprovisionar tu vehículo. Para obtener más información, consulte Aprovisionamiento AWS de FleetWise vehículos de IoT.

nota

También puedes utilizar plantillas de estado Supervisa el último estado conocido de tus vehículos (no de flotas) prácticamente en tiempo real, que te permiten transmitir datos de telemetría con una estrategia de actualización «en caso de cambio» o «periódica». La función también incluye funciones «bajo demanda» para activar o desactivar las plantillas desplegadas anteriormente o solicitar el estado actual del vehículo una sola vez (recuperarlo).

El acceso al último estado conocido está actualmente restringido. Para obtener más información, consulte AWS Disponibilidad regional y de funciones en el AWS IoT FleetWise.

Cada elemento de la lista contiene la siguiente información:

signalCatalogArn

El nombre del recurso de Amazon (ARN) del catálogo de señales asociado a la campaña.

(Opcional) tags

Las etiquetas son metadatos que se pueden utilizar para administrar la campaña. Puede asignar la misma etiqueta a los recursos de diferentes servicios para indicar que los recursos están relacionados.

TargetArn

El vehículo o ARN la flota en los que se despliega la campaña.

name

Un nombre único que ayuda a identificar la campaña.

collectionScheme

Los esquemas de recopilación de datos proporcionan al software Edge Agent instrucciones sobre qué datos recopilar o cuándo recopilarlos. AWS FleetWise Actualmente, el IoT admite el esquema de recolección basado en condiciones y el esquema de recolección basado en el tiempo.

  • conditionBasedCollectionScheme— el esquema de recopilación basado en condiciones utiliza una expresión lógica para reconocer qué datos recopilar. El software Edge Agent recopila datos cuando se cumple la condición.

    • expression— la expresión lógica que se utiliza para reconocer qué datos recopilar. Por ejemplo, si se especifica la expresión $variable.`myVehicle.InVehicleTemperature` > 50.0, el software Edge Agent recopila valores de temperatura superiores a 50,0. Para obtener instrucciones acerca de cómo escribir expresiones, consulte Expresiones lógicas para FleetWise campañas AWS de IoT.

    • (Opcional)conditionLanguageVersion: la versión del lenguaje de expresiones condicionales.

    • (Opcional)minimumTriggerIntervalMs: el tiempo mínimo entre dos eventos de recopilación de datos, en milisegundos. Si una señal cambia con frecuencia, es conveniente recopilar datos a un ritmo más lento.

    • (Opcional)triggerMode: puede ser uno de los siguientes valores:

      • RISING_EDGE— el software Edge Agent recopila datos solo cuando se cumple la condición por primera vez. Por ejemplo, $variable.`myVehicle.AirBagDeployed` == true.

      • ALWAYS: el software Edge Agent recopila datos siempre que se cumpla la condición.

  • timeBasedCollectionScheme— cuando defina un esquema de recopilación basado en el tiempo, especifique un período de tiempo en milisegundos. El software Edge Agent utiliza el periodo para decidir con qué frecuencia deben recopilarse datos. Por ejemplo, si el periodo es de 120 000 milisegundos, el software Edge Agent recopila datos una vez cada dos minutos.

    • periodMs— el período de tiempo (en milisegundos) para decidir con qué frecuencia se recopilarán los datos.

(Opcional) compression

Para ahorrar ancho de banda inalámbrico y reducir el tráfico de la red, puede especificar SNAPPYque se compriman los datos en los vehículos.

De forma predeterminada (OFF), el software Edge Agent no comprime los datos.

dataDestinationConfigs

Elige el único destino al que la campaña transferirá los datos del vehículo. Puede enviar los datos a un MQTTtema o almacenarlos en Amazon S3 o Amazon Timestream.

MQTT(Message Queuing Telemetry Transport) es un protocolo de mensajería ligero y ampliamente adoptado. Puede publicar datos sobre un MQTT tema para crear sus propias arquitecturas basadas en eventos mediante reglas. AWS IoT AWS IoT el soporte para MQTT se basa en la especificación MQTTv3.1.1 y la especificación MQTT v5.0, con algunas diferencias. Para obtener más información, consulta las diferencias. MQTT

S3 puede ser un mecanismo de almacenamiento de datos rentable que ofrece capacidades duraderas de administración de datos y servicios de datos posteriores. Puede utilizar S3 para obtener datos relacionados con los comportamientos de conducción o para analizar el mantenimiento a largo plazo.

Timestream es un mecanismo de persistencia de datos que puede ayudarlo a identificar tendencias y patrones casi en tiempo real. Puede utilizar Timestream para obtener datos de serie temporal; por ejemplo, para analizar las tendencias históricas en la velocidad o el frenado del vehículo.

nota

Amazon Timestream no está disponible en la región Asia Pacífico (Bombay).

(Opcional) dataExtraDimensions

Puede agregar uno o más atributos para proporcionar información adicional sobre una señal.

(Opcional) dataPartitions

Cree una partición de datos para almacenar temporalmente los datos de señal en un vehículo. Usted configura cuándo y cómo reenviar los datos a la nube.

  • Especifique cómo el AWS IoT FleetWise almacena los datos en un vehículo o flota definiendo el tamaño máximo de almacenamiento, el tiempo mínimo de vida y la ubicación de almacenamiento.

  • La campaña spoolingMode debe serloTO_DISK.

  • Las configuraciones de carga incluyen la definición de la versión del lenguaje de condiciones y la expresión lógica.

(Opcional) description

Agrega una descripción para ayudar a identificar el propósito de la campaña.

(Opcional) diagnosticsMode

Cuando el modo de diagnóstico está configurado para elloSEND_ACTIVE_DTCS, la campaña envía códigos de diagnóstico de problemas estándar y almacenados (DTCs) que ayudan a identificar qué es lo que está mal en tu vehículo. Por ejemplo, el número P0097 indica que el módulo de control del motor (ECM) ha determinado que la entrada del sensor de temperatura del aire de admisión 2 (IAT2) es inferior al rango normal del sensor.

De forma predeterminada (OFF), el software Edge Agent no envía códigos de diagnóstico.

(Opcional) expiryTime

Defina la fecha de caducidad de su campaña. Cuando una campaña caduca, el software Edge Agent deja de recopilar los datos tal y como se especifica en dicha campaña. Si se implementan varias campañas en el vehículo, el software Edge Agent utiliza otras campañas para recopilar datos.

Valor predeterminado: 253402243200 (31 de diciembre de 9999, 00:00:00UTC)

(Opcional) postTriggerCollectionDuration

Puede definir una duración para la recopilación posterior a la activación, de modo que el software Edge Agent siga recopilando datos durante un periodo específico tras invocar un esquema. Por ejemplo, si se invoca un esquema de recopilación basado en condiciones con la siguiente expresión:$variable.`myVehicle.Engine.RPM` > 7000.0, el software Edge Agent continúa recopilando los valores de revoluciones por minuto (RPM) para el motor. Incluso si RPM solo supera las 7000 una vez, podría indicar que se trata de un problema mecánico. En este caso, es posible que desee que el software Edge Agent continúe recopilando datos para ayudar a supervisar el estado del vehículo.

Valor predeterminado: 0

(Opcional) priority

Especifique un número entero para indicar el nivel de prioridad de la campaña. Las campañas con un número menor tienen mayor prioridad. Si implementa varias campañas en un vehículo, las campañas con mayor prioridad se inician primero.

Valor predeterminado: 0

(Opcional) signalsToCollect

Una lista de señales a partir de las cuales se recopilan datos cuando se invoca el esquema de recopilación de datos.

  • name— el nombre de la señal desde la que se recopilan los datos cuando se invoca el esquema de recopilación de datos.

  • dataPartitionId— el ID de la partición de datos que se va a utilizar en la señal. El ID debe coincidir con uno de los IDs proporcionadosdataPartitions. Si carga una señal como condición en su partición de datos, deberá incluir esas mismas señalessignalsToCollect.

  • (Opcional)maxSampleCount: el número máximo de muestras de datos que el software Edge Agent recopila y transfiere a la nube cuando se invoca el esquema de recopilación de datos.

  • (Opcional)minimumSamplingIntervalMs: el tiempo mínimo entre dos eventos de recopilación de muestras de datos, en milisegundos. Si una señal cambia con frecuencia, puede utilizar este parámetro para recopilar datos a un ritmo más lento.

    Rango válido: 0‐4294967295

(Opcional) spoolingMode

Si spoolingMode está configurado para TO_DISK, el software Edge Agent almacena temporalmente los datos de forma local cuando el vehículo no está conectado a la nube. Una vez restablecida la conexión, los datos almacenados localmente se transfieren de forma automática a la nube.

Valor predeterminado: OFF

(Opcional) startTime

Una campaña aprobada se activa a la hora de inicio.

Valor predeterminado: 0

El estado de una campaña puede ser uno de los siguientes valores:

  • CREATING— AWS IoT FleetWise está procesando tu solicitud para crear la campaña.

  • WAITING_FOR_APPROVAL: una vez creada una campaña, esta entra en el estado WAITING_FOR_APPROVAL. Para aprobar la campaña, utilice la UpdateCampaign API operación. Una vez aprobada la campaña, AWS IoT despliega FleetWise automáticamente la campaña en el vehículo o la flota objetivo. Para obtener más información, consulte Actualizar una FleetWise campaña AWS de IoT.

  • RUNNING : la campaña está activa.

  • SUSPENDED: la campaña está suspendida. Para reanudar la campaña, utilice la UpdateCampaign API operación.

AWS El IoT FleetWise proporciona las siguientes API operaciones que puede utilizar para crear y gestionar campañas.

  • CreateCampaign— Crea una nueva campaña.

  • UpdateCampaign— Actualiza una campaña existente. Una vez creada una campaña, debe utilizar esta API operación para aprobarla.

  • DeleteCampaign— Elimina una campaña existente.

  • ListCampaigns— Recupera una lista paginada de resúmenes de todas las campañas.

  • GetCampaign— Recupera información sobre una campaña.

Tutoriales