SiteWise Conector IoT

Modo de enfoque

SiteWise Conector IoT - AWS IoT Greengrass

Requisitos Parámetros Datos de entrada Datos de salida Límites Licencias Registros de cambios Véase también

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.

El SiteWise conector IoT envía datos de dispositivos y equipos locales a las propiedades de los activos AWS 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 los activos en la región Cuenta de AWS y en la actual.

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 el AWS IoT Greengrass núcleo pierde la conexión a Internet, el conector almacena los datos en caché hasta que se pueda conectar correctamente a Internet. 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 flujos también ofrece soporte personalizable para la gestión de la persistencia y el ancho de banda. Para obtener más información, consulte Gestione los flujos de datos en el AWS IoT Greengrass núcleo.

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 presenta nuevos requisitos: el software AWS IoT Greengrass básico v1.10.2 y el administrador de transmisiones.

AWS IoT Greengrass Software básico v1.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. Esta función permite al AWS IoT Greengrass grupo acceder a la iotsitewise:BatchPutAssetPropertyValue acción en el activo raíz de destino y sus elementos secundarios, 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 presenta nuevos requisitos: el software AWS IoT Greengrass básico v1.10.0 y el administrador de transmisiones.

AWS IoT Greengrass Software básico v1.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.


{
    "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

AWS IoT Greengrass Software básico, 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.


{
    "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

AWS IoT Greengrass Software básico, 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.


{
    "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

AWS IoT Greengrass Software básico, 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.


{
    "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

AWS IoT Greengrass Software básico, 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.

Se agregó una política de IAM al rol del grupo Greengrass que permite el acceso AWS IoT Core y iotsitewise:BatchPutAssetPropertyValue la acción en el activo raíz de destino y sus elementos secundarios, 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, consulta Adición y eliminación de permisos de identidad de IAM en la Guía del usuario de IAM.

anchor anchor anchor anchor anchor anchor

importante

Esta versión presenta nuevos requisitos: el software AWS IoT Greengrass básico v1.10.2 y el administrador de transmisiones.

AWS IoT Greengrass Software básico v1.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.


{
    "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.

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 AWS IoT consola: ruta de almacenamiento local

Obligatorio: false

Tipo: string

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

AWSSecretsArnList

Una lista de secretos, cada uno de AWS Secrets Manager los cuales contiene un par clave-valor de nombre de usuario y contraseña del OPC-UA. Cada secreto debe ser un secreto de tipo par clave-valor.

Nombre para mostrar en la AWS IoT consola: lista de nombres de usuario y contraseñas secretos del OPC-UA ARNs

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 AWS IoT consola: 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 AWS IoT consola: ruta de almacenamiento local

Obligatorio: false

Tipo: string

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

SiteWiseOpcuaUserIdentityTokenSecretArn

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

Nombre para mostrar en la AWS IoT consola: 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 del AWS IoT Greengrass grupo que hace referencia a un nombre de usuario y contraseña secretos del OPC-UA.

Nombre para mostrar en la AWS IoT consola: recurso secreto de nombre de usuario/contraseña del 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 AWS IoT consola: tamaño máximo del búfer de disco

Obligatorio: false

Tipo: string

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

anchor anchor

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 AWS IoT consola: ruta de almacenamiento local

Obligatorio: false

Tipo: string

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

AWSSecretsArnList

Una lista de secretos, cada uno de AWS Secrets Manager los cuales contiene un par clave-valor de nombre de usuario y contraseña del OPC-UA. Cada secreto debe ser un secreto de tipo par clave-valor.

Nombre para mostrar en la AWS IoT consola: lista de nombres de usuario y contraseñas secretos del OPC-UA ARNs

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 AWS IoT consola: 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 AWS IoT Greengrass consola, 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

anchor anchor anchor

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 transmisiones y el software AWS IoT Greengrass Core v1.10.0 o superior.	29 de abril de 2020
5	Se ha corregido un problema de compatibilidad con la versión 1.9.4 del software AWS IoT Greengrass Core.	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

Integración con servicios y protocolos mediante conectores de Greengrass
Introducción a los conectores de Greengrass (consola)
Introducción a los conectores de Greengrass (CLI)
Consulte los siguientes temas en la Guía del usuario de AWS IoT SiteWise :

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Adaptador de protocolo IP Ethernet IoT

Kinesis Firehose

Tema siguiente:

Kinesis Firehose

Tema anterior:

Adaptador de protocolo IP Ethernet IoT

¿Necesita ayuda?

En esta página

¿Le ha servido de ayuda esta página?

Enviar comentarios

Privacidad Términos del sitio Preferencias de cookies

Seleccione sus preferencias de cookies

Personalizar preferencias de cookies

Esenciales

De rendimiento

Funcionales

De publicidad

No se pueden guardar las preferencias de cookies

SiteWise Conector IoT

nota

Notas

Requisitos

importante

importante

importante

Parámetros

Ejemplo de creación de conector (AWS CLI)

nota

Datos de entrada

Datos de salida

Límites

Licencias

Registros de cambios

Véase también

Tema siguiente:

Tema anterior:

¿Necesita ayuda?

En esta página

¿Le ha servido de ayuda esta página?