View a markdown version of this page

Crea una AWS FleetWise Campaña de IoT - AWS IoT FleetWise
Creación de una campaña (consola)Crear una campaña (AWS CLI)

AWS FleetWise El IoT ya no está abierto a nuevos clientes. FleetWise Los clientes actuales de AWS IoT pueden seguir utilizando el servicio. La Guía para la movilidad conectada AWS proporciona orientación sobre cómo desarrollar e implementar servicios modulares para soluciones de movilidad conectada que puedan usarse para lograr capacidades equivalentes a las del 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.

Crea una AWS FleetWise Campaña de IoT

importante

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

Puedes usar la FleetWise consola o la API de AWS IoT para crear campañas que recopilen datos del vehículo.

importante

Para que la campaña funcione, 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 a AWS usar IoT, elija Explore Edge Agent.

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

Temas

Creación de una campaña (consola)

Usa la FleetWise consola de AWS IoT para crear una campaña para seleccionar, recopilar y transferir los datos del vehículo a la nube.

Para crear una campaña

  1. Abre la FleetWise consola AWS de IoT.

  2. En el panel de navegación, elija Campañas.

  3. En la página Campañas, elija Crear campaña y, a continuación, complete los pasos de los siguientes temas.

importante

Paso 1: Configurar la campaña

En la sección Información general, haga lo siguiente:

  1. Introduzca un nombre para la campaña.

  2. (Opcional) Introduzca una descripción.

Configure el esquema de recopilación de datos de la campaña. Un esquema de recopilación de datos proporciona al software Edge Agent instrucciones sobre qué datos deben recopilarse y cuándo debe hacerse. En la FleetWise consola de AWS IoT, puede configurar un esquema de recopilación de datos de las siguientes maneras:

  • Defina de forma manual el esquema de recopilación de datos.

  • Cargue un archivo para definir automáticamente el esquema de recopilación de datos.

En Opción de configuración, elija cualquiera de las siguientes opciones:

  • Para especificar manualmente el tipo de esquema de recopilación de datos y definir las opciones para personalizarlo, elija Definir el esquema de recopilación de datos.

Especifique manualmente el tipo de esquema de recopilación de datos y defina las opciones para personalizar el esquema.

  1. En la sección Detalles del esquema de recopilación de datos, elija el tipo de esquema de recopilación de datos que desea que use la campaña. Para usar una expresión lógica para reconocer qué datos del vehículo se van a recopilar, elija Condition-based. Para usar un período de tiempo específico para decidir con qué frecuencia recopilar los datos del vehículo, elija Time-based.

  2. Defina el tiempo durante el que la campaña recopila datos.

    nota

    De forma predeterminada, una campaña aprobada se activa de inmediato y no tiene una hora de finalización establecida. Para evitar cargos adicionales, debe especificar un intervalo de tiempo.

  3. Si especificaste un esquema de recopilación de datos basado en condiciones, debes definir una expresión lógica para reconocer qué datos recopilar. AWS El IoT FleetWise usa una expresión lógica para reconocer qué datos recopilar para un esquema basado en condiciones. La expresión debe especificar el nombre completo de una señal como variable, un operador de comparación y un valor de comparación.

    Por ejemplo, si especificas la $variable.`myVehicle.InVehicleTemperature` > 50.0 expresión, el AWS IoT FleetWise recopila valores de temperatura superiores a 50,0. Para obtener instrucciones acerca de cómo escribir expresiones, consulte Expresiones lógicas para AWS FleetWise Campañas de IoT.

    Introduzca la expresión lógica que se utiliza para reconocer qué datos deben recopilarse.

  4. (Opcional) Especifique la versión de idioma de la expresión condicional. El valor predeterminado es 1.

  5. (Opcional) Especifique el intervalo mínimo de activación, que es el tiempo mínimo entre dos eventos de recopilación de datos. Por ejemplo, si una señal cambia con frecuencia, es conveniente recopilar datos a un ritmo más lento.

  6. Especifique la condición del Modo del desencadenador para que el software Edge Agent recopile datos. De forma predeterminada, el FleetWise software Edge Agent para AWS IoT siempre recopila datos cuando se cumple la condición. O bien solo puede recopilar datos cuando se cumple la condición por primera vez, En el primer desencadenador.

  7. Si ha especificado un esquema de recopilación de datos basado en el tiempo, debe especificar un Periodo en milisegundos, de 10 000 a 60 000 milisegundos. El software Edge Agent utiliza el periodo para decidir con qué frecuencia deben recopilarse datos.

  8. (Opcional) Edite las opciones avanzadas del esquema.

    1. Para ahorrar ancho de banda inalámbrico y reducir el tráfico de red mediante la compresión de datos, elija Snappy.

    2. (Opcional) Para definir cuánto tiempo, en milisegundos, se deben seguir recopilando datos tras un evento de recopilación de datos, puede especificar la Duración de la recopilación posterior al desencadenador.

    3. (Opcional) Para indicar el nivel de prioridad de la campaña, especifique la prioridad de la campaña. Las campañas con un número de prioridad menor se implementan primero y se considera que tienen una prioridad más alta.

    4. El software Edge Agent puede almacenar temporalmente datos de forma local cuando un 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. Especifique si desea que Edge Agent almacene los datos de forma local durante una pérdida de conexión.

    5. (Opcional) Para proporcionar información adicional para una señal, agregue hasta cinco atributos como Dimensiones de datos adicionales.

