IoT SiteWise 連接器 - AWS IoT Greengrass

若我們提供該指南英語版本的翻譯,在有任何牴觸的狀況下請以英文版本的指南為主。其透過機器翻譯提供翻譯。

IoT SiteWise 連接器

IoT SiteWise 連接器會將本機裝置和設備資料傳送至 AWS IoT SiteWise 中的資產屬性。您可以使用此連接器從多個 OPC-UA 伺服器收集資料並將其發佈至 AWS IoT SiteWise。該連接器會將資料傳送至目前 AWS 帳戶和區域中的資產屬性。

注意

AWS IoT SiteWise 是一項全受管的服務,可從工業裝置和設備收集、處理並視覺化資料。您可以設定資產屬性,以處理從此連接器傳送至資產測量內容的原始資料。例如,您可以定義一個將裝置的攝氏溫度資料點轉換為華氏溫度的轉換屬性,或者定義計算每小時平均溫度的指標屬性。有關更多信息,請參閱 什麼是 AWS IoT SiteWise?AWS IoT SiteWise 用戶指南.

連接器會使用從 OPC-UA 伺服器傳送的 OPC-UA 資料流路徑來傳送資料至 AWS IoT SiteWise。例如,資料串流路徑 /company/windfarm/3/turbine/7/temperature 可能代表 3 號風力發電廠 7 號渦輪機的溫度感應器。如果 AWS IoT Greengrass 核心 失去網際網路連線,則連接器會對資料進行快取,直到可以成功連線到 AWS 雲端為止。您可以設定用於快取資料的最大磁碟緩衝區大小。如果快取大小超過磁碟緩衝區大小上限,則連接器會捨棄佇列中最舊的資料。

在您設定和部署 IoT SiteWise 連接器之後,變可以在 AWS IoT SiteWise console 中新增閘道和 OPC-UA 來源。當您在主控台中設定來源時,您可以篩選或前綴由 IoT SiteWise 連接器傳送的 OPC-UA 資料串流路徑。有關完成網關和源設置的說明,請參閱 添加網關AWS IoT SiteWise 用戶指南.

AWS IoT SiteWise 只會從您已對應至 AWS IoT SiteWise 資產測量屬性的資料串流接收資料。若要將資料串流對應至資產屬性,您可以將屬性的別名設定為和 OPC-UA 資料串流路徑相同。要了解如何定義資產模型和創建資產,請參閱 工業資產建模AWS IoT SiteWise 用戶指南.

Notes

您可以使用流管理器將數據上傳到 AWS IoT SiteWise 從OPC-UA服務器以外的來源。StreamManager還爲持久性和帶寬管理提供自定義支持。如需更多詳細資訊,請參閱「管理 AWS IoT Greengrass 核心上的資料串流」。

此連接器以無容器隔離模式執行,因此您可以將它部署於在 Docker 容器中執行的 Greengrass 群組。

這個連接器有下列版本。

版本

ARN

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

如需版本變更的詳細資訊,請參閱 Changelog

要求

這個連接器有下列需求:

Versions 6 and 7
重要

此版本引入了新的要求: AWS IoT Greengrass 核心軟件v1.10.0和 流管理器.

  • AWS IoT Greengrass Core software v1.10.0.

  • 已在 Greengrass 群組上啟用串流管理員

  • Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。

  • 此連接器僅可用於支援的 AWS 區域。如需詳細資訊,請參閱 Limits

  • 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子項上的 iotsitewise:BatchPutAssetPropertyValue 動作,如以下範例所示。您可以從政策中移除 Condition,以允許連接器存取所有 AWS IoT SiteWise 資產。

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

    如需詳細資訊,請參閱 IAM 使用者指南中的新增和移除 IAM 政策

Version 5
  • AWS IoT Greengrass Core software v1.9.4.

  • Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。

  • 此連接器僅可用於支援的 AWS 區域。如需詳細資訊,請參閱 Limits

  • 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子項上的 iotsitewise:BatchPutAssetPropertyValue 動作,如以下範例所示。您可以從政策中移除 Condition,以允許連接器存取所有 AWS IoT SiteWise 資產。

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

    如需詳細資訊,請參閱 IAM 使用者指南中的新增和移除 IAM 政策

Version 4
  • AWS IoT Greengrass Core software v1.10.0.

  • Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。

  • 此連接器僅可用於支援的 AWS 區域。如需詳細資訊,請參閱 Limits

  • 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子項上的 iotsitewise:BatchPutAssetPropertyValue 動作,如以下範例所示。您可以從政策中移除 Condition,以允許連接器存取所有 AWS IoT SiteWise 資產。

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

    如需詳細資訊,請參閱 IAM 使用者指南中的新增和移除 IAM 政策

Version 3
  • AWS IoT Greengrass Core software v1.9.4.

  • Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。

  • 此連接器僅可用於支援的 AWS 區域。如需詳細資訊,請參閱 Limits

  • 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子項上的 iotsitewise:BatchPutAssetPropertyValue 動作,如以下範例所示。您可以從政策中移除 Condition,以允許連接器存取所有 AWS IoT SiteWise 資產。

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

    如需詳細資訊,請參閱 IAM 使用者指南中的新增和移除 IAM 政策

Versions 1 and 2
  • AWS IoT Greengrass Core software v1.9.4.

  • Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。

  • 此連接器僅可用於支援的 AWS 區域。如需詳細資訊,請參閱 Limits

  • 新增到 Greengrass 群組角色的 IAM 政策,允許存取目標根資產及其子項上的 AWS IoT Core 和 iotsitewise:BatchPutAssetPropertyValue 動作,如以下範例所示。您可以從政策中移除 Condition,以允許連接器存取所有 AWS IoT SiteWise 資產。

    { "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": "*" } ] }

    如需詳細資訊,請參閱 IAM 使用者指南中的新增和移除 IAM 身分許可

