SiteWise Procesador IoT - AWS IoT Greengrass
VersionesTipoSistema operativoRequisitosDependenciasConfiguraciónArchivo de registro localLicenciasRegistros de cambiosVéase también

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.

SiteWise Procesador IoT

El componente de SiteWise procesador de IoT (aws.iot.SiteWiseEdgeProcessor) permite que AWS IoT SiteWise las pasarelas procesen los datos en la periferia.

Con este componente, AWS IoT SiteWise las pasarelas pueden utilizar modelos de activos y activos para procesar datos en los dispositivos de pasarela. Para obtener más información sobre AWS IoT SiteWise las puertas de enlace, consulte Uso AWS IoT SiteWise en el borde en la Guía del AWS IoT SiteWise usuario.

Versiones

Este componente tiene las siguientes versiones:

  • 3.5.x

  • 3.4.x

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Este componente es un componente genérico (aws.greengrass.generic). El núcleo de Greengrass ejecuta los scripts del ciclo de vida del componente.

Para obtener más información, consulte Tipos de componentes.

Sistema operativo

Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:

  • Linux

  • Windows

Requisitos

Este componente tiene los siguientes requisitos:

  • El dispositivo principal de Greengrass debe ejecutarse en una de las siguientes plataformas:

    • sistema operativo: Ubuntu 20.04 o 18.04

      arquitectura: x86_64 () AMD64

    • sistema operativo: Red Hat Enterprise Linux (RHEL) 8

      arquitectura: x86_64 () AMD64

    • sistema operativo: Amazon Linux 2

      arquitectura: x86_64 () AMD64

    • sistema operativo: Windows Server 2019 o posterior

      arquitectura: x86_64 () AMD64

  • El dispositivo principal de Greengrass debe permitir tráfico entrante en el puerto 443.

  • El dispositivo principal de Greengrass debe permitir tráfico saliente en los puertos 443 y 8883.

  • Los siguientes puertos están reservados para su uso por AWS IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080 y 50010. El uso de un puerto reservado para el tráfico puede causar la terminación de la conexión.

    nota

    El puerto 8087 solo es necesario para la versión 2.0.15 y versiones posteriores de este componente.

  • El rol de dispositivo de Greengrass debe tener permisos que le permitan usar AWS IoT SiteWise puertas de enlace en sus dispositivos. AWS IoT Greengrass V2 Para obtener más información, consulte Requisitos en la Guía del usuario de AWS IoT SiteWise .

Puntos de conexión y puertos

Este componente debe poder realizar solicitudes salientes a los siguientes puntos de conexión y puertos, además de a los puntos de conexión y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte Cómo permitir el tráfico del dispositivo a través de un proxy o firewall.

punto de enlace Puerto Obligatorio Descripción

model.iotsitewise.region.amazonaws.com

 443 Sí

Obtenga información sobre sus AWS IoT SiteWise activos y modelos de activos.

edge.iotsitewise.region.amazonaws.com

 443 Sí

Obtenga información sobre la configuración de la AWS IoT SiteWise puerta de enlace del dispositivo principal.

ecr.region.amazonaws.com

 443 Sí

Descargue las imágenes de Docker de AWS IoT SiteWise Edge Gateway desde Amazon Elastic Container Registry.

iot.region.amazonaws.com

 443 Sí

Obtenga puntos de conexión de dispositivos para su Cuenta de AWS.

sts.region.amazonaws.com

 443 Sí

Obtenga el ID de su. Cuenta de AWS

monitor.iotsitewise.region.amazonaws.com

 443 No

Obligatorio si accedes a los AWS IoT SiteWise Monitor portales desde el dispositivo principal.

Dependencias

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las versiones publicadas de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la consola de AWS IoT Greengrass. En la página de detalles del componente, busque la lista de Dependencias.

En la siguiente tabla, se muestran las dependencias de las versiones 2.0.x a 2.1.x de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Servicio de intercambio de token >=2.0.3 <3.0.0 Rígido
Administrador de flujos >=2.0.10 <3.0.0 Rígido
CLI de Greengrass >=2.3.0 <3.0.0 Rígido

Para obtener más información sobre las dependencias del componente, consulte la referencia de receta de componentes.

