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. # Integre los datos en SiteWise Edge mediante una puerta de enlace V3 habilitada para MQTT Este tutorial le guía sobre la integración de dispositivos y sensores de terceros que utilizan el protocolo de mensajería MQTT con la puerta de enlace V3 AWS IoT SiteWise habilitada para MQTT. Aprenderá a configurar una puerta de enlace AWS IoT SiteWise perimetral para recopilar y monitorear datos de sus dispositivos compatibles con MQTT. AWS IoT SiteWise le permite recopilar, procesar y monitorear datos de equipos industriales. Utilice las capacidades de SiteWise Edge para optimizar las operaciones de IoT industrial y transformar los datos sin procesar en información procesable. En este tutorial, utilizamos los datos de una demostración de un parque eólico para ilustrar los conceptos clave. Una vez que se familiarice con el proceso, puede repetir el tutorial con sus propios datos. Después de completar este tutorial, puede realizar las siguientes acciones: + Instale y configure una puerta de enlace V3 habilitada para MQTT para recibir datos de dispositivos industriales + Procese y valide los mensajes MQTT entrantes desde su equipo periférico + Vea los datos del dispositivo AWS IoT SiteWise mediante una plataforma de visualización de terceros + Envíe los datos procesados desde su puerta de enlace perimetral Nube de AWS a Además, puede aprovechar las capacidades de su puerta de enlace perimetral conectándose a otros AWS IoT servicios para realizar las siguientes tareas: + Configure AWS IoT reglas para enrutar los datos a servicios como [Amazon S3](https://aws.amazon.com/s3/), [Amazon Timestream](https://aws.amazon.com/timestream/) y. [AWS Lambda](https://aws.amazon.com/lambda/) + Úselo [AWS IoT Device Defender](https://aws.amazon.com/iot-device-defender/)para administrar y actualizar de forma remota las configuraciones de su puerta de enlace. + Implemente la autenticación y la autorización seguras de los dispositivos mediante funciones AWS IoT de seguridad. Para obtener más información, consulte la [AWS IoT seguridad](https://docs.aws.amazon.com/iot/latest/developerguide/iot-security.html) en la *Guía para AWS IoT desarrolladores*. + Cree alertas y notificaciones automatizadas basadas en los datos del equipo. Para obtener más información, consulte [las reglas AWS IoT de la Guía para AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) *desarrolladores*. **nota** Este tutorial hace referencia a servicios, herramientas y documentación de terceros. AWS no es vendedor ni proveedor de productos o servicios de terceros y no puede garantizar la precisión de la información proporcionada por proveedores externos. Evalúe y valide todas las herramientas de terceros antes de implementarlas. **Topics** + [Requisitos previos](#gateway-tutorial-prerequisites) + [Paso 1: Crear una AWS IoT política](#gateway-tutorial-create-iot-policy) + [Paso 2: Crea y configura cualquier cosa AWS IoT](#gateway-tutorial-create-and-configure-aws-iot-thing) + [Paso 3: Configure su puerta de enlace V3 habilitada para SiteWise Edge MQTT](#gateway-tutorial-configure-your-edge-gateway) + [Paso 4: Instale el software SiteWise Edge Gateway](#install-gateway-software) + [Paso 5: Configure el broker EMQX para que se conecte a aplicaciones externas](#configure-emqx-broker-external-applications) + [Paso 6: Publica los datos con Mosquitto](#add-mqtt-data-source) + [Paso 7: Especifique los destinos](#specify-destinations) + [Paso 8: Especificar los filtros de ruta](#specify-path-filters) + [Paso 9: Configura tus recursos AWS de IoT](#configure-iot-resources) + [Paso 10: visualice sus datos](#visualize-your-data) + [Paso 11: Limpiar los recursos después del tutorial](#tutorial-clean-up-resources) + [Recursos adicionales](#additional-resources) ## Requisitos previos Necesitará lo siguiente para completar este tutorial: + Y Cuenta de AWS. Si no dispone de una, consulte [Configura una AWS cuenta](getting-started.md#set-up-aws-account). + Un usuario AWS Identity and Access Management (IAM) con permisos de administrador. Para obtener más información, consulte [Gestión de identidades y accesos para AWS IoT SiteWise](security-iam.md). + La última versión de Python instalada en el dispositivo. **importante** Este tutorial requiere el uso de los recursos creados en el tutorial [sobre ingesta de datos](ingest-data-from-iot-things.md). Debe completarlo antes de continuar con este tutorial. ## Paso 1: Crear una AWS IoT política En este tutorial, se utiliza la AWS IoT política que creó en el tutorial [sobre ingesta de datos](ingest-data-from-iot-things.md). Esta política establece las reglas de seguridad para sus dispositivos y crea una representación digital de sus dispositivos y sensores externos. AWS IoT La política permite que sus dispositivos de terceros envíen datos AWS IoT Core mediante MQTT (Message Queuing Telemetry Transport). Para obtener más información acerca de los mensajes de MQTT, consulte [What is MQTT?](https://aws.amazon.com/what-is/mqtt/). ------ #### [ Console ] Asegúrese de que se complete una política. AWS IoT Para obtener instrucciones detalladas, consulta el [paso 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) del tutorial [sobre la ingesta de datos](ingest-data-from-iot-things.md). **Para comprobar que tiene una política activa AWS IoT ** 1. Vaya a la [consola de AWS IoT](https://console.aws.amazon.com/iot/). 1. En el panel de navegación izquierdo, seleccione **Valores** y, a continuación, **Políticas**. 1. Elija la política que ha creado. Por ejemplo, **SiteWiseTutorialDevicePolicy**. 1. Confirme que el estado de la política aparezca como Activo. ------ #### [ AWS CLI ] Asegúrese de completar una AWS IoT política. Para obtener instrucciones detalladas, consulta el [paso 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) del tutorial [sobre la ingesta de datos](ingest-data-from-iot-things.md). Utilice el siguiente comando AWS CLI [get-policy](https://docs.aws.amazon.com/cli/latest/reference/iot/get-policy.html) en la *Referencia de AWS CLI comandos* para comprobar que tiene una política activa: AWS IoT ``` aws iot get-policy --policy-name "SiteWiseTutorialDevicePolicy" ``` ------ Esta política permite a sus AWS IoT dispositivos establecer conexiones y comunicarse con dispositivos ocultos mediante mensajes MQTT. Para interactuar con las sombras de los dispositivos, tus AWS IoT cosas publican y reciben mensajes en MQTT sobre temas que comienzan con. `$aws/things/{{thing-name}}/shadow/` Esta política incorpora una variable de política de objetos denominada `${iot:Connection.Thing.ThingName}`. Esta variable sustituye el nombre del objeto conectado en cada tema. La instrucción de `iot:Connect` impone límites en cuanto a qué objetos pueden establecer conexiones, lo que garantiza que la variable de política de objeto solo puede sustituir los nombres que comienzan por `SiteWiseTutorialDevice`. Para obtener más información, consulte [Variables de objetos de políticas](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-variables.html) en la *Guía para desarrolladores de AWS IoT *. **nota** Esta política se aplica a objetos cuyos nombres comienzan por `SiteWiseTutorialDevice`. Para usar un nombre diferente para sus objetos, debe actualizar la política según corresponda. ## Paso 2: Crea y configura cualquier cosa AWS IoT En este paso, registre su dispositivo perimetral como una AWS IoT cosa y genere los certificados y claves necesarios para una comunicación segura con AWS IoT SiteWise Edge. Este proceso sienta las bases para que su dispositivo envíe datos de terceros a través de su puerta de enlace V3 habilitada para MQTT. ------ #### [ Console ] Asegúrese de completar los pasos de creación y configuración de cualquier cosa. AWS IoT Para obtener instrucciones detalladas, consulte el [paso 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) del tutorial [sobre la ingesta de datos](ingest-data-from-iot-things.md). **Para comprobar que tienes algo activo AWS IoT ** 1. Vaya a la [consola de AWS IoT](https://console.aws.amazon.com/iot/). 1. En el panel de navegación izquierdo, selecciona **Todos los dispositivos** y, a continuación, **Cosas**. 1. Elige lo que has creado. Por ejemplo, **SiteWiseTutorialDevice1**. 1. En **Certificados**, confirme que el estado aparece como activo. ------ #### [ AWS CLI ] Asegúrese de completar los pasos de creación y configuración de cualquier AWS IoT cosa. Para obtener instrucciones detalladas, consulte el [paso 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) del tutorial [sobre la ingesta de datos](ingest-data-from-iot-things.md). Use el siguiente AWS CLI comando para comprobar que tiene una AWS IoT política activa: ``` aws iot describe-thing --thing-name "SiteWiseTutorialDevice1" ``` ------ Tras completar estos pasos, podrás conectar tu dispositivo a AWS IoT SiteWise Edge de forma segura. Creó un directorio local para almacenar los certificados y las claves que generó para la autenticación en MQTT. El dispositivo está registrado como un AWS IoT objeto en la [AWS IoT consola](https://console.aws.amazon.com/iot/) y está preparado para integrar los datos con SiteWise Edge. Puede conectar su equipo industrial u otros dispositivos a la AWS IoT plataforma y empezar a ingerir datos en SiteWise Edge. ## Paso 3: Configure su puerta de enlace V3 habilitada para SiteWise Edge MQTT En este paso, cree su puerta de enlace V3 habilitada para AWS IoT SiteWise Edge MQTT y configúrela para recibir datos del intermediario EMQX. La puerta de enlace actúa como un puente entre sus dispositivos y. AWS IoT Esto le permite procesar los datos localmente en el borde antes de enviarlos al Nube de AWS. Esta configuración reduce el ancho de banda y reduce los retrasos en el procesamiento en la nube. ------ #### [ Console ] **Para crear su puerta de enlace V3 AWS IoT SiteWise habilitada para MQTT** 1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/) y abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. **En el panel de navegación izquierdo, selecciona **Gateways Edge** y, a continuación, selecciona Crear puerta de enlace.** 1. En **Objetivo de implementación**, selecciona Puerta de enlace **autohospedada**. 1. *En Opciones de puerta de enlace autohospedada, selecciona Puerta de enlace V3 **habilitada para MQTT (recomendada)**.* 1. **En Configuración de puerta de enlace:** 1. En **Nombre de la puerta** de enlace, introduzca un nombre para la puerta de enlace. Por ejemplo, **SiteWise Tutorial Device Gateway**. 1. En el **sistema operativo del dispositivo Greengrass**, seleccione la opción adecuada para su dispositivo. 1. En **Configuración avanzada**: 1. Seleccione **Configuración predeterminada**. 1. Introduzca un nombre para el dispositivo principal de Greengrass o utilice el nombre generado por. AWS IoT SiteWise 1. Seleccione **Crear puerta de enlace**. 1. En el cuadro de diálogo de confirmación, seleccione **Generar y descargar** para generar un instalador para su puerta de enlace SiteWise Edge. Para obtener más información, consulte [Crear una puerta de enlace SiteWise Edge autohospedada](create-gateway-ggv2.md#configure-gateway-console). **aviso** Guarde el archivo de instalación en un lugar seguro. Este archivo no se puede regenerar y es necesario para completar la configuración de la puerta de enlace en pasos posteriores. ------ #### [ AWS CLI ] Se utiliza AWS CLI para crear una puerta de enlace autohospedada. Debe proporcionar un nombre para la puerta de enlace, especificar la plataforma y la versión de la puerta de enlace. Para obtener más información, consulta [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) en la *AWS IoT SiteWise Referencia de la API de *. Para utilizar este ejemplo, reemplace los marcadores de posición de entrada del usuario con su propia información. ``` aws iotsitewise create-gateway \ --gateway-name SiteWise Tutorial Device Gateway \ --gateway-platform greengrassV2={coreDeviceThingName={{your-core-device-thing-name}}, coreDeviceOperatingSystem={{LINUX_AMD64}}} \ --gateway-version {{3}} \ [--cli-input-json {{your-configuration}}] ``` + `gateway-name`— Un nombre único para la puerta de enlace, por ejemplo,`SiteWise Tutorial Device Gateway`. + `gateway-platform`— Introducir`greengrassV2`. Para obtener más información, consulta [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) en la *AWS IoT SiteWise Referencia de la API de *. + `coreDeviceThingName`— El nombre del AWS IoT dispositivo AWS IoT Greengrass V2 principal. Por ejemplo, `SiteWiseTutorialDevice1`. + `coreDeviceOperatingSystem`— El sistema operativo del dispositivo principal en AWS IoT Greengrass V2. Para la versión 3 de la puerta de enlace es necesario especificar el sistema operativo. Las opciones incluyen:`LINUX_AARCH64`, y`LINUX_AMD64`. `WINDOWS_AMD64` + `gateway-version`— La versión de la puerta de enlace. + `3`Utilícela para la versión de puerta de enlace para crear una puerta de enlace V3 habilitada para MQTT. + `cli-input-json`— Un archivo JSON que contiene los parámetros de la solicitud. Utilice el siguiente AWS CLI comando para comprobar que la puerta de enlace se creó correctamente: ``` aws iotsitewise describe-gateway --gateway-id {{your-gateway-id}} ``` ------ ## Paso 4: Instale el software SiteWise Edge Gateway Para instalar el software de puerta de enlace, utilice el paquete de instalación que descargó en el paso anterior. El proceso de instalación configura los componentes necesarios, inicia el servicio principal de Greengrass y registra el dispositivo en él. AWS IoT Greengrass Una vez completada la instalación, compruebe que la puerta de enlace aparece en la [AWS IoT SiteWise consola](https://console.aws.amazon.com/iotsitewise/), debajo de **las puertas de enlace Edge**, y que el servicio Greengrass se ejecuta correctamente en su dispositivo. Para obtener instrucciones detalladas, consulte [Instale el software AWS IoT SiteWise Edge Gateway en su dispositivo local](install-gateway-software-on-local-device.md). ## Paso 5: Configure el broker EMQX para que se conecte a aplicaciones externas **nota** Debe haber implementado su puerta de enlace V3 habilitada para SiteWise Edge MQTT antes de continuar. La puerta de enlace proporciona la infraestructura y los ajustes de seguridad necesarios para configurar el broker EMQX. La configuración del broker fallará sin un despliegue de puerta de enlace activo. Configure el broker EMQX para permitir una comunicación segura entre sus dispositivos de IoT y aplicaciones externas. El intermediario EMQX funciona como un centro de mensajería central que enruta los datos entre sus dispositivos, puertas de enlace y aplicaciones de IoT. El intermediario EMQX garantiza una entrega fiable de los mensajes en su pasarela y las aplicaciones conectadas en la periferia. Para obtener más información, consulte [Connect aplicaciones externas al broker EMQX](connect-external-applications-emqx.md). **Para configurar el bróker EMQX** 1. Configure el bróker EMQX. Para obtener instrucciones de configuración detalladas, siga los pasos 1 a 14 de la sección [Actualizar la configuración de despliegue de EMQX para la](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication) autenticación. 1. Configure los temas de MQTT para la supervisión de parques eólicos. Para obtener más información sobre los requisitos de MQTT, consulte. [Requisitos del tema MQTT](connect-broker-payload-format.md#connect-broker-mqtt-requirements) 1. Uso de la CPU: `SiteWiseTutorialDevice/cpu` 1. Uso de memoria: `SiteWiseTutorialDevice/memory` 1. Marca de tiempo: `SiteWiseTutorialDevice/timestamp` 1. Revise la configuración y complete la implementación. 1. Elija **Confirmar** para guardar la configuración. 1. Selecciona **Siguiente** hasta llegar al paso de **revisión**. 1. En la página **Revisar**, elija **Implementar**. 1. Espere a que la implementación se complete correctamente antes de continuar. 1. Prepare los mensajes con el formato de carga útil para enviarlos al intermediario EMQX. Para obtener más información sobre la estructuración de las cargas útiles, consulte [Actualizar la configuración de despliegue de EMQX para la](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication) autenticación. 1. Implemente las siguientes medidas de seguridad: 1. Utilice el cifrado Transport Layer Security (TLS) (puerto 8833) para proteger los datos en tránsito. Para obtener más información, consulte [Configure TLS para establecer conexiones seguras con el intermediario EMQX en Edge AWS IoT SiteWise](connect-app-to-broker.md#configure-tls-emqx-broker). 1. Configure la autenticación con nombre de usuario y contraseña para verificar las identidades de los dispositivos. Esta medida de seguridad ayuda a proteger sus datos y garantiza que solo los dispositivos autorizados puedan conectarse a su sistema. Para obtener más información, consulte [Habilite la autenticación de nombre de usuario y contraseña](configure-emqx-broker.md#emqx-broker-username-password-auth). EMQX le permite crear reglas de autorización basadas en identificadores como el nombre de usuario, la dirección IP o el ID de cliente. Esto es útil para controlar el acceso a sus datos. Para obtener más información, consulte [Configure las reglas de autorización para AWS IoT SiteWise Edge en EMQX](authorization-rules-emqx-broker.md). Tras una implementación exitosa, su agente EMQX estará configurado y listo para conectarse de forma segura con aplicaciones externas. **nota** El formato de carga útil debe seguir una estructura específica para que AWS IoT SiteWise Edge procese e ingiera los datos correctamente. Para obtener más información sobre la estructura requerida, consulte. [Estructura de carga útil de JSON](connect-broker-payload-format.md#connect-broker-json-payload) **Ejemplo: añadir cargas útiles JSON de CPU, memoria y marca de tiempo** **Carga útil JSON de CPU** ``` { "propertyAlias": "SiteWiseTutorialDevice/cpu", "propertyValues": [ { "quality": "GOOD", "timestamp": { "offsetInNanos": 0, "timeInSeconds": 1753206441 }, "value": { "integerValue": 45.2 } } ] } ``` **Carga útil JSON de memoria** ``` { "propertyAlias": "SiteWiseTutorialDevice/memory", "propertyValues": [ { "quality": "GOOD", "timestamp": { "offsetInNanos": 0, "timeInSeconds": 1753206441 }, "value": { "integerValue": 67.8 } } ] } ``` **Carga útil JSON con marca de tiempo** ``` { "propertyAlias": "SiteWiseTutorialDevice/timestamp", "propertyValues": [ { "quality": "GOOD", "timestamp": { "offsetInNanos": 0, "timeInSeconds": 1753206441 }, "value": { "integerValue": 23.5 } } ] } ``` **nota** Cada carga útil JSON debe publicarse por separado como un mensaje individual. No combine varios valores de propiedades en un solo mensaje. Envíe cada carga útil de CPU, memoria y marca de tiempo como una publicación MQTT independiente. La carga útil define la estructura JSON requerida que sus dispositivos de IoT deben usar para enviar los datos del dispositivo a Edge a través del intermediario EMQX. SiteWise Este formato garantiza que AWS IoT SiteWise pueda identificar sus dispositivos y procesar las lecturas de los sensores. Una vez implementadas estas configuraciones y estructuras de carga útil, el sistema de monitoreo de su parque eólico estará listo para recopilar y procesar datos. ## Paso 6: Publica los datos con Mosquitto Después de crear su puerta de enlace V3 habilitada para MQTT, configure Eclipse Mosquitto para enviar los datos de prueba a Edge. SiteWise Mosquitto es un intermediario de mensajes MQTT de código abierto que utiliza el protocolo MQTT para facilitar la mensajería entre dispositivos. El cliente Mosquitto permite publicar mensajes sobre temas de MQTT, simulando los datos de los sensores de los parques eólicos. Con Mosquitto, simule los datos del dispositivo sin necesidad de servicios de terceros ni equipos adicionales. Para obtener más información, consulte la [documentación](https://mosquitto.org) en el sitio web oficial de Eclipse Mosquitto. En este tutorial, los datos locales del tutorial de [ingestión de datos](ingest-data-from-iot-things.md) y los datos ficticios se utilizan con fines de demostración. **Utilice el cliente CLI de Mosquitto para probar el broker SiteWise EDGE EMQX** 1. Instale Mosquitto en su dispositivo local. Para obtener instrucciones detalladas, consulta [Descargar Mosquitto en el sitio web](https://mosquitto.org/download/) oficial de Eclipse Mosquitto. 1. Para obtener más información sobre la conexión de aplicaciones externas para transferir datos industriales, consulte. [Connect aplicaciones externas al broker EMQX](connect-external-applications-emqx.md) **importante** Asegúrese de que los ajustes de conexión MQTT que configure aquí coincidan con los utilizados en el comando Mosquitto publish. El host debe ser la dirección IP o el nombre de host de su SiteWise puerta de enlace Edge. El puerto suele ser el 1883 (o el 8883 si se utiliza SSL/TLS). Use Mosquitto para publicar los datos de las pruebas. Abra una línea de comandos y ejecute los siguientes comandos: **Ejemplo: propiedad de la CPU** ``` mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/cpu" -m '{ "propertyAlias": "SiteWiseTutorialDevice/cpu", "propertyValues": [ { "quality": "GOOD", "timestamp": { "timeInSeconds": 1753206441, "offsetInNanos": 0 }, "value": { "integerValue": 45.2 } } ] }' ``` **Ejemplo: propiedad de memoria** ``` mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/memory" -m '{ "propertyAlias": "SiteWiseTutorialDevice/memory", "propertyValues": [ { "quality": "GOOD", "timestamp": { "timeInSeconds": 1753206441, "offsetInNanos": 0 }, "value": { "integerValue": 72.1 } } ] }' ``` **Ejemplo: propiedad Timestamp** ``` mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/timestamp" -m '{ "propertyAlias": "SiteWiseTutorialDevice/timestamp", "propertyValues": [ { "quality": "GOOD", "timestamp": { "timeInSeconds": 1753206441, "offsetInNanos": 0 }, "value": { "integerValue": 1683000000 } } ] }' ``` **nota** El uso de `localhost` como dirección de intermediario de EMQX es únicamente con fines de demostración. En entornos de producción o cuando se conecta desde dispositivos externos, debe utilizar la dirección de intermediario EMQX adecuada para su configuración de despliegue específica. Para obtener instrucciones de conexión detalladas, consulte. [Conecte una aplicación al bróker EMQX en Edge AWS IoT SiteWise](connect-app-to-broker.md) ## Paso 7: Especifique los destinos En este paso, especifique los destinos para determinar hacia dónde dirigir los datos de origen. Úselo AWS IoT SiteWise con el almacenamiento en búfer de Amazon S3 como destino. Esta opción proporciona una forma escalable de almacenar y procesar sus datos de IoT. ------ #### [ Console ] **Para añadir destinos** 1. Navegue hasta la [AWS IoT SiteWise consola](https://console.aws.amazon.com/iotsitewise/) y seleccione **Edge Gateways**. 1. En el **SiteWise tutorial Device Gateway**, selecciona **Añadir destinos**. 1. En **Detalles del destino**, selecciona **AWS IoT SiteWise Almacenado en búfer mediante Amazon S3**. Para obtener más información sobre los tipos de destinos, consulte los destinos de [AWS IoT SiteWise entrada](gw-destinations.md#source-destination). 1. En **Nombre de destino**, introduce un nombre para tu destino, por ejemplo,`SiteWise Tutorial S3 Destination`. 1. En la **configuración de carga de S3**, introduce la ubicación de tu depósito de S3. Por ejemplo, `s3://sitewise-tutorial-mqtt-data-[your-account-id]`. Para obtener más información sobre Amazon S3, consulte [Creación, configuración y uso de buckets de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) en la *Guía del usuario de Amazon Simple Storage Service*. 1. En **Frecuencia de carga de datos**, introduzca un valor entre 1 minuto y 30 días. Por ejemplo, `1 minute`. 1. En **Configuración de almacenamiento de datos**: 1. Deselecciona **Copiar datos al almacenamiento.** Si bien esta configuración se recomienda para entornos de producción, no la necesitará para este tutorial. Al deseleccionar esta opción, la opción **Eliminar datos de S3** se deselecciona automáticamente. 1. Elija **Add destination**. **nota** En este tutorial se utiliza un intervalo de 1 minuto para realizar las pruebas. Después de completar el tutorial, puede ajustar este intervalo para que se adapte a sus necesidades de producción o eliminarlo para evitar cargos adicionales. ------ #### [ AWS CLI ] **Ejemplo: crear un nuevo AWS IoT SiteWise destino almacenado en búfer mediante Amazon S3** Utilice la *referencia [update-gateway-capability-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway-capability-configuration.html)de AWS CLI comandos* para configurar el publicador. Establezca el parámetro `capabilityNamespace` como `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_BUFFERED", "name": "your-s3-destination-name", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder", "publishPolicy": { "publishFrequency": "1m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Para obtener más información sobre los destinos, consulte[Añadir un destino almacenado en AWS IoT SiteWise búfer mediante Amazon S3](destinations-buffered.md). ------ ## Paso 8: Especificar los filtros de ruta En este paso, configure los filtros de ruta para especificar qué temas de MQTT debe monitorizar para los datos de los dispositivos de su parque eólico. Los filtros de ruta siguen la especificación comodín del tema MQTT, que admite dos caracteres especiales: + `+`— Este símbolo representa un comodín de un solo nivel, que coincide con cualquier cadena de un solo nivel. + `#`— Este símbolo representa un comodín de varios niveles, que coincide con cualquier número de niveles de la jerarquía de temas. **nota** Para obtener más información sobre otros filtros de ruta, consulte. [Caracteres especiales en los nombres de los filtros de ruta](gw-destinations.md#path-filters-special-characters) ------ #### [ Console ] **Para configurar los filtros de ruta** En **Filtros de ruta**: 1. Ve a la [AWS IoT SiteWise consola](https://console.aws.amazon.com/iotsitewise/) y selecciona **Edge Gateways**. 1. En el **SiteWise tutorial Device Gateway**, selecciona **Añadir destinos**. 1. Seleccione **Añadir filtros de ruta** para introducir los siguientes filtros de ruta manualmente: + `SiteWiseTutorialDevice/#` + `windfarm/+/turbine/+/performance/#` + `cpu/+/idle-time` + `cpu/+/interruption-count/+` + `+/memory/consumption` + `timestamp/+/measurement` + `device/+/status/+` + `system/+/performance-log` 1. Elija **Add destination**. Para obtener más información sobre las prácticas recomendadas para los filtros de rutas, consulte[Prácticas recomendadas para los filtros de rutas](gw-destinations.md#create-effective-path-filters). ------ #### [ AWS CLI ] Utilice los siguientes AWS CLI comandos para configurar los filtros de ruta: **Ejemplo 1: Datos del dispositivo mediante caracteres comodín** ``` { "destinations": [ { "name": "All Device Data Destination" } ], "filters": [ { "type": "PATH", "config": { "paths": [ "SiteWiseTutorialDevice/#", "windfarm/+/turbine/+/performance/#" ] } } ] } ``` Esta configuración de filtro de ruta utiliza caracteres comodín de varios niveles (\#) para capturar todos los datos SiteWiseTutorialDevice y todos los datos de rendimiento de cualquier turbina del parque eólico. **Ejemplo 2: rendimiento de la CPU y la memoria** ``` { "destinations": [ { "name": "Performance Metrics Destination" } ], "filters": [ { "type": "PATH", "config": { "paths": [ "cpu/+/idle-time", "+/memory/consumption", "cpu/+/interruption-count/+" ] } } ] } ``` Este ejemplo captura varias métricas de la CPU (tiempo de inactividad y recuento de interrupciones) y datos de consumo de memoria en todos los dispositivos. **Ejemplo 3: Diagnóstico de dispositivos** ``` { "destinations": [ { "name": "Device Diagnostics Destination" } ], "filters": [ { "type": "PATH", "config": { "paths": [ "device/+/status/+", "system/+/performance-log" ] } } ] } ``` Esta configuración utiliza el `+` comodín para capturar los datos de diagnóstico de varios dispositivos, específicamente los registros de rendimiento del sistema y las actualizaciones de estado de los dispositivos. Estos tres filtros de ruta coinciden con los temas de MQTT que se utilizan para publicar los datos de las pruebas con Mosquitto. Los filtros garantizan que su puerta de enlace SiteWise Edge capture y procese los mensajes MQTT relevantes. Para obtener más información sobre cómo añadir filtros de ruta, consulte[Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge](destinations-add-path-filters.md). ------ ## Paso 9: Configura tus recursos AWS de IoT En este paso, cree los modelos de activos y los AWS IoT SiteWise activos necesarios para representar sus dispositivos simulados de terceros y permitir la ingesta de datos a través de su puerta de enlace perimetral. Antes de iniciar este paso, debería haber completado los pasos 3 a 8 del tutorial sobre la [ingesta de datos](ingest-data-from-iot-things.md). Estos pasos establecen los componentes fundamentales para integrar sus datos de terceros a través de la puerta de enlace V3 habilitada para MQTT. También debe configurar reglas que definen cómo fluyen los datos de los sensores y ejecuta un script de cliente del dispositivo que simula los datos de un parque eólico industrial. AWS IoT SiteWise **Para validar la configuración de sus recursos de AWS IoT** 1. Utilice el siguiente AWS CLI comando para comprobar que ha creado y configurado correctamente su modelo de dispositivo SiteWise tutorial y su modelo de flota de dispositivos SiteWise tutorial: ``` aws iotsitewise describe-asset-model --asset-model-id {{your-device-model-id}} ``` Utilice el siguiente AWS CLI comando para recuperar el ID de sus modelos de activos: ``` aws iotsitewise list-asset-models ``` 1. Utilice el siguiente AWS CLI comando para comprobar que ha creado y configurado correctamente los activos SiteWise Tutorial Device 1 y SiteWise Tutorial Device Fleet 1: ``` aws iotsitewise describe-asset --asset-id {{your-asset-id}} ``` Utilice el siguiente AWS CLI comando para recuperar el ID de sus activos: ``` aws iotsitewise list-assets ``` ## Paso 10: visualice sus datos Configure la versión de código abierto de Grafana para visualizar los datos de los dispositivos de su parque eólico. Grafana es una plataforma de visualización que muestra sus datos operativos en tiempo real. Estos paneles le ayudan a realizar un seguimiento de la eficiencia operativa e identificar las necesidades de mantenimiento en toda su infraestructura. Para obtener más información sobre la integración, consulte[Integre AWS IoT SiteWise con Grafana](grafana-integration.md). **Para configurar Grafana** 1. Para obtener instrucciones para descargar e instalar la última versión de Grafana, consulte Instalar Grafana en el [sitio web oficial de Grafana](https://grafana.com/docs/grafana/latest/setup-grafana/installation/#install-grafana). 1. Para obtener instrucciones de configuración detalladas específicas para su sistema operativo, consulte [Configurar Grafana en el sitio web oficial](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#configure-grafana) de Grafana. 1. Configure la fuente de AWS IoT SiteWise datos. Esto le permite configurar el AWS IoT SiteWise complemento en su servidor Grafana. Para obtener instrucciones detalladas sobre cómo usar el complemento, consulte [Conectarse a una fuente de AWS IoT SiteWise datos](https://docs.aws.amazon.com/grafana/latest/userguide/using-iotsitewise-in-AMG.html) en la Guía del *usuario de Amazon Managed Grafana*. **importante** Asegúrese de tener la última versión de Grafana para garantizar la compatibilidad con la fuente de AWS IoT SiteWise datos. Después de completar estos pasos, puede crear y personalizar los paneles de Grafana para mostrar las métricas operativas de su parque eólico. Esto le permite realizar un seguimiento y analizar el rendimiento de su parque eólico en el perímetro en tiempo real. **nota** Si bien este tutorial utiliza la versión de código abierto de Grafana AWS , también ofrece Amazon Managed Grafana para entornos de producción. Amazon Managed Grafana es un servicio totalmente gestionado que elimina la necesidad de instalar, configurar y mantener sus propios servidores Grafana. Considere la posibilidad de pasarse a Amazon Managed Grafana cuando esté listo para escalar su solución. Para obtener instrucciones detalladas sobre cómo conectar sus SiteWise datos a Grafana, consulte el tutorial [Visualizar y compartir datos en Grafana](visualize-with-grafana.md). Has completado el tutorial. En este procedimiento, configuró AWS IoT SiteWise Edge para integrar datos de dispositivos de terceros mediante una puerta de enlace V3 habilitada para MQTT. Esta configuración le permite recopilar, procesar y visualizar datos de equipos industriales en la periferia, lo que reduce la latencia y los costes operativos. Al utilizar la demostración del parque eólico, recopiló y procesó métricas operativas, como los datos de uso de la CPU y la memoria, a través de su puerta de enlace V3 compatible con MQTT. Para mejorar su solución de IoT, considere la posibilidad de explorar funciones avanzadas, como la detección de anomalías[Detección de anomalías con Lookout for Equipment](anomaly-detection.md), mediante el aprovechamiento o la integración con otros AWS servicios, como [Amazon Quick, en la Guía rápida](https://docs.aws.amazon.com/quicksight/latest/user/welcome.html) *del usuario de Amazon* para obtener análisis avanzados. ## Paso 11: Limpiar los recursos después del tutorial Después de completar este tutorial sobre la integración de datos en AWS IoT SiteWise Edge, limpie sus recursos para evitar incurrir en cargos adicionales. **Para eliminar activos jerárquicos en AWS IoT SiteWise** 1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. En el panel de navegación izquierdo, elija **Assets (activos)**. 1. Al eliminar activos AWS IoT SiteWise, primero debe desasociarlos. Complete los siguientes pasos para anular la asociación de los activos de su dispositivo de su activo de flota de dispositivos: 1. Elige el activo de tu flota de dispositivos (**SiteWise Tutorial Device Fleet 1**). 1. Elija **Edit (Edición de)**. 1. En **Assets associated to this asset (activos asociados a este activo)**, elija **Disassociate (Anular asociación)** para cada activo de dispositivo asociado a este activo de flota de dispositivo. 1. Seleccione **Save**. **nota** Los activos del dispositivo ya no están organizados en forma jerárquica. 1. Elija el activo de dispositivo (**SiteWise Tutorial Device 1**). 1. Elija **Eliminar**. 1. En el cuadro de diálogo de confirmación, introduzca y**Delete**, a continuación, seleccione **Eliminar**. 1. Repita los pasos 4 a 6 para cada activo de dispositivo y el activo de flota de dispositivos (**SiteWise Tutorial Device Fleet 1**). **Para eliminar modelos de activos jerárquicos en AWS IoT SiteWise** 1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Elimine su dispositivo y los activos de la flota de dispositivos. 1. En el panel de navegación izquierdo, elija **Models (Modelos)**. 1. Elija su modelo de activos de flota de dispositivos (**SiteWise Tutorial Device Fleet Model**). No puede eliminar un modelo si tiene activos creados a partir de ese modelo. Al eliminar modelos de activos jerárquicos, comience eliminando primero el modelo de activos principal. 1. Elija **Eliminar**. 1. En el cuadro de diálogo de confirmación, ingresa y**Delete**, a continuación, selecciona **Eliminar**. 1. Repita los pasos 4 a 6 para el modelo de activos del dispositivo (**SiteWise Tutorial Device Model**). **Para deshabilitar o eliminar una regla en AWS IoT Core** 1. Vaya a la [consola de AWS IoT](https://console.aws.amazon.com/iot/). 1. En el panel de navegación izquierdo, selecciona **Enrutamiento de mensajes** y, a continuación, **Reglas**. 1. Seleccione su regla y seleccione **Eliminar**. 1. En el cuadro de diálogo de confirmación, ingrese el nombre de la regla y, a continuación, elija **Eliminar**. **Para eliminar un bucket de Amazon S3** 1. Vaya a la [consola de Amazon IVS](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, selecciona un **depósito de uso general**. 1. En la lista de cubos, selecciona el botón de opción situado junto al depósito que has creado y, a continuación, selecciona **Vacío** en la parte superior de la página. 1. En el cuadro de diálogo de confirmación, confirme la eliminación y, a continuación, seleccione **Vacío.** 1. Cuando el depósito esté vacío, selecciona **Eliminar** para eliminarlo. 1. En el cuadro de diálogo de confirmación, introduce el nombre del depósito para confirmar la eliminación. 1. Elija **Delete bucket (Eliminar bucket)**. **Para eliminar una puerta de enlace SiteWise Edge** 1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. En el panel de navegación izquierdo, elija **puertas de enlace Edge**. 1. En Puertas de enlace, elija la puerta de enlace que creó para este tutorial. Por ejemplo, `SiteWise Tutorial Device Gateway`. 1. Elija **Eliminar**. 1. Para confirmar que desea eliminar la puerta de enlace, escriba **Delete** en el cuadro de diálogo de confirmación y, a continuación, seleccione **Eliminar** en la ventana que aparece. **Para eliminar tu cosa de IoT** 1. Vaya a la [consola de AWS IoT](https://console.aws.amazon.com/iot/). 1. En el panel de navegación izquierdo, selecciona **Administrar** y, a continuación, selecciona **Cosas**. 1. Selecciona el elemento de IoT que creaste para este tutorial. Por ejemplo, `SiteWiseTutorialDevice1`. 1. Elija **Eliminar**. 1. En el cuadro de diálogo de confirmación, introduce el nombre de la cosa y, a continuación, selecciona **Eliminar**. **Para desinstalar AWS IoT Greengrass Core** Desinstale el software AWS IoT Greengrass Core de su dispositivo local. Para obtener instrucciones detalladas, consulte [Desinstalar el software AWS IoT Greengrass principal](https://docs.aws.amazon.com/greengrass/v2/developerguide/uninstall-greengrass-core-v2.html) en la *Guía para AWS IoT Greengrass desarrolladores, versión 2*. **importante** Al desinstalar Greengrass, se eliminan todas las configuraciones y datos locales. Asegúrese de haber hecho una copia de seguridad de toda la información importante antes de continuar. **(Opcional) Para eliminar recursos de terceros** Tras completar este tutorial, considere la posibilidad de cerrar todos los recursos externos que haya creado. Esto ayuda a evitar incurrir en cargos por parte de proveedores externos. ## Recursos adicionales Consulte los siguientes recursos para obtener más información: + [Interactúa con otros AWS servicios](interact-with-other-services.md) + [Utilice puertas de enlace AWS IoT SiteWise Edge](gateways.md) + [Solución de problemas de una puerta de enlace SiteWise Edge](troubleshooting-gateway.md) + [Mejores prácticas de seguridad para AWS IoT SiteWise](security-best-practices.md) + [AWS Precios de IoT](https://aws.amazon.com/iot-sitewise/pricing/) + [Ingiera datos para AWS IoT SiteWise](industrial-data-ingestion.md) + [Utilice etiquetas en AWS IoT SiteWise](tag-basics.md)