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

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

AWS IoT TwinMaker は、 AWS IoT SiteWise および イベントアラームを 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 ダッシュボードを設定する

書き込みが有効なダッシュボードの IAM ロールを 2 つ作成する必要があります。これは通常のロールですが、以下の例のように、 アクションが TwinMaker ワークスペースiottwinmaker:BatchPutPropertyValuesに を追加するアクセス許可を持ちます。

{
    "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 ダッシュボードを使用してアラームを視覚化する

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