

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
<a name="iotsitewise-processor-component"></a>

El componente de SiteWise procesador de IoT (`aws.iot.SiteWiseEdgeProcessor`) permite a las pasarelas AWS IoT SiteWise Classic Streams y V2 procesar los datos en el borde.

Con este componente, AWS IoT SiteWise las pasarelas pueden usar modelos de activos y activos para procesar datos en los dispositivos de puerta de enlace. Para obtener más información sobre AWS IoT SiteWise las puertas de enlace, consulte [ Uso AWS IoT SiteWise en el borde de la ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) Guía del *AWS IoT SiteWise usuario. *

**nota**  
La característica del paquete de procesamiento de datos (DPP) dejará de estar abierta a nuevos clientes a partir del 7 de noviembre de 2025. Si desea utilizar el DPP, regístrese antes de esa fecha. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Data processing pack availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html) en la *Guía del usuario de AWS IoT SiteWise *.

**Topics**
+ [Versiones](#iotsitewise-processor-component-versions)
+ [Tipo](#iotsitewise-processor-component-type)
+ [Sistema operativo](#iotsitewise-processor-component-os-support)
+ [Requisitos](#iotsitewise-processor-component-requirements)
+ [Dependencias](#iotsitewise-processor-component-dependencies)
+ [Configuración](#iotsitewise-processor-component-configuration)
+ [Archivo de registro local](#iotsitewise-processor-component-log-file)
+ [Licencias](#iotsitewise-processor-component-licenses)
+ [Registros de cambios](#iotsitewise-processor-component-changelog)
+ [Véase también](#iotsitewise-processor-component-see-also)

## Versiones
<a name="iotsitewise-processor-component-versions"></a>

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
<a name="iotsitewise-processor-component-type"></a>

<a name="public-component-type-generic"></a>Este <a name="public-component-type-generic-phrase"></a>componente es un componente genérico (`aws.greengrass.generic`). El [núcleo de Greengrass](greengrass-nucleus-component.md) ejecuta los scripts del ciclo de vida del componente.

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="iotsitewise-processor-component-os-support"></a>

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

## Requisitos
<a name="iotsitewise-processor-component-requirements"></a>

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 posterior

    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)
  + sistema operativo: Debian 11 (Bullseye) 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 puertas de enlace en sus ](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html) dispositivos. AWS IoT SiteWise AWS IoT Greengrass V2 Para obtener más información, consulte [Requisitos](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements) en la *Guía del usuario de AWS IoT SiteWise *.

### Puntos de conexión y puertos
<a name="iotsitewise-processor-component-endpoints"></a>

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](allow-device-traffic.md).


| punto de enlace | Puerto | Obligatorio | Description (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 en el dispositivo principal. | 

## Dependencias
<a name="iotsitewise-processor-component-dependencies"></a>

Al implementar un componente, AWS IoT Greengrass también implementa 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](#iotsitewise-processor-component-changelog) 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](https://console.aws.amazon.com/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](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | Rígido | 
| [Administrador de flujos](stream-manager-component.md) | >=2.0.10 <3.0.0 | Rígido | 
| [CLI de Greengrass](greengrass-cli-component.md) | >=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](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuración
<a name="iotsitewise-processor-component-configuration"></a>

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

## Archivo de registro local
<a name="iotsitewise-processor-component-log-file"></a>

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 de núcleo 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
<a name="iotsitewise-processor-component-licenses"></a>

Este componente incluye los siguientes componentes de terceros software/licensing:

### Third-party Licencias
<a name="w2ab1c24b8d120c25b5b1b1"></a>
+ Apache-2.0
+ MIT
+ BSD-2-Clause
+ BSD-3-Clause
+ CDDL-1.0
+ CDDL-1.1
+ ISC
+ Zlib
+ GPL-3.0-with-GCC-exception
+ Dominio público
+ Python-2.0
+ Unicode-DFS-2015
+ BSD-1-Clause
+ OpenSSL
+ EPL-1.0
+ EPL-2.0
+ GPL-2.0-with-classpath-exception
+ MPL-2.0
+ CC0-1.0
+ JSON

<a name="component-core-software-license"></a>Este conector se publica en el [Contrato de Licencia de Software de Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Registros de cambios
<a name="iotsitewise-processor-component-changelog"></a>

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


|  **Versión**  |  **Cambios**  | 
| --- | --- | 
| 3.5.1 | **Nuevas características**<br /> Se agregó soporte para la ingesta de valores Null y NaN si está habilitada en AWS IoT SiteWise. Para ver o modificar la configuración nula y NaN en AWS IoT SiteWise, consulte las [ PutStorageConfiguration ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutStorageConfiguration.html) API [ DescribeStorageConfiguration ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeStorageConfiguration.html) y. <br />**Mejoras y correcciones de errores**<br /> Se actualizaron las dependencias para abordar posibles vulnerabilidades de seguridad.   | 
| 3.4.0 | **Nuevas características**<br />   Se agregó la compatibilidad opcional con proxy HTTP y HTTPS para permitir la comunicación mediante puertas de enlace con servidores proxy que requieren certificados personalizados. Para obtener más información sobre la configuración de un proxy HTTP para el AWS IoT Greengrass núcleo, consulte[Realizar la conexión en el puerto 443 o a través de un proxy de red](configure-greengrass-core-v2.md#configure-alpn-network-proxy). Para obtener más información sobre la compatibilidad con proxy específica para SiteWise Edge, consulte [ Administrar almacenes de confianza para la compatibilidad con proxy AWS IoT SiteWise Edge ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/edge-apis-manage-trust-stores-proxy.html) en la Guía del *AWS IoT SiteWise usuario*.   Se agregaron ajustes configurables de tiempo de espera de sesión para administrar los períodos de inactividad de las API de Edge AWS OpsHub . SiteWise Para obtener más información, consulta Cómo [ configurar los tiempos de espera de sesión para AWS IoT SiteWise Edge ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/edge-apis-session-timeout.html) en la Guía del usuario. *AWS IoT SiteWise *   <br />**Mejoras en el rendimiento**<br /> Se redujo el tiempo que tardan los datos entrantes en llegar al almacenamiento del dispositivo de periferia de 5 segundos a menos de 1 segundo. La latencia de carga de datos AWS IoT SiteWise permanece inalterada.   | 
| 3.3.1 | **Nueva característica**<br />   Se agregó la compatibilidad opcional con CORS a las API de SiteWise Edge, lo que mejora las capacidades de intercambio de recursos entre orígenes. Esta característica mejora la flexibilidad de las aplicaciones web que interactúan con las API.     | 
| 3.3.0 | **Mejoras en el rendimiento**<br />   Mecanismo de actualización de la caché optimizado para reducir el I/O uso entre las sincronizaciones de AWS IoT SiteWise activos al actualizar únicamente 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**<br />   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**<br />   Soluciona el problema por el que las llamadas a la AWS IoT SiteWise API no se paginan 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 han añadido las siguientes CloudWatch métricas para supervisar la conexión con el bróker MQTT.   `IoTSiteWiseProcessor.IsConnectedToMqttBroker`   `IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker`   `IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived`   `IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount`   `IoTSiteWiseProcessor.MqttReceivedSuccessBytes`   <br />Para obtener más información sobre estas métricas, consulte [puertas de enlace de AWS IoT Greengrass Version 2](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateway-metrics-ggv2.html).     | 
| 3.2.0 |  **Mejoras en el rendimiento**<br />   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.     <br />**Nuevas características**<br />   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.  El punto final local para las API del plano de AWS IoT SiteWise datos, por ejemplo`get-asset-property-value`, se está cambiando de `http://localhost:8081` a`http://localhost:11080/data`. El punto final local para las API del plano de AWS IoT SiteWise control, por ejemplo`list-asset-models`, se está cambiando de `http://localhost:11080` a`http://localhost:11080/control`. AWS siempre recomienda utilizar los puntos de enlace HTTPS de SiteWise Edge Gateway. Esos puntos de conexión no han cambiado.    <br />**Mejoras y correcciones de errores**<br />   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 al punto de conexión HTTP de las API. Ahora solo se puede usar HTTPS para llamar a las API 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**<br />   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**<br />   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**<br />   Se ha solucionado el problema por el que la API `ListAssetModels` no podía generar el siguiente token.     | 
| 3.0.0 |  **Nuevas características**<br />   Permite la ingesta de datos desde un agente de MQTT.     | 
| 2.2.1 |  **Mejoras y correcciones de errores**<br />   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.  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 priorizar AWS IoT Greengrass V2 las credenciales.     | 
| 2.1.37 |  **Mejoras y correcciones de errores**<br />   Elimine el proceso del servicio de enrutamiento de dependencias y traslade su funcionalidad al proceso propiedad-estado-servicio 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**<br />   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**<br />   Ajusta los metric/transform cálculos para usar 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**<br />   Corrige un problema con los informes de estado de error a la consola de Greengrass.     | 
| 2.1,32 |  **Mejoras y correcciones de errores**<br />   Suma compatibilidad con nombres de usuario y grupos personalizados.     | 
| 2.1,31 |  **Mejoras y correcciones de errores**<br />   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**<br />   Agrega la funcionalidad de filtrado de activos en la periferia.     | 
| 2.1,28 |  **Mejoras y correcciones de errores**<br />   Optimiza la sincronización de recursos para permitir que una gran cantidad de activos se sincronicen desde el borde Nube de AWS hasta el borde.     | 
| 2.1.24 |  **Mejoras y correcciones de errores**<br />   Soluciona un problema que provocaba que el panel desapareciera al sincronizar un recurso por segunda vez.     | 
| 2.1.,23 |  **Mejoras y correcciones de errores**<br />   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 |   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**<br />   Agrega compatibilidad con Windows Server 2019 o posterior.   Elimina Docker para Linux-based los sistemas operativos.     | 
| 2.0.16 | Esta versión contiene correcciones de errores y mejoras. | 
| 2,0,15 |  **Mejoras y correcciones de errores**<br />   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 la autenticación 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**<br />   Corrige un problema para que, cuando este componente reporta datos a CloudWatch las métricas de Amazon, ahora indique correctamente qué datos no están modelados.     | 
| 2.0.9 |  **Mejoras y correcciones de errores**<br />   Mejora la confiabilidad para 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 for del 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**<br />   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**<br />   Corrige AWS IoT SiteWise `statetime()` las `earliest()` `latest()` funciones y las funciones que este componente calcula en el dispositivo principal.     | 
| 2.0.5 |  **Mejoras y correcciones de errores**<br />   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
<a name="iotsitewise-processor-component-see-also"></a>
+ [¿Qué es? AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)en la Guía *AWS IoT SiteWise del usuario*.