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.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)

    • OS: Red Hat Enterprise Linux (RHEL) 8

      Arquitectura: x86_64 (AMD64)

    • OS: 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 el tráfico entrante en el puerto 443.

  • El dispositivo principal de Greengrass debe permitir el 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 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 los requisitos en la Guía del AWS IoT SiteWise usuario.

Puntos finales y puertos

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

punto de enlace Puerto Obligatoria 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 la identificación 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 implementarlo 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.AWS IoT Greengrass En la página de detalles del componente, busque la lista de dependencias.

La siguiente tabla muestra 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 fichas >=2.0.3 <3.0.0 Rígido
Administrador de transmisiones >=2.0.3 =2.0.10 <3.0.0 Rígido
Greengrass CLI >=2.3.0 <3.0.0 Rígido

Para obtener más información sobre las dependencias de los componentes, consulta la referencia de recetas de componentes.

Configuración

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

Archivo de registro local

Este componente utiliza el siguiente archivo de registro.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
Para ver 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 el siguiente software o licencias de terceros:

  • Apache-2.0

  • MIT

  • Cláusula BSD-2

  • Cláusula BSD-3

  • CDDL-1.0

  • CDDL-1.1

  • DISC

  • 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 con excepción de ruta de clase

  • MPL-2.0

  • CC0-1.0

  • JSON

Este componente se publica en virtud del contrato de licencia de software principal de Greengrass.

Registros de cambios

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

Versión

Cambios

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étricaMessageRemaining.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 las métricas de la AWS IoT Greengrass Version 2 puerta de enlace.

3.2.0
Mejoras de 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 inicio, 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

  • GetAssetPropertyValueAggregatesLa API ahora admite ventanas de agregación periféricas de 15 minutos.

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

    nota

    El punto final local para las API del plano de AWS IoT SiteWise datos, por ejemploget-asset-property-value, se está cambiando de ahttp://localhost:8081. http://localhost:11080/data El punto final local para las API del plano de AWS IoT SiteWise control, por ejemplolist-asset-models, se está cambiando 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 finales 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 el extremo 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.

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

  • ListAssetsLa API 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 degradar 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 correcta 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 solucionó el problema por el que la solicitud de SiGv4 fallaba debido a una falta de coincidencia de zona horaria.

  • 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 de Stream Manager.

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

3.1.0
Mejoras y correcciones de errores

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

3.0.0
Nuevas características

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

2.2.1
Mejoras y correcciones de errores

  • Ajuste el proceso de sincronización para que el almacenamiento de datos del 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 superior no serán compatibles con las versiones anteriores. Para cambiar a versiones anteriores, tendrás que realizar una instalación nueva. Esto no afecta a las actualizaciones, ya que 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 get-asset-property-value-history API 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 AWS IoT Greengrass las credenciales.

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

2.1.34
Mejoras y correcciones de errores

  • Ajusta los cálculos métricos/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

  • Añade compatibilidad con nombres de usuario y grupos personalizados.

2.1.31
Mejoras y correcciones de errores

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

2.1.29
Mejoras y correcciones de errores

  • Añade compatibilidad con 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 sincronicen desde el punto de Nube de AWS vista periférico.

2.1.24
Mejoras y correcciones de errores

  • Corrige un problema que provocaba que el panel de control 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 aws.iot.SiteWiseEdgeProcessor instalación 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 2.1.x provocará la pérdida de datos locales.

Nuevas características

  • Añade compatibilidad con Windows Server 2019 o superior.

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

  • Añade un estado de salud a los contenedores de Docker en los que se ejecuta este componente. Puede ejecutar el docker ps comando para ver el estado de salud 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
Correcciones de errores y mejoras

  • 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