Cargue un archivo .json con detalles sobre el esquema de recopilación de datos.

  1. Para importar información sobre el esquema de recopilación de datos, elija Elegir archivos. Para obtener más información sobre el formato de archivo requerido, consulta la documentación de la CreateCampaign API.

    nota

    AWS FleetWise Actualmente, IoT admite la extensión de formato de archivo.json.

  2. AWS El IoT define FleetWise automáticamente el esquema de recopilación de datos en función de la información del archivo. Revisa las opciones que AWS IoT FleetWise seleccionó para ti. Puede actualizar las opciones si es necesario.

Paso 2: Especifique las condiciones de almacenamiento y carga

Para decidir si el software Edge Agent almacenará temporalmente los datos de forma local cuando el vehículo no esté conectado a la nube, especifica el modo de almacenamiento.

  • En el modo de almacenamiento de datos, elige una de las siguientes opciones:

    • No se almacena: el software Edge Agent recopila datos de forma local, pero no los almacena temporalmente cuando un vehículo está desconectado. El software Edge Agent transfiere los datos a la nube cuando el vehículo se vuelve a conectar.

    • Almacenado en disco: el software Edge Agent recopila y almacena temporalmente los datos de forma local cuando un vehículo está desconectado. Los datos recopilados se almacenan temporalmente en una ubicación definida en la sección de «persistencia» del archivo de configuración del Edge Agent. El Edge Agent transfiere los datos a la nube cuando el vehículo se vuelve a conectar.

    • Almacenados en un disco con particiones: el vehículo siempre almacena temporalmente los datos en el Edge, en la partición de datos especificada. Puedes elegir cuándo quieres reenviar los datos almacenados a la nube.

      1. (Opcional) Introduzca un ID de partición para designar un conjunto de datos en particular.

      2. Introduzca un nombre de carpeta como ubicación en la que se almacenarán los datos. La ruta absoluta de la ubicación de almacenamiento es{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}.

      3. Introduzca el tamaño máximo de almacenamiento de los datos almacenados en la partición. Los datos más recientes sobrescriben los datos más antiguos cuando la partición alcanza el tamaño máximo.

      4. Introduzca la cantidad mínima de tiempo que los datos de esta partición permanecerán en el disco.

      5. (Opcional) Introduzca las condiciones de carga de la partición.

Especificación de señales

Puede especificar las señales de las que desea recopilar datos durante la campaña.

Para especificar las señales de las que se van a recopilar datos

  1. Selecciona el nombre de la señal.

  2. (Opcional) Para obtener el número máximo de muestras, introduce el número máximo de muestras de datos que el software Edge Agent recopila y transfiere a la nube durante la campaña.

  3. (Opcional) En Intervalo de muestreo mínimo, introduzca 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.

  4. Para agregar otra señal, elija Agregar más señales. Puede agregar hasta 999 señales.

  5. Elija Siguiente.

Paso 3: Configurar el destino de los datos

nota

Si la campaña contiene señales de datos del sistema de visión, solo puede almacenar los datos del vehículo en Amazon S3. No puedes almacenarlos en Timestream ni enviarlos a un tema de MQTT.

