本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將 AWS IoT SiteWise 警示連接至 AWS IoT TwinMaker Grafana 儀表板

AWS IoT TwinMaker 能夠將 AWS IoT SiteWise 和 事件警示匯入 AWS IoT TwinMaker 元件。這可讓您查詢警示狀態並設定警示閾值，而無需實作自訂資料連接器以進行 AWS IoT SiteWise 資料遷移。您可以使用 AWS IoT TwinMaker Grafana 外掛程式將警示狀態視覺化，並在 Grafana 中設定警示閾值，而無需對警示進行 API 呼叫 AWS IoT TwinMaker 或直接與 AWS IoT SiteWise 警示互動。

AWS IoT SiteWise 警示組態先決條件

在建立警示並將其整合到您的 Grafana 儀表板之前，請確定您已檢閱下列先決條件：

定義 AWS IoT SiteWise 警示元件 IAM 角色

AWS IoT TwinMaker 使用工作區 IAM 角色在 Grafana 中查詢和設定警示閾值。 AWS IoT TwinMaker 工作區角色需要下列許可，才能與 Grafana 中的 AWS IoT SiteWise 警示互動：

{
"Effect": "Allow",
    "Action": [
        "iotevents:DescribeAlarmModel",
    ],
    "Resource": ["{IoTEventsAlarmModelArn}"]
},{
"Effect": "Allow",
    "Action": [
        "iotsitewise:BatchPutAssetPropertyValue"
    ],
    "Resource": ["{IoTSitewiseAssetArn}"]
}

在 AWS IoT TwinMaker 主控台中，建立代表您 AWS IoT SiteWise 資產的實體。請務必使用 新增該實體的元件com.amazon.iotsitewise.alarm做為元件類型，並挑選對應的資產和警示模型。

上述螢幕擷取畫面是使用 類型建立此實體的範例com.amazon.iotsitewise.alarm。

當您建立此元件時， AWS IoT TwinMaker 會自動從 AWS IoT SiteWise 和 匯入相關的警示屬性 AWS IoT Events。您可以重複此警示元件類型模式，為工作區中所需的所有資產建立警示元件。

透過 AWS IoT TwinMaker API 查詢和更新

建立警示元件之後，您可以透過 AWS IoT TwinMaker API 查詢警示狀態、閾值和更新警示閾值。

以下是查詢警示狀態的範例請求：

aws iottwinmaker get-property-value-history --cli-input-json \
'{
    "workspaceId": "{workspaceId}",
    "entityId": "{entityId}",
    "componentName": "{componentName}",
    "selectedProperties": ["alarm_status"],
    "startTime": "{startTimeIsoString}",
    "endTime": "{endTimeIsoString}"
}'

以下是查詢警示閾值的範例請求。

aws iottwinmaker get-property-value-history --cli-input-json \
'{
    "workspaceId": "{workspaceId}",
    "entityId": "{entityId}",
    "componentName": "{componentName}",
    "selectedProperties": ["alarm_threshold"],
    "startTime": "{startTimeIsoString}",
    "endTime": "{endTimeIsoString}"
}'

以下是更新警示閾值的範例請求：

aws iottwinmaker batch-put-property-values --cli-input-json \
'{
    "workspaceId": "{workspaceId}",
    "entries": [
        {
            "entityPropertyReference": {
                "entityId": "{entityId}",
                "componentName": "{componentName}",
                "propertyName": "alarm_threshold"
            },
            "propertyValues": [
                {
                    "value": {
                        "doubleValue": "{newThreshold}"
                    },
                    "time": "{effectiveTimeIsoString}"
                }
            ]
        }
    ]
}'

設定警示的 Grafana 儀表板

需要建立第二個啟用寫入的儀表板 IAM 角色 ，這是正常角色，但具有iottwinmaker:BatchPutPropertyValues將 動作新增至 TwinMaker 工作區的許可，如以下範例所示。

JSON

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iottwinmaker:Get*",
               "iottwinmaker:List*",
                "iottwinmaker:BatchPutPropertyValues"
            ],
            "Resource": [
                "{workspaceArn}",
                "{workspaceArn}/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iottwinmaker:ListWorkspaces",
            "Resource": "*"
        }
    ]
}

或者，您可以在 IAM 角色的結尾新增此陳述式：

{
    "Effect": "Allow",
    "Action": [
        "iottwinmaker:BatchPutPropertyValues"
    ],
    "Resource": [
        "{workspaceArn}",
        "{workspaceArn}/*"
    ]
}

資料來源需要使用您建立的儀表板寫入角色來設定其寫入 arn。

修改 IAM 角色後，請登入 Grafana 儀表板以擔任更新的角色。選取定義警示組態面板寫入許可的核取方塊，並在 arn 中複製寫入角色。

使用 Grafana 儀表板進行警示視覺化

使用下列程序將警示組態面板新增至儀表板並進行設定：：