Requisiti Parametri Dati di input Dati di output Limiti Licenze Changelog Consulta anche

AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

SiteWise Connettore IoT

Il SiteWise connettore IoT invia i dati locali di dispositivi e apparecchiature alle proprietà degli asset inAWS IoT SiteWise. È possibile utilizzare questo connettore per raccogliere dati da più server OPC-UA e pubblicarli su IoT. SiteWise Il connettore invia i dati alle proprietà degli asset nell'area corrente Account AWS e nella regione.

Nota

SiteWise L'IoT è un servizio completamente gestito che raccoglie, elabora e visualizza i dati provenienti da dispositivi e apparecchiature industriali. Puoi configurare le proprietà degli asset che elaborano i dati grezzi inviati da questo connettore alle proprietà di misurazione degli asset. Ad esempio, puoi definire una proprietà di trasformazione che converte i punti dati di temperatura Celsius di un dispositivo in Faherenheit oppure puoi definire una proprietà del parametro che calcola la temperatura oraria media. Per ulteriori informazioni, consulta Che cos'è AWS IoT SiteWise? nella Guida per l'utente di AWS IoT SiteWise.

Il connettore invia dati all'IoT SiteWise con i percorsi del flusso di dati OPC-UA inviati dai server OPC-UA. Ad esempio, il percorso del flusso di dati /company/windfarm/3/turbine/7/temperature potrebbe rappresentare il sensore di temperatura della turbina #7 nel parco eolico #3. Se il AWS IoT Greengrass core perde la connessione a Internet, il connettore memorizza i dati nella cache finché non riesce a connettersi correttamente a. Cloud AWS Puoi configurare la dimensione massima del buffer del disco utilizzato per il caching dei dati. Se la dimensione della cache supera la dimensione massima del buffer del disco, il connettore elimina i dati meno recenti dalla coda.

Dopo aver configurato e distribuito il SiteWise connettore IoT, puoi aggiungere un gateway e sorgenti OPC-UA nella console IoT. SiteWise Quando configuri una sorgente nella console, puoi filtrare o aggiungere un prefisso ai percorsi del flusso di dati OPC-UA inviati dal connettore IoT. SiteWise Per istruzioni su come completare la configurazione del gateway e delle origini, consulta Aggiunta del gateway nel Manuale dell'utente di AWS IoT SiteWise.

L'IoT SiteWise riceve dati solo dai flussi di dati mappati alle proprietà di misurazione degli asset SiteWise IoT. Per mappare i flussi di dati alle proprietà degli asset, puoi impostare l'alias di una proprietà in modo che sia equivalente a un percorso del flusso di dati OPC-UA. Per informazioni sulla definizione dei modelli di asset e la creazione di asset, consulta la sezione relativa alla modellazione degli asset industriali nella Guida per l'utente di AWS IoT SiteWise.

Note

Puoi utilizzare stream manager per caricare dati su IoT SiteWise da fonti diverse dai server OPC-UA. Stream manager fornisce anche un supporto personalizzabile per la persistenza e la gestione della larghezza di banda. Per ulteriori informazioni, consulta Gestione dei flussi di dati sul AWS IoT Greengrass Core.

Questo connettore funziona in modalità No container isolation, quindi puoi distribuirlo a un gruppo Greengrass in esecuzione in un contenitore Docker.

Questo connettore ha le seguenti versioni.

Versione	ARN
12 (consigliato)	`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`

Per informazioni sulle modifiche di ogni versione, consulta Changelog.

Requisiti

Questo connettore presenta i seguenti requisiti:

Version 9, 10, 11, and 12

Importante

Questa versione introduce nuovi requisiti: software di AWS IoT Greengrass base v1.10.2 e stream manager.

AWS IoT GreengrassSoftware di base v1.10.2.
Gestore di flusso attivato nel gruppo Greengrass.
Java 8 installato sul dispositivo core e aggiunto alla variabile di ambiente PATH.
Questo connettore può essere utilizzato solo nelle regioni di Amazon Web Services in cui SiteWise sono supportati AWS IoT Greengrasssia l'IoT.

Una policy IAM aggiunta al ruolo del gruppo Greengrass. Questo ruolo consente al gruppo AWS IoT Greengrass di accedere all'azione iotsitewise:BatchPutAssetPropertyValue sulla risorsa radice di destinazione e sui relativi elementi figlio, come illustrato nell'esempio seguente. Puoi rimuoverlo Condition dalla policy per consentire al connettore di accedere a tutte le tue SiteWise risorse IoT.


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

Per ulteriori informazioni, consulta Aggiungere e rimuovere le policy IAM nella IAM User Guide.

Versions 6, 7, and 8

