SiteWise Conector IoT - AWS IoT Greengrass

AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no se publicarán actualizaciones que proporcionen funciones, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes funciones nuevas y es compatible con plataformas adicionales.

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 Conector IoT

El SiteWise conector IoT envía datos de dispositivos y equipos locales a las propiedades de los activosAWS IoT SiteWise. Puede utilizar este conector para recopilar datos de varios servidores OPC-UA y publicarlos en el IoT. SiteWise El conector envía los datos a las propiedades de recurso de la Cuenta de AWS y la región actuales.

nota

SiteWise El IoT es un servicio totalmente gestionado que recopila, procesa y visualiza datos de dispositivos y equipos industriales. Puede configurar las propiedades de recurso que procesan los datos sin procesar enviados desde este conector a las propiedades de medición de sus recursos. Por ejemplo, puede definir una propiedad de transformación que convierta los puntos de datos en temperatura Celsius de un dispositivo a Fahrenheit, o puede definir una propiedad métrica que calcule la temperatura media por hora. Para obtener más información, consulte ¿Qué es AWS IoT SiteWise? en la Guía del usuario de AWS IoT SiteWise.

El conector envía datos al IoT SiteWise con las rutas de flujo de datos OPC-UA enviadas desde los servidores OPC-UA. Por ejemplo, la ruta del flujo de datos /company/windfarm/3/turbine/7/temperature podría representar el sensor de temperatura de la turbina n.º 7 en el parque eólico n.º 3. Si AWS IoT Greengrass del núcelo pierde la conexión a Internet, el conector almacenará los datos en la caché hasta que pueda conectarse correctamente a la Nube de AWS. Puede configurar el tamaño máximo del búfer de disco utilizado para el almacenamiento de datos en la caché. Si el tamaño de la caché excede el tamaño máximo del búfer de disco, el conector descartará los datos más antiguos de la cola.

Después de configurar e implementar el SiteWise conector de IoT, puede agregar una puerta de enlace y fuentes OPC-UA en la consola de IoT SiteWise . Al configurar una fuente en la consola, puede filtrar o prefijar las rutas de flujo de datos OPC-UA enviadas por el conector IoT. SiteWise Para obtener instrucciones sobre cómo terminar de configurar la gateway y los orígenes, consulte Añadir la gateway en la Guía del usuario de AWS IoT SiteWise.

SiteWise El IoT recibe datos únicamente de los flujos de datos que usted ha asignado a las propiedades de medición de los SiteWise activos de IoT. Para asignar secuencias de datos a propiedades de recurso, puede establecer el alias de una propiedad para que sea equivalente a una ruta de flujo de datos OPC-UA. Para obtener más información sobre cómo definir modelos de recursos y crear recursos, consulte Crear modelos de recursos industriales en la Guía del usuario de AWS IoT SiteWise.

Notas

Puedes usar el administrador de transmisiones para cargar datos al IoT SiteWise desde fuentes distintas a los servidores OPC-UA. El administrador de secuencias también ofrece soporte personalizable para la gestión de la persistencia y el ancho de banda. Para obtener más información, consulte Administrar secuencias de datos en el núcleo de AWS IoT Greengrass.

Este conector se ejecuta en modo sin aislamiento de contenedores, por lo que puede implementarlo en un grupo Greengrass que se ejecute en un contenedor de Docker.

Este conector tiene las siguientes versiones.

Versión

ARN

12 (recomendado)

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12

11

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11

10

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10

9

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9

8

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8

7

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7

6

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6

5

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5

4

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4

3

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3

2.

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2

1

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1

Para obtener información sobre los cambios de versión, consulte el Registro de cambios.

Requisitos

Este conector exige los siguientes requisitos:

Version 9, 10, 11, and 12
importante

