翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS IoT SiteWise アラームを AWS IoT TwinMaker Grafana ダッシュボードに接続する

AWS IoT TwinMaker は、 AWS IoT SiteWise および Events アラームを AWS IoT TwinMaker コンポーネントにインポートできます。これにより、 AWS IoT SiteWise データ移行用のカスタムデータコネクタを実装することなく、アラームステータスをクエリし、アラームしきい値を設定できます。Grafana プラグインを使用すると AWS IoT TwinMaker 、 を API コール AWS IoT TwinMaker したり、アラームを直接操作したりすることなく、アラームステータスを視覚化し、Grafana で AWS IoT SiteWise アラームしきい値を設定できます。

AWS IoT SiteWise アラーム設定の前提条件

アラームを作成して Grafana ダッシュボードに統合する前に、以下の前提条件を確認します。

AWS IoT SiteWise アラームコンポーネントの IAM ロールを定義する

AWS IoT TwinMaker はワークスペース IAM ロールを使用して、Grafana でアラームしきい値をクエリおよび設定します。Grafana で AWS IoT SiteWise アラームを操作するには、 AWS IoT TwinMaker ワークスペースロールで次のアクセス許可が必要です。

{
"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 SiteWise および から関連するアラームプロパティ AWS IoT TwinMaker を自動的にインポートします 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 ダッシュボードを設定する

2 つ目の書き込み可能なダッシュボード 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}/*"
    ]
}

データソースには、作成したダッシュボード書き込みロールに write arn が設定されている必要があります。

IAM ロールを変更したら、Grafana ダッシュボードにログインして、更新されたロール ARN を引き受けます。アラーム設定パネルの書き込みアクセス許可の定義のチェックボックスをオンにし、書き込みロールの ARN にコピーします。

Grafana ダッシュボードを使用してアラームを視覚化する

以下の手順に従って、ダッシュボードにアラーム設定パネルを追加して設定します。