Importante

Questa versione introduce nuovi requisiti: AWS IoT Greengrass Core software v1.10.0 e stream manager.

AWS IoT GreengrassSoftware di base v1.10.0.
Gestore di flusso attivato nel gruppo Greengrass.
Java 8 installato sul dispositivo core e aggiunto alla variabile di ambiente PATH.
Questo connettore può essere utilizzato solo nelle regioni di Amazon Web Services in cui SiteWise sono supportati AWS IoT Greengrasssia l'IoT.


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

Per ulteriori informazioni, consulta Aggiungere e rimuovere le policy IAM nella IAM User Guide.

Version 5

AWS IoT GreengrassSoftware di base v1.9.4.
Java 8 installato sul dispositivo core e aggiunto alla variabile di ambiente PATH.
Questo connettore può essere utilizzato solo nelle regioni di Amazon Web Services in cui SiteWise sono supportati AWS IoT Greengrasssia l'IoT.


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

Per ulteriori informazioni, consulta Aggiungere e rimuovere le policy IAM nella IAM User Guide.

Version 4

AWS IoT GreengrassSoftware di base v1.10.0.
Java 8 installato sul dispositivo core e aggiunto alla variabile di ambiente PATH.
Questo connettore può essere utilizzato solo nelle regioni di Amazon Web Services in cui SiteWise sono supportati AWS IoT Greengrasssia l'IoT.


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

Per ulteriori informazioni, consulta Aggiungere e rimuovere le policy IAM nella IAM User Guide.

Version 3

AWS IoT GreengrassSoftware di base v1.9.4.
Java 8 installato sul dispositivo core e aggiunto alla variabile di ambiente PATH.
Questo connettore può essere utilizzato solo nelle regioni di Amazon Web Services in cui SiteWise sono supportati AWS IoT Greengrasssia l'IoT.


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

Per ulteriori informazioni, consulta Aggiungere e rimuovere le policy IAM nella IAM User Guide.

Versions 1 and 2

AWS IoT GreengrassSoftware di base v1.9.4.
Java 8 installato sul dispositivo core e aggiunto alla variabile di ambiente PATH.
Questo connettore può essere utilizzato solo nelle regioni di Amazon Web Services in cui SiteWise sono supportati AWS IoT Greengrasssia l'IoT.

Una policy IAM aggiunta al ruolo del gruppo Greengrass che consente l'accesso AWS IoT Core e l'iotsitewise:BatchPutAssetPropertyValueazione sull'asset root di destinazione e sui relativi figli, come illustrato nell'esempio seguente. Puoi rimuoverlo Condition dalla policy per consentire al connettore di accedere a tutte le tue SiteWise risorse 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": "*"
        }
    ]
}

Per ulteriori informazioni, consulta Aggiunta e rimozione di autorizzazioni per identità IAM nella Guida per l'utente di IAM .

Parametri

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

SiteWiseLocalStoragePath

La directory sull'AWS IoT Greengrasshost su cui il SiteWise connettore IoT può scrivere dati persistenti. L'impostazione predefinita è /var/sitewise.

Nome visualizzato nella AWS IoT console: Percorso di archiviazione locale

Obbligatorio: false

Tipo: string

Modello valido: ^\s*$|\/.

AWSSecretsArnList

Un elenco di segreti in AWS Secrets Manager ciascuno dei quali contiene un nome utente OPC-UA e una coppia chiave-valore password. Ciascun segreto deve essere di tipo coppia chiave-valore.

Nome visualizzato nella AWS IoT console: elenco di ARN per i segreti relativi a nome utente/password OPC-UA

Obbligatorio: false

Tipo: JsonArrayOfStrings