Configuración

Este componente no tiene ningún parámetro de configuración.

Archivo de registro local

Este componente usa el siguiente archivo de registro.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
Visualización de los registros de este componente

  • Ejecute el siguiente comando en el dispositivo principal para ver el archivo de registro de este componente en tiempo real. Sustituya /greengrass/v2 o C:\greengrass\v2 por la ruta a la carpeta AWS IoT Greengrass raíz.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

Licencias

Este componente incluye las siguientes licencias o software de terceros:

  • Apache 2.0

  • MIT

  • Cláusula BSD-2

  • Cláusula BSD-3

  • CDDL-1.0

  • CDDL-1.1

  • ISC

  • Zlib

  • GPL-3.0 con excepción de la GCC

  • Dominio público

  • Python 2.0

  • Unicode-DFS-2015

  • Cláusula BSD-1

  • OpenSSL

  • EPL-1.0

  • EPL-2.0

  • GPL-2.0- with-classpath-exception

  • MPL-2.0

  • CC0-1.0

  • JSON

Este conector se publica en el Contrato de Licencia de Software de Greengrass Core.

Registros de cambios

En la siguiente tabla, se describen los cambios en cada versión del componente.

Versión

Cambios

3.5.1
Nuevas características

Se agregó soporte para la ingesta de valores Null y NaN si la ingestión está habilitada en. AWS IoT SiteWise Para ver o modificar la configuración de Null y NaN en AWS IoT SiteWise, consulte DescribeStorageConfigurationy PutStorageConfiguration APIs.

Mejoras y correcciones de errores

Se actualizaron las dependencias para abordar posibles vulnerabilidades de seguridad.

3.4.0
Nuevas características
Mejoras en el rendimiento

Se ha reducido el tiempo que tardan los datos entrantes en llegar al almacenamiento del dispositivo perimetral de 5 segundos a menos de 1 segundo. La latencia para la carga de datos AWS IoT SiteWise permanece inalterada.

3.3.1
Nueva característica

  • Se agregó la compatibilidad opcional con CORS a SiteWise Edge APIs, lo que mejora las capacidades de intercambio de recursos entre orígenes. Esta función mejora la flexibilidad de las aplicaciones web que interactúan con. APIs

3.3.0
Mejoras en el rendimiento

  • Mecanismo de actualización de la caché optimizado para reducir el uso de E/S entre las sincronizaciones de activos de AWS IoT SiteWise , ya que solo actualiza las entradas de los activos nuevos o actualizados.

  • Menor consumo de memoria para mantener una caché con un gran número de propiedades de activos sincronizados.

Mejoras y correcciones de errores

  • Se han suprimido los registros para incorporar valores de propiedades individuales cuando no hay errores de ingesta, lo que reduce el ruido de los registros cuando hay altas tasas de ingesta.

  • Se mejoró la legibilidad de los registros mediante el uso de un formato legible para las personas en determinadas entradas de registro.

  • Se agregó compatibilidad con Java 17 y versiones posteriores.

3.2.1
Mejoras y correcciones de errores

  • Se solucionó el problema por el que las llamadas a la AWS IoT SiteWise API no se paginaban de forma sincrónica con Edge. SiteWise

  • Se solucionó el problema por el que ya no se publicaba la métrica MessageRemaining.SiteWise_Edge_Stream.

  • Se agregaron las siguientes CloudWatch métricas para monitorear la conexión con el broker MQTT.

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    Para obtener más información sobre estas métricas, consulte puertas de enlace de AWS IoT Greengrass Version 2.

3.2.0
Mejoras en el rendimiento

  • Optimice los servicios de API para que ocupen menos memoria y requieran menos espacio en disco para su instalación

    • Esto proporciona una reducción de 2 GB en el uso de memoria inicial (ahora utiliza 7,5 GB de memoria al arranque, aunque se recomiendan 16 GB) y una reducción de 500 MB en el tamaño de la descarga (ahora requiere una descarga de 1,4 GB) para todo el componente.