Los datos de sistemas de visión están en versión de vista previa y sujetos a cambios.

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

Elija el destino al que desea enviar o almacenar los datos recopilados por la campaña. Puede enviar datos del vehículo a un tema de MQTT o almacenarlos en Amazon S3 o Amazon Timestream.

En Configuración de destino, haga lo siguiente:

  • Elija el tema de Amazon S3, Amazon Timestream o MQTT en la lista desplegable.

importante

Solo puede transferir datos a S3 si AWS IoT FleetWise tiene permisos para escribir en el bucket de S3. Para obtener más información sobre cómo conceder el acceso, consulte Controlar el acceso con AWS IoT FleetWise.

Para guardar los datos del vehículo en un bucket de S3, elija Amazon S3. S3 es un servicio de almacenamiento de objetos que almacena datos como objetos dentro de buckets. Para obtener más información, consulte Crear, configurar y trabajar con cubos de Amazon S3 en la Guía del usuario de Amazon Simple Storage Service.

S3 optimiza el costo del almacenamiento de datos y proporciona mecanismos adicionales para utilizar los datos de los vehículos, como los lagos de datos, el almacenamiento centralizado de datos, los procesos de procesamiento de datos y los análisis. Puede usar S3 para almacenar datos para su procesamiento y análisis por lotes. Por ejemplo, puede crear informes de eventos de frenada brusca para el modelo de machine learning (ML). Los datos entrantes del vehículo se almacenan en un búfer durante 10 minutos antes de la entrega.

En Configuración de destino de S3, haga lo siguiente:

  1. En Bucket de S3, elija un bucket para el que AWS IoT FleetWise tenga permisos.

  2. (Opcional) Introduzca un prefijo personalizado que puede usar para organizar los datos almacenados en el bucket de S3.

  3. Elija el formato de salida, que es el formato de los archivos que se guardan en el bucket de S3.

  4. Elija si desea comprimir los datos almacenados en el bucket de S3 como un archivo .gzip. Recomendamos comprimir los datos para minimizar los costos de almacenamiento.

  5. Las opciones seleccionadas en la configuración de destino de S3 cambian el URI del objeto S3 del ejemplo. Este es un ejemplo del tipo de archivos que se guardan en S3.

importante

Solo puede transferir datos a una tabla si AWS IoT FleetWise tiene permisos para escribir datos en Timestream. Para obtener más información sobre cómo conceder el acceso, consulte Controlar el acceso con AWS IoT. FleetWise

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

Para almacenar los datos del vehículo en una tabla de Timestream, elija Amazon Timestream. Puede utilizar Timestream para consultar los datos del vehículo y así identificar tendencias y patrones. Por ejemplo, puede utilizar Timestream para crear una alarma para el nivel de combustible del vehículo. Los datos entrantes del vehículo se transfieren a Timestream casi en tiempo real. Para obtener más información, consulte ¿Qué es Amazon Timestream? en la guía para desarrolladores de Amazon Timestream.

En Configuración de la tabla de Timestream, haga lo siguiente:

  1. En Nombre de base de datos de Timestream, elija el nombre de la base de datos de Timestream en la lista desplegable.

  2. En Nombre de tabla de Timestream, elija el nombre de la tabla de Timestream en la lista desplegable.

En Acceso al servicio para Timestream, haga lo siguiente:

  • Elija un rol de IAM en la lista desplegable.

importante

Solo puede enviar datos a un tema de MQTT si AWS IoT FleetWise tiene permisos para acceder a los temas. AWS IoT Para obtener más información sobre cómo conceder el acceso, consulte Controlar el acceso con AWS IoT FleetWise.

Para enviar datos del vehículo a un tema de MQTT, elija el tema de MQTT.

Los datos del vehículo enviados por mensajería MQTT se entregan prácticamente en tiempo real y te permiten utilizar las reglas para tomar medidas o enviar los datos a otros destinos. Para obtener más información sobre el uso de MQTT, consulte los protocolos y reglas de comunicación de los dispositivos AWS IoT en la Guía para AWS IoT Core desarrolladores.

  1. En el tema MQTT, introduzca el nombre del tema.

  2. En el tema Acceso a los servicios para MQTT, elige si quieres dejar que AWS IoT FleetWise cree y utilice un nuevo rol de servicio para ti. Si desea utilizar una función de servicio existente, seleccione la función en la lista desplegable situada debajo de Seleccionar función.

  • Elija Siguiente.

