Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita Migrar desde AWS IoT Greengrass Version 1.
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 activos AWS IoT SiteWise. Puede usar este conector para recopilar datos de varios OPC-UA servidores 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.
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 OPC-UA datos enviadas desde los OPC-UA servidores. 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 OPC-UA fuentes en la SiteWise consola de IoT. Al configurar una fuente en la consola, puede filtrar o prefijar las rutas de flujo de OPC-UA datos enviadas por el SiteWise conector de IoT. 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 flujos de datos a propiedades de activos, puede configurar el alias de una propiedad para que sea equivalente a una ruta de flujo de OPC-UA datos. 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 .
Puedes usar el administrador de transmisiones para cargar datos al IoT SiteWise desde fuentes distintas de OPC-UA los servidores. 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 core.
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
-
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.
JSON
- JSON
-
{
"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
-
-
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.
-
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.
JSON
- JSON
-
{
"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.
-
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.
JSON
- JSON
-
{
"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.
-
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.
JSON
- JSON
-
{
"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.
-
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.
JSON
- JSON
-
{
"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.
JSON
- JSON
-
{
"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 obtener más información, consulta Adición y eliminación de permisos de identidad de IAM en la Guía del usuario de IAM.
Parameters
- 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 OPC-UA clave-valor de nombre de usuario y contraseña. Cada secreto debe ser un secreto de tipo par clave-valor.
Nombre para mostrar en la AWS IoT consola: lista de los ARN de los secretos OPC-UA username/password
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 AWS Secrets Manager que contiene el par clave-valor del nombre de OPC-UA usuario y la contraseña. Este secreto debe ser un secreto de tipo par clave-valor.
Nombre para mostrar en la AWS IoT consola: ARN del secreto OPC-UA username/password
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 OPC-UA de usuario y una contraseña secreta.
Nombre para mostrar en la AWS IoT consola: recurso OPC-UA username/password secreto
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]+
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"
}
]
}'
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).
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.
-
Número máximo de OPC-UA fuentes por puerta de enlace.
-
Tasa máxima de puntos de datos de marca temporal y valor de calidad (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 los siguientes productos de terceros software/licensing:
Este conector se publica bajo el contrato de licencia de software de Greengrass Core.
- Versions 6, 7, and 8
-
El SiteWise conector IoT incluye los siguientes productos de terceros software/licensing:
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 los siguientes productos de terceros software/licensing:
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
|
|
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 OPC-UA valores con un signo ServerTimestamp cuando no SourceTimestamp está disponible.
|
22 de enero de 2021
|
|
9
|
Se lanzó soporte para destinos de StreamManager transmisión personalizados de Greengrass, OPC-UA bandas muertas, modo de escaneo personalizado y velocidad de escaneo 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 OPC-UA etiquetas. 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 OPC-UA del servidor.
|
7 de febrero de 2020
|
|
3
|
Requisito de permisos iot:* eliminado.
|
17 de diciembre de 2019
|
|
2
|
Se ha añadido soporte para varios recursos OPC-UA secretos.
|
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