Nuevas características

  • La API GetAssetPropertyValueAggregates ahora admite ventanas de agregación de 15 minutos en la periferia.

  • Los puertos 8081 y 8082 ya no necesitan estar disponibles para que este componente se ejecute correctamente.

    nota

    El punto final local del plano de AWS IoT SiteWise datos APIs, por ejemploget-asset-property-value, se está cambiando de http://localhost:8081 ahttp://localhost:11080/data. El punto final local del plano de AWS IoT SiteWise control APIs, por ejemplolist-asset-models, se cambia de http://localhost:11080 ahttp://localhost:11080/control. AWS siempre recomienda utilizar los puntos de enlace HTTPS de la puerta de enlace SiteWise Edge. Esos puntos de conexión no han cambiado.

Mejoras y correcciones de errores

  • La sincronización desde ahora AWS IoT SiteWise hará que los recursos pasen a un estado válido si se interrumpió la sincronización anterior. Esto solucionará los problemas relacionados con la corrupción de algunos recursos tras un reinicio forzado.

  • Corrige un problema poco frecuente en el que un recurso puede dañarse en la periferia si se modifica durante la sincronización. La sincronización ahora fallará si se detecta esta condición y el recurso se volverá a intentar en la siguiente sincronización.

  • Corrige un problema que podría haber permitido llamar externamente APIs al punto final HTTP. Ahora solo se puede usar HTTPS para llamar APIs fuera de la dirección de bucle invertido local.

  • La API ListAssets ahora muestra las jerarquías de activos de los activos almacenados en la periferia.

  • Soluciona un problema que provocaba que el paquete de procesamiento de datos no se pudiera reiniciar, actualizar o revertir en Windows.

  • Corrige un error en el paquete de procesamiento de datos para el sistema operativo Windows que impedía a los clientes utilizar las credenciales para conectarse con un agente de MQTT.

3.1.3
Mejoras y correcciones de errores

  • Se solucionó el problema por el que el paquete de procesamiento de datos informaba incorrectamente de una sincronización exitosa cuando algunos de los recursos fallaban.

  • Permita que varios activos tengan el mismo nombre siempre que no tengan el mismo elemento principal.

3.1.1
Mejoras y correcciones de errores

  • Se ha solucionado el problema por el que la solicitud de SiGv4 fallaba debido a una discordancia entre zonas horarias.

  • Se solucionó el problema por el que las propiedades de transformación y métrica dejaban de calcularse cuando se basaban en atributos después de reiniciarse.

  • Habilite la compatibilidad con la configuración de puertos personalizada del administrador de flujos.

  • Soluciona un problema por el que las propiedades que están sincronizadas con la periferia podrían dejar de actualizarse.

3.1.0
Mejoras y correcciones de errores

  • Se ha solucionado el problema por el que la API ListAssetModels no podía generar el siguiente token.

3.0.0
Nuevas características

  • Permite la ingesta de datos desde un agente de MQTT.

2.2.1
Mejoras y correcciones de errores

  • Ajuste el proceso de sincronización para que el almacenamiento de datos en el plano de control sea más coherente con el funcionamiento de la nube. Esto afecta levemente a la actualización.

    nota

    Los datos del plano de control sincronizados en la versión 2.2.1 o posterior no serán compatibles con las versiones anteriores. Para cambiar a versiones anteriores, debe realizar una instalación nueva. Esto no afecta a las actualizaciones. Los datos sincronizados en las versiones anteriores funcionarán con la versión 2.2.1.

  • Modificaciones adicionales en la cadena de AWS credenciales para AWS IoT Greengrass V2 priorizar las credenciales.

2.1.37
Mejoras y correcciones de errores

  • Elimine el dependency-routing-service proceso e incorpore su funcionalidad al property-state-service proceso para reducir el uso de recursos de los procesos que se comunican.

  • Aumente el límite máximo de resultados de la get-asset-property-value-history API a 20 000 para que coincida con el límite utilizado por AWS IoT SiteWise.

  • Se solucionó un problema por el que el siguiente token no aparecía en los resultados paginados de la API get-asset-property-value-history cuando no se especificaba un límite máximo de resultados.

2.1.35
Mejoras y correcciones de errores

  • Modifica la cadena de AWS credenciales para priorizar las credenciales. AWS IoT Greengrass

  • Soluciona un problema relacionado con la detección de cuentas al implementarlas como parte de un grupo de objetos AWS IoT .