Modello valido: \[( ?,? ?\"(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

La dimensione massima in GB per l'utilizzo SiteWise del disco IoT. Il valore predefinito è 10 GB.

Nome visualizzato nella AWS IoT console: dimensione massima del buffer del disco

Obbligatorio: false

Tipo: string

Modello valido: ^\s*$|[0-9]+

Version 1

SiteWiseLocalStoragePath

La directory sull'AWS IoT Greengrasshost su cui il SiteWise connettore IoT può scrivere dati persistenti. L'impostazione predefinita è /var/sitewise.

Nome visualizzato nella AWS IoT console: Percorso di archiviazione locale

Obbligatorio: false

Tipo: string

Modello valido: ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

Il segreto in AWS Secrets Manager contenente la coppia chiave-valore di nome utente e password OPC-UA. Questo segreto deve essere di tipo coppia chiave-valore.

Nome visualizzato nella AWS IoT console: ARN del nome utente/password segreto OPC-UA

Obbligatorio: false

Tipo: string

Modello valido: ^$|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

La risorsa segreta nel gruppo AWS IoT Greengrass che fa riferimento a un segreto nome utente e password OPC-UA.

Nome visualizzato nella AWS IoT console: nome utente/password, risorsa segreta OPC-UA

Richiesto: false

Tipo: string

Modello valido: ^$|.+

MaximumBufferSize

La dimensione massima in GB per l'utilizzo SiteWise del disco IoT. Il valore predefinito è 10 GB.

Nome visualizzato nella AWS IoT console: dimensione massima del buffer del disco

Obbligatorio: false

Tipo: string

Modello valido: ^\s*$|[0-9]+

Esempio di creazione di un connettore (AWS CLI)

Il AWS CLI comando seguente crea un file ConnectorDefinition con una versione iniziale che contiene il SiteWise connettore IoT.


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

Nota

Le funzioni Lambda di questo connettore hanno un ciclo di vita di lunga durata.

Nella AWS IoT Greengrass console, puoi aggiungere un connettore dalla pagina Connettori del gruppo. Per ulteriori informazioni, consulta Nozioni di base sui connettori Greengrass (console).

Dati di input

Questo connettore non accetta messaggi MQTT come dati di input.

Dati di output

Questo connettore non pubblica messaggi MQTT come dati di output.

Limiti

Questo connettore è soggetto ai seguenti limiti imposti dall'IoT SiteWise, inclusi i seguenti. Per ulteriori informazioni, consulta AWS IoT SiteWiseendpoint e quote in. Riferimenti generali di AWS

Numero massimo di gateway per. Account AWS
Numero massimo di origini OPC-UA per gateway.
Velocità massima di punti dati timestamp-quality-value (TQV) archiviati per. Account AWS
Tasso massimo di punti dati TQV archiviati per proprietà asset.

Licenze

Changelog

La tabella seguente descrive le modifiche apportate a ciascuna versione del connettore.

Versione	Modifiche	Data
12	Questa versione contiene correzioni di bug.	22 dicembre 2021
11	Support per stringhe che contengono caratteri nascosti o non stampabili. I caratteri nascosti e non stampabili vengono rimossi automaticamente prima che le stringhe vengano inviate a. Cloud AWS È stato risolto un problema che faceva sì che il SiteWise gateway IoT tentasse all'infinito di richieste non valide. È stato risolto un problema che causava un checkpoint danneggiato quando il SiteWise gateway IoT era connesso a una fonte di dati ad alta frequenza. Messaggi di errore migliorati per aiutare a risolvere i problemi di configurazione del gateway.	24 marzo 2021
10	Configurato `StreamManager` per migliorare la gestione in caso di interruzione e ripristino della connessione di origine. Questa versione accetta anche valori OPC-UA con un `ServerTimestamp` quando no è `SourceTimestamp` disponibile.	22 gennaio 2021
9	Supporto lanciato per destinazioni di `StreamManager` streaming Greengrass personalizzate, deadbanding OPC-UA, modalità di scansione personalizzata e velocità di scansione personalizzata. Include anche prestazioni migliorate durante gli aggiornamenti della configurazione effettuati dal SiteWise gateway IoT.	15 dicembre 2020
8	Maggiore stabilità quando il connettore presenta una connettività di rete intermittente.	19 novembre 2020
7	È stato risolto un problema con le metriche del gateway.	14 agosto 2020
6	È stato aggiunto il supporto per le CloudWatch metriche e l'individuazione automatica di nuovi tag OPC-UA. Questa versione richiede il gestore di flusso e il software AWS IoT Greengrass Core v1.10.0 o versione successiva.	29 aprile 2020
5	Risolto un problema di compatibilità con il software AWS IoT Greengrass Core v1.9.4.	12 febbraio 2020
4	Risolto un problema con la riconnessione del server OPC-UA.	7 febbraio 2020
3	Rimozione del requisito delle autorizzazioni `iot:*`.	17 dicembre 2019
2	Aggiunto il supporto per più risorse segrete OPC-UA.	10 dicembre 2019
1	Versione iniziale.	2 dicembre 2019

Un gruppo Greengrass può contenere una sola versione del connettore alla volta. Per informazioni sull'aggiornamento di una versione del connettore, consulta Aggiornamento delle versioni dei connettori.

Consulta anche

Integrazione con servizi e protocolli tramite i connettori Greengrass
Nozioni di base sui connettori Greengrass (console)
Nozioni di base sui connettori Greengrass (CLI)
Consulta i seguenti argomenti nella Guida per l'utente di AWS IoT SiteWise:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Adattatore protocollo IP Ethernet IoT

Kinesis Firehose