Paso 4: Añadir vehículos

Para elegir en qué vehículos desea implementar la campaña, selecciónelos en la lista de vehículos. Filtre los vehículos buscando los atributos y valores que les agregó al crearlos, o bien buscando por nombre de vehículo.

En Filtrar vehículos, haga lo siguiente:

  1. En el cuadro de búsqueda, busque el atributo o el nombre del vehículo y elíjalo de la lista.

    nota

    Cada atributo puede utilizarse solo una vez.

  2. Introduzca el valor del atributo o el nombre del vehículo en el que desee implementar la campaña. Por ejemplo, si el nombre completo del atributo es fuelType, introduzca gasoline como valor.

  3. Para buscar otro atributo del vehículo, repita los pasos anteriores. Puede buscar hasta cinco atributos de vehículo y un número ilimitado de nombres de vehículo.

  4. Los vehículos que coinciden con la búsqueda aparecen en Nombre del vehículo. Elija los vehículos en los que desee implementar la campaña.

    nota

    En los resultados de la búsqueda se muestran hasta 100 vehículos. Elija Seleccionar todo para agregar todos los vehículos a la campaña.

  5. Elija Siguiente.

Paso 5: Revisar y crear

Verifique las configuraciones de la campaña y, a continuación, elija Crear campaña.

nota

Tras crear una campaña, usted o su equipo deben implementarla en los vehículos.

Paso 6: Despliega una campaña

Tras crear una campaña, usted o su equipo deben implementarla en los vehículos.

Para implementar una campaña

  1. En la página Resumen de la campaña, elija Implementar.

  2. Revise y confirme que desea iniciar la implementación y empezar a recopilar datos de los vehículos conectados a la campaña.

  3. Elija Implementar.

Si desea detener la recopilación de datos de los vehículos conectados a la campaña, en la página Resumen de la campaña elija Suspender. Para reanudar la recopilación de datos de los vehículos conectados a la campaña, elija Reanudar.

Crear una campaña (AWS CLI)

Puedes usar la operación de la CreateCampaign API para crear una campaña. El siguiente ejemplo utiliza AWS CLI.

Al crear una campaña, los datos recopilados de los vehículos pueden enviarse a un tema de MQTT o almacenarse en Amazon S3 (S3) o Amazon Timestream. Elija Timestream para obtener una base de datos de serie temporal rápida, escalable y sin servidor; por ejemplo, para almacenar datos que requieren un procesamiento casi en tiempo real. Elija S3 para almacenar objetos con escalabilidad, disponibilidad de datos, seguridad y rendimiento líderes del sector. Elija MQTT para entregar datos prácticamente en tiempo real y utilizar las reglas para realizar las acciones que AWS IoT defina o dirija los datos a otros destinos.

importante

Solo puedes transferir datos de vehículos a un tema de MQTT, Amazon S3 o Amazon Timestream si AWS IoT FleetWise tiene permisos para enviar mensajes en MQTT en tu nombre o para escribir datos en S3 o Timestream. Para obtener más información sobre cómo conceder el acceso, consulte Controlar el acceso con IoT. AWS FleetWise

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

Creación de una campaña

importante

Para crear una campaña, ejecute el siguiente comando:

file-nameSustitúyalo por el nombre del archivo.json que contiene la configuración de la campaña.

aws iotfleetwise create-campaign --cli-input-json file://file-name.json

  • campaign-nameSustitúyelo por el nombre de la campaña que estás creando.

  • signal-catalog-arnSustitúyalo por el nombre de recurso de Amazon (ARN) del catálogo de señales.

  • target-arnSustitúyalo por el ARN de una flota o un vehículo que hayas creado.

  • bucket-arnSustitúyalo por el ARN del bucket S3.