Esta versión introduce nuevos requisitos: Software de AWS IoT Greengrass Core versión 1.10.2 y el administrador de secuencias.

  • Software AWS IoT Greengrass Core versión 1.10.2

  • Administrador de secuencias habilitado en el grupo de Greengrass.

  • Java 8 instalado en el dispositivo de núcleo y añadido a la variable de entorno PATH.

  • Este conector solo se puede utilizar en las regiones de Amazon Web Services en las que se admiten AWS IoT Greengrasstanto el IoT como el Internet de SiteWise las Cosas.

  • Una política de IAM añadida al rol de grupo de Greengrass. Este rol permite el acceso de grupo de AWS IoT Greengrass a la acción iotsitewise:BatchPutAssetPropertyValue en el recurso raíz de destino y sus elementos secundarios, tal y como se muestra en el siguiente ejemplo. Puede eliminarlo Condition de la política para permitir que el conector acceda a todos sus SiteWise activos de IoT.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    Para obtener más información, consulte Adición y eliminación de políticas de IAM en la Guía del usuario de IAM.

Versions 6, 7, and 8
importante

Esta versión introduce nuevos requisitos: Software de AWS IoT Greengrass Core v1.10.0 y stream manager.

  • Software AWS IoT Greengrass Core versión 1.10.0

  • Administrador de secuencias habilitado en el grupo de Greengrass.

  • Java 8 instalado en el dispositivo de núcleo y añadido a la variable de entorno PATH.

  • Este conector solo se puede utilizar en las regiones de Amazon Web Services en las que se admiten AWS IoT Greengrasstanto el IoT como el Internet de SiteWise las Cosas.

  • Una política de IAM añadida al rol de grupo de Greengrass. Este rol permite el acceso de grupo de AWS IoT Greengrass a la acción iotsitewise:BatchPutAssetPropertyValue en el recurso raíz de destino y sus elementos secundarios, tal y como se muestra en el siguiente ejemplo. Puede eliminarlo Condition de la política para permitir que el conector acceda a todos sus SiteWise activos de IoT.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    Para obtener más información, consulte Adición y eliminación de políticas de IAM en la Guía del usuario de IAM.

Version 5
  • Software AWS IoT Greengrass Core versión 1.9.4.

  • Java 8 instalado en el dispositivo de núcleo y añadido a la variable de entorno PATH.

  • Este conector solo se puede utilizar en las regiones de Amazon Web Services en las que se admiten AWS IoT Greengrasstanto el IoT como el Internet de SiteWise las Cosas.

  • Una política de IAM añadida al rol de grupo de Greengrass. Este rol permite el acceso de grupo de AWS IoT Greengrass a la acción iotsitewise:BatchPutAssetPropertyValue en el recurso raíz de destino y sus elementos secundarios, tal y como se muestra en el siguiente ejemplo. Puede eliminarlo Condition de la política para permitir que el conector acceda a todos sus SiteWise activos de IoT.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    Para obtener más información, consulte Adición y eliminación de políticas de IAM en la Guía del usuario de IAM.

Version 4
  • Software AWS IoT Greengrass Core versión 1.10.0

  • Java 8 instalado en el dispositivo de núcleo y añadido a la variable de entorno PATH.

  • Este conector solo se puede utilizar en las regiones de Amazon Web Services en las que se admiten AWS IoT Greengrasstanto el IoT como el Internet de SiteWise las Cosas.

  • Una política de IAM añadida al rol de grupo de Greengrass. Este rol permite el acceso de grupo de AWS IoT Greengrass a la acción iotsitewise:BatchPutAssetPropertyValue en el recurso raíz de destino y sus elementos secundarios, tal y como se muestra en el siguiente ejemplo. Puede eliminarlo Condition de la política para permitir que el conector acceda a todos sus SiteWise activos de IoT.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    Para obtener más información, consulte Adición y eliminación de políticas de IAM en la Guía del usuario de IAM.

Version 3
  • Software AWS IoT Greengrass Core versión 1.9.4.

  • Java 8 instalado en el dispositivo de núcleo y añadido a la variable de entorno PATH.

  • Este conector solo se puede utilizar en las regiones de Amazon Web Services en las que se admiten AWS IoT Greengrasstanto el IoT como el Internet de SiteWise las Cosas.

  • Una política de IAM añadida al rol de grupo de Greengrass. Este rol permite el acceso de grupo de AWS IoT Greengrass a la acción iotsitewise:BatchPutAssetPropertyValue en el recurso raíz de destino y sus elementos secundarios, tal y como se muestra en el siguiente ejemplo. Puede eliminarlo Condition de la política para permitir que el conector acceda a todos sus SiteWise activos de IoT.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    Para obtener más información, consulte Adición y eliminación de políticas de IAM en la Guía del usuario de IAM.

