Grafana で AWS IoT TwinMaker ナレッジグラフを使用する方法 - AWS IoT TwinMaker
AWS IoT TwinMaker クエリエディタの前提条件ナレッジグラフ Grafana アクセス許可

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

Grafana で AWS IoT TwinMaker ナレッジグラフを使用する方法

このセクションでは、クエリエディタパネルを AWS IoT TwinMaker Grafana ダッシュボードに追加してクエリを実行および表示する方法について説明します。

AWS IoT TwinMaker クエリエディタの前提条件

Grafana で AWS IoT TwinMaker ナレッジグラフを使用する前に、次の前提条件を完了してください。

注記

AWS IoT TwinMaker ナレッジグラフを使用するには、標準または階層バンドルの料金モードのいずれかである必要があります。詳細については、「AWS IoT TwinMaker 価格設定モードの切り替え」を参照してください。

AWS IoT TwinMaker クエリエディタのアクセス許可

Grafana で AWS IoT TwinMaker クエリエディタを使用するには、アクション のアクセス許可を持つ IAM ロールが必要ですiottwinmaker:ExecuteQuery。この例に示すように、ワークスペースダッシュボードロールにそのアクセス許可を追加します。

JSON
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "{s3Arn}",
                "{s3Arn}/"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iottwinmaker:Get",
                "iottwinmaker:List",
                "iottwinmaker:ExecuteQuery"
            ],
            "Resource": [
                "{workspaceArn}",
                "{workspaceArn}/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iottwinmaker:ListWorkspaces",
            "Resource": "*"
        }
    ]
}
注記

AWS IoT TwinMaker Grafana データソースを設定するときは、ロールの引き受け ARN フィールドにこのアクセス許可を持つロールを使用してください。追加したら、[ワークスペース] の横にあるドロップダウンからワークスペースを選択できます。

詳細については、「ダッシュボード IAM ロールの作成」を参照してください。

AWS IoT TwinMaker クエリエディタパネルを設定する

ナレッジグラフ用に新しい Grafana ダッシュボードパネルを設定するには

  1. AWS IoT TwinMaker Grafana ダッシュボードを開きます。

  2. 新しい [ダッシュボードパネル] を作成します。パネルの作成方法の詳細については、Grafana ドキュメントの「ダッシュボードの作成」を参照してください。

  3. 視覚化のリストから、AWS IoT TwinMaker クエリエディタを選択します。

    AWS IoT TwinMaker ダッシュボードのドロップダウンリストには、 AWS IoT TwinMaker クエリエディタのオプションが含まれています。

  4. クエリを実行するデータソースを選択します。

  5. (オプション) 表示されたフィールドに新しいパネルの名前を追加します。

  6. 適用 を選択して、新しいパネルを保存して確認します。

ナレッジグラフパネルは、 AWS IoT TwinMaker コンソールで提供されるクエリエディタと同様に機能します。パネルで作成したクエリを実行、記述、クリアできます。クエリの書き込み方法の詳細については、「」を参照してくださいAWS IoT TwinMaker ナレッジグラフの追加リソース。

AWS IoT TwinMaker クエリエディタの使用方法

クエリの結果は、次の画像のとおり、グラフで視覚化、表で一覧表示、および実行サマリーとして表示、の 3 つの方法で表示されます。

  • グラフの視覚化

    AWS IoT TwinMaker クエリエディタの結果がビジュアルグラフとして表示されます。

    ビジュアルグラフには、結果に少なくとも 1 つのリレーションを含むクエリのデータのみが表示されます。グラフには、エンティティがノードとして表示され、関係が有向エッジとしてグラフに表示されます。

  • 表形式データ：

    AWS IoT TwinMaker クエリエディタの結果が表形式データとして表示されます。

    表形式のデータには、すべてのクエリのデータ表示されます。テーブルで特定の結果または結果のサブセットを検索できます。データは JSON 形式または CSV 形式でエクスポートできます。

  • 実行サマリー

    AWS IoT TwinMaker クエリエディタの結果が実行概要として表示されます。

    実行サマリーには、クエリとクエリのステータスに関するメタデータが表示されます。