{
    "name": "campaign-name",
    "targetArn": "target-arn", 
    "signalCatalogArn": "signal-catalog-arn", 
    "collectionScheme": {
        "conditionBasedCollectionScheme": {
            "conditionLanguageVersion": 1,
            "expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
            "minimumTriggerIntervalMs": 1000,
            "triggerMode": "ALWAYS"
        }
    },
    "compression": "SNAPPY",
    "diagnosticsMode": "OFF",
    "postTriggerCollectionDuration": 1000,
    "priority": 0,
    "signalsToCollect": [
        {
         "maxSampleCount": 100,
         "minimumSamplingIntervalMs": 0,
         "name": "Vehicle.DemoEngineTorque"
        },
        {
         "maxSampleCount": 100,
         "minimumSamplingIntervalMs": 0,
         "name": "Vehicle.DemoBrakePedalPressure"
        }
    ],
    "spoolingMode": "TO_DISK",
    "dataDestinationConfigs": [
        {
         "s3Config": { 
             "bucketArn": "bucket-arn",
             "dataFormat": "PARQUET",
             "prefix": "campaign-name",
              "storageCompressionFormat": "GZIP"
      }
    }
  ],
     "dataPartitions": [ 
      { ...  }
  ]
}
nota

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

  • campaign-nameSustitúyalo por el nombre de la campaña que está creando.

  • signal-catalog-arnSustitúyalo por el ARN del catálogo de señales.

  • target-arnSustitúyalo por el ARN de una flota o un vehículo que hayas creado.

  • role-arnSustitúyalo por el ARN del rol de ejecución de la tarea que otorga FleetWise permiso al AWS IoT para enviar datos a la tabla Timestream.

  • table-arnSustitúyalo por el ARN de la tabla Timestream.

{
  "name": "campaign-name",
  "targetArn": "target-arn",
  "signalCatalogArn": "signal-catalog-arn",
  "collectionScheme": {
    "conditionBasedCollectionScheme": {
      "conditionLanguageVersion": 1,
      "expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
      "minimumTriggerIntervalMs": 1000,
      "triggerMode": "ALWAYS"
    }
  },
  "compression": "SNAPPY",
  "diagnosticsMode": "OFF",
  "postTriggerCollectionDuration": 1000,
  "priority": 0,
  "signalsToCollect": [
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoEngineTorque"
    },
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoBrakePedalPressure"
    }
  ],
  "spoolingMode": "TO_DISK",
  "dataDestinationConfigs": [
    {
      "timestreamConfig": {
        "executionRoleArn": "role-arn",
        "timestreamTableArn": "table-arn"
      }
    }
  ],
   "dataPartitions": [ 
      { ...  }
  ]
}

  • campaign-nameSustitúyalo por el nombre de la campaña que está creando.

  • signal-catalog-arnSustitúyalo por el nombre de recurso de Amazon (ARN) del catálogo de señales.

  • target-arnSustitúyalo por el ARN de una flota o un vehículo que hayas creado.

  • topic-arnSustitúyalo por el ARN del tema de MQTT que especificaste como destino para los mensajes que contienen datos del vehículo.

  • role-arnSustitúyalo por el ARN del rol de ejecución de tareas que otorga a AWS IoT FleetWise permiso para enviar y recibir mensajes relacionados con el tema de MQTT que especificó y tomar medidas al respecto.

{
  "name": "campaign-name",
  "targetArn": "target-arn",
  "signalCatalogArn": "signal-catalog-arn",
  "collectionScheme": {
    "conditionBasedCollectionScheme": {
      "conditionLanguageVersion": 1,
      "expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
      "minimumTriggerIntervalMs": 1000,
      "triggerMode": "ALWAYS"
    }
  },
  "compression": "SNAPPY",
  "diagnosticsMode": "OFF",
  "postTriggerCollectionDuration": 1000,
  "priority": 0,
  "signalsToCollect": [
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoEngineTorque"
    },
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoBrakePedalPressure"
    }
  ],
  "spoolingMode": "TO_DISK",
  "dataDestinationConfigs": [
      {
          "mqttTopicConfig": {
              "mqttTopicArn": "topic-arn",
              "executionRoleArn": "role-arn"
          }
      }
  ]
}

Si ha habilitado el cifrado mediante una AWS KMS clave gestionada por el cliente, incluya la siguiente declaración de política para que su función pueda invocar la operación de la CreateCampaign API.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:GenerateDataKey*",
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
            ]
        }
    ]
}