Versions 1 and 2
  • Software AWS IoT Greengrass Core versión 1.9.4.

  • Java 8 instalado en el dispositivo de núcleo y añadido a la variable de entorno PATH.

  • Este conector solo se puede utilizar en las regiones de Amazon Web Services en las que se admiten AWS IoT Greengrasstanto el IoT como el Internet de SiteWise las Cosas.

  • Una política de IAM añadida al rol del grupo de Greengrass que permita el acceso a la acción AWS IoT Core y iotsitewise:BatchPutAssetPropertyValue en el recurso raíz de destino y todos sus elementos secundarios, tal y como se muestra en el siguiente ejemplo. Puede eliminarlo Condition de la política para permitir que el conector acceda a todos sus SiteWise activos de IoT.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } }, { "Effect": "Allow", "Action": [ "iot:Connect", "iot:DescribeEndpoint", "iot:Publish", "iot:Receive", "iot:Subscribe" ], "Resource": "*" } ] }

    Para más información, consulte Adición y eliminación de permisos de identidad de IAM en la Guía del usuario de IAM de .

Parámetros

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12
SiteWiseLocalStoragePath

El directorio del AWS IoT Greengrass host en el que el SiteWise conector de IoT puede escribir datos persistentes. El valor predeterminado es /var/sitewise.

Nombre para mostrar en la consola AWS IoT: Ruta de almacenamiento local

Obligatorio: false

Tipo: string

Patrón válido: ^\s*$|\/.

AWSSecretsArnList

Lista de secretos en AWS Secrets Manager. Cada secreto contiene un par clave-valor de contraseña y nombre de usuario de OPC-UA. Cada secreto debe ser un secreto de tipo par clave-valor.

Nombre que mostrar en la consola AWS IoT: Lista de ARN para los secretos de nombre de usuario/contraseña de OPC-UA

Obligatorio: false

Tipo: JsonArrayOfStrings

Patrón válido: \[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]

MaximumBufferSize

El tamaño máximo en GB para el uso SiteWise del disco de IoT. El valor predeterminado es 10 GB.

Nombre para mostrar en la consola AWS IoT: Tamaño máximo del búfer de disco

Obligatorio: false

Tipo: string

Patrón válido: ^\s*$|[0-9]+

Version 1
SiteWiseLocalStoragePath

El directorio del AWS IoT Greengrass host en el que el SiteWise conector de IoT puede escribir datos persistentes. El valor predeterminado es /var/sitewise.

Nombre para mostrar en la consola AWS IoT: Ruta de almacenamiento local

Obligatorio: false

Tipo: string

Patrón válido: ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

El secreto en AWS Secrets Manager que contiene el par clave-valor de contraseña y nombre de usuario de OPC-UA. Este secreto debe ser un secreto de tipo par clave-valor.

Nombre para mostrar en la consola AWS IoT: ARN del nombre de usuario/contraseña secreto de OPC-UA

Obligatorio: false

Tipo: string

Patrón válido: ^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+

SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId

El recurso secreto en el grupo de AWS IoT Greengrass que hace referencia a un secreto de nombre de usuario y contraseña de OPC-UA.

Nombre para mostrar en la consola AWS IoT: Recurso secreto de nombre de usuario/contraseña OPC-UA

Obligatorio: false

Tipo: string

Patrón válido: ^$|.+

MaximumBufferSize

El tamaño máximo en GB para el uso SiteWise del disco de IoT. El valor predeterminado es 10 GB.

Nombre para mostrar en la consola AWS IoT: Tamaño máximo del búfer de disco

Obligatorio: false

Tipo: string

Patrón válido: ^\s*$|[0-9]+

Ejemplo de creación de conector (AWS CLI)

El siguiente AWS CLI comando crea una ConnectorDefinition con una versión inicial que contiene el SiteWise conector IoT.

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyIoTSiteWiseConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11" } ] }'
nota

La función de Lambda de este conector tiene un ciclo de vida prolongado.