2.1.34
Mejoras y correcciones de errores

  • Ajusta los cálculos métricos o de transformación para utilizar subprocesos múltiples en Linux. Windows sigue ejecutando cálculos de un solo subproceso para garantizar la compatibilidad.

  • Corrige un problema por el que faltaban cálculos métricos en algunas ventanas de cálculo.

2.1.33
Mejoras y correcciones de errores

  • Corrige un problema con los informes de estado de error a la consola de Greengrass.

2.1.32
Mejoras y correcciones de errores

  • Suma compatibilidad con nombres de usuario y grupos personalizados.

2.1.31
Mejoras y correcciones de errores

  • Suma compatibilidad para calcular el promedio ponderado en el tiempo y la desviación estándar ponderada en el tiempo para los datos modelados en AWS IoT SiteWise.

2.1.29
Mejoras y correcciones de errores

  • Agrega la funcionalidad de filtrado de activos en la periferia.

2.1.28
Mejoras y correcciones de errores

  • Optimiza la sincronización de recursos para permitir que una gran cantidad de activos se Nube de AWS sincronicen de forma remota.

2.1.24
Mejoras y correcciones de errores

  • Soluciona un problema que provocaba que el panel desapareciera al sincronizar un recurso por segunda vez.

2.1.23
Mejoras y correcciones de errores

  • Se agregó un tiempo de espera para el proceso de instalación aws.iot.SiteWiseEdgeProcessor a fin de evitar errores en la instalación si la conectividad a Internet es lenta.

  • Sincronización de recursos optimizada para mejorar la eficiencia de la sincronización entre la nube y la periferia.

2.1.21
aviso

La actualización de la versión 2.0.x a la versión 2.1.x provocará la pérdida de datos locales.

Nuevas características

  • Agrega compatibilidad con Windows Server 2019 o posterior.

  • Elimina el docker para los sistemas operativos basados en Linux.

2.0.16

Esta versión contiene correcciones de errores y mejoras.

2.0.15
Mejoras y correcciones de errores

  • Cambia el puerto que utiliza este componente para las operaciones de la API de sincronización de recursos del 8085 al 8087. Como resultado, este componente ahora requiere que el puerto 8087 esté disponible. Este componente aún requiere que el puerto 8085 esté disponible.

  • Actualiza la AWS OpsHub autenticación para denegar a los usuarios no autorizados durante el inicio de sesión, en lugar de cuando un usuario intenta llamar a las operaciones de la API.

2.0.14

Esta versión contiene correcciones de errores y mejoras.

2.0.13
Mejoras y correcciones de errores

  • Soluciona un problema por el que, cuando este componente reporta datos a CloudWatch las métricas de Amazon, ahora indica correctamente qué datos no están modelados.

2.0.9
Mejoras y correcciones de errores

  • Mejora la fiabilidad a la hora de crear y actualizar AWS IoT SiteWise recursos en el dispositivo principal.

  • Agrega operaciones de API locales adicionales que puede usar para monitorear qué componentes están instalados en el dispositivo principal, la versión de cada componente y el estado de cada componente. Puede ver esta información en la pestaña Configuración de la AWS IoT SiteWise aplicación AWS OpsHub correspondiente al dispositivo principal.

  • Agrega un estado a los contenedores de Docker en los que se ejecuta este componente. Puede ejecutar el comando docker ps para ver el estado de los contenedores.

2.0.7
Mejoras y correcciones de errores

  • Corrige la compatibilidad con la visualización de AWS IoT SiteWise Monitor portales en el dispositivo principal.

2.0.6
Mejoras y correcciones de errores

  • Corrige las latest() funciones AWS IoT SiteWise statetime()earliest(), y que este componente calcula en el dispositivo principal.

2.0.5
Mejoras y correcciones de errores

  • Añade compatibilidad con la AWS IoT SiteWise pretrigger() función en las transformaciones que este componente calcula en el dispositivo principal.

  • Cambia la ruta en la que este componente almacena la configuración del Protocolo ligero de acceso a directorios (LDAP) para la autenticación.

2.0.2

Versión inicial.

Véase también