Parameters

Versions 2, 3, 4, 5, 6, and 7
SiteWiseLocalStoragePath

IoT SiteWise 連接器可永續性寫入資料的 AWS IoT Greengrass 主機目錄。預設為 /var/sitewise

AWS IoT 主控台中的顯示名稱:Local storage path (本機儲存路徑)

必要:false

類型:string

有效的模式: ^\s*$|\/.

AWSSecretsArnList

AWS Secrets Manager 中的秘密清單,其中每個都包含 OPC-UA 使用者名稱和密碼金鑰/值對。每個秘密都必須是金鑰/值對類型的秘密。

AWS IoT 主控台中的顯示名稱:List of ARNs for OPC-UA username/password secrets (OPC-UA 使用者名稱/密碼秘密的 ARN 清單)

必要:false

類型: JsonArrayOfStrings

有效的模式: \[( ?,? ?\"(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

IoT SiteWise 磁碟使用量的大小上限 (以 GB 為單位)。預設為 10GB。

AWS IoT 主控台中的顯示名稱:Maximum disk buffer size (最大磁碟緩衝區大小)

必要:false

類型:string

有效的模式: ^\s*$|[0-9]+

Version 1
SiteWiseLocalStoragePath

IoT SiteWise 連接器可永續性寫入資料的 AWS IoT Greengrass 主機目錄。預設為 /var/sitewise

AWS IoT 主控台中的顯示名稱:Local storage path (本機儲存路徑)

必要:false

類型:string

有效的模式: ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

在 AWS Secrets Manager 中包含 OPC-UA 使用者名稱和密碼索引鍵/值組的秘密。此秘密必須是索引鍵/值組類型的秘密。

AWS IoT 主控台中的顯示名稱:ARN of OPC-UA username/password secret (OPC-UA 使用者名稱/密碼秘密的 ARN)

必要:false

類型:string

有效的模式: ^$|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

在 AWS IoT Greengrass 群組中參考 OPC-UA 使用者名稱和密碼秘密的秘密資源。

AWS IoT 主控台中的顯示名稱:OPC-UA username/password secret resource (OPC-UA 使用者名稱/密碼秘密資源)

必要:false

類型:string

有效的模式: ^$|.+

MaximumBufferSize

IoT SiteWise 磁碟使用量的大小上限 (以 GB 為單位)。預設為 10GB。

AWS IoT 主控台中的顯示名稱:Maximum disk buffer size (最大磁碟緩衝區大小)

必要:false

類型:string

有效的模式: ^\s*$|[0-9]+

建立範例連接器 (AWS CLI)

以下 AWS CLI 命令會使用包含 IoT SiteWise 連接器的初始版本建立 ConnectorDefinition

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

此連接器中的 Lambda 函數具有長效的生命週期。

在 AWS IoT Greengrass 主控台中,您可以從群組的 Connectors (連接器) 頁面新增連接器。如需詳細資訊,請參閱Greengrass 連接器入門 (主控台)

輸入資料

這個連接器不接受 MQTT 訊息做為輸入資料。

輸出資料

此連接器不會將 MQTT 訊息做為輸出資料進行發佈。

Limits

此連接器受下列限制的約束。

  • 所有由 AWS IoT SiteWise 實施的限制,包括以下各項。有關更多信息,請參閱 AWS IoT SiteWise 端點和配額AWS一般參考.

    • 每個 AWS 帳戶的閘道數目上限。

    • 每個閘道的 OPC-UA 來源數目上限。

    • 每個 AWS 帳戶所儲存的時間戳記品質值 (TQV) 資料點之最大速率。

    • 每個資產屬性儲存的 TQV 資料點最大速率。

  • 此連接器只能在同時支援 AWS IoT GreengrassAWS IoT SiteWise 的 AWS 區域中使用。目前,這包含下列區域:

    • US East (N. Virginia) - us-east-1

    • 美國西部 (奧勒岡) - us-west-2

    • 歐洲 (法蘭克福) - eu-central-1

    • 歐洲 (愛爾蘭) - eu-west-1

授權

Versions 6 and 7

IoT SiteWise 連接器包含以下第三方軟體/授權:

這個連接器的發行係遵守 Greengrass Core 軟體授權合約

Versions 1, 2, 3, 4, and 5

IoT SiteWise 連接器包含以下第三方軟體/授權:

這個連接器的發行係遵守 Greengrass Core 軟體授權合約

Changelog

下表說明連接器各版本的變更。

版本

變更

Date

7

修復了網關指標問題。

2020年8月14日

6

新增了對 CloudWatch 指標的支援,以及新 OPC-UA 標籤的自動探索。此版本需要使用串流管理員和 AWS IoT Greengrass Core 軟體 1.10.0 版或更新版本。

2020 年 4 月 29 日

5

已修正 AWS IoT Greengrass 核心軟體 v1.9.4 的相容性問題。

2020 年 2 月 12 日

4

已修正 OPC-UA 伺服器重新連線的問題。

2020 年 2 月 7 日

3

移除 iot:* 許可需求。

2019 年 12 月 17 日

2

新增 OPC-UA 秘密資源的支援。

2019 年 12 月 10 日

1

初始版本。

2019 年 12 月 2 日

Greengrass 群組一次僅可包含一個連接器版本。若要取得有關升級連接器版本的資訊,請參閱升級連接器版本

另請參閱