En la consola AWS IoT Greengrass, puede añadir un conector desde la página de conectores del grupo. Para obtener más información, consulte Introducción a los conectores de Greengrass (consola).

Datos de entrada

Este conector no acepta mensajes MQTT como datos de entrada.

Datos de salida

Este conector no publica los mensajes MQTT como datos de salida.

Límites

Este conector está sujeto a los siguientes límites impuestos por el IoT SiteWise, incluidos los siguientes. Para obtener más información, consulte puntos de conexión y cuotas de AWS IoT SiteWise en la Referencia general de AWS.

  • Cantidad máxima de puertas de enlace por Cuenta de AWS.

  • Cantidad máxima de orígenes OPC-UA por gateway.

  • Velocidad máxima de puntos de datos timestamp-quality-value (TQV) almacenados por. Cuenta de AWS

  • Tasa máxima de puntos de datos de TQV almacenados por propiedad de recurso.

Licencias

Version 9, 10, 11, and 12

El SiteWise conector IoT incluye el siguiente software o licencia de terceros:

Este conector se publica bajo el contrato de licencia de software de Greengrass Core.

Versions 6, 7, and 8

El SiteWise conector IoT incluye el siguiente software o licencia de terceros:

Este conector se publica bajo el contrato de licencia de software de Greengrass Core.

Versions 1, 2, 3, 4, and 5

El SiteWise conector IoT incluye el siguiente software o licencia de terceros:

Este conector se publica bajo el contrato de licencia de software de Greengrass Core.

Registros de cambios

La siguiente tabla describe los cambios en cada versión del conector.

Versión

Cambios

Date

12

  • Esta versión contiene correcciones de errores.

22 de diciembre de 2021

11

  • Soporte para cadenas que contienen caracteres ocultos o no imprimibles. Los caracteres ocultos y no imprimibles se eliminan automáticamente antes de enviar las cadenas a la Nube de AWS.

  • Se ha corregido un problema que provocaba que la SiteWise puerta de enlace de IoT reintentara de forma infinita las solicitudes no válidas.

  • Se ha corregido un problema que provocaba que un punto de control se dañara cuando la SiteWise puerta de enlace de IoT estaba conectada a una fuente de datos de alta frecuencia.

  • Se han mejorado los mensajes de error para ayudar a solucionar los problemas de configuración de la puerta de enlace.

24 de marzo de 2021

10

StreamManager configurado para mejorar el manejo cuando la conexión de origen se pierde y se restablece. Esta versión también acepta valores OPC-UA con un signo ServerTimestamp cuando no hay un SourceTimestamp disponible.

22 de enero de 2021

9

Se ha lanzado la compatibilidad con los destinos personalizados de la transmisión StreamManager de Greengrass, la banda muerta OPC-UA, el modo de escaneado personalizado y la velocidad de escaneado personalizada. También incluye un rendimiento mejorado durante las actualizaciones de configuración realizadas desde la SiteWise puerta de enlace de IoT.

15 de diciembre de 2020

8

Estabilidad mejorada cuando el conector experimenta una conectividad de red intermitente.

19 de noviembre de 2020

7

Se ha corregido un problema con las métricas de la puerta de enlace.

14 de agosto de 2020

6

Se agregó soporte para CloudWatch métricas y detección automática de nuevas etiquetas OPC-UA. Esta versión requiere el administrador de secuencias y el software AWS IoT Greengrass Core v1.10.0 o superior.

29 de abril de 2020

5

Corrigió un problema de compatibilidad con el software de AWS IoT Greengrass Core v1.9.4.

12 de febrero de 2020

4

Se ha corregido un problema con la reconexión del servidor OPC-UA.

7 de febrero de 2020

3

Requisito de permisos iot:* eliminado.

17 de diciembre de 2019

2

Se ha añadido compatibilidad con varios recursos de secretos de OPC-UA.

10 de diciembre de 2019

1

Versión inicial.

2 de diciembre de 2019

Un grupo de Greengrass solo puede contener una versión del conector a la vez. Para obtener información sobre cómo actualizar una versión de conector, consulte Actualización de versiones de los conectores.

Véase también