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

# Grafana で AWS IoT TwinMaker ナレッジグラフを使用する方法
<a name="tm-knowledge-Grafana-panel"></a>

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

## AWS IoT TwinMaker クエリエディタの前提条件
<a name="tm-knowledge-graph-Grafana-prereqs"></a>

Grafana で AWS IoT TwinMaker ナレッジグラフを使用する前に、次の前提条件を完了してください。
+  AWS IoT TwinMaker ワークスペースを作成します。ワークスペースは、[AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)で作成できます。
+ Grafana で使用する AWS IoT TwinMaker ように を設定します。手順については、「[AWS IoT TwinMaker Grafana ダッシュボードの統合](grafana-integration.md)」を参照してください。

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

## AWS IoT TwinMaker クエリエディタのアクセス許可
<a name="tm-knowledge-graph-Grafana-config"></a>

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

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iottwinmaker:GetEntity",
                "iottwinmaker:ListEntities",
                "iottwinmaker:ExecuteQuery"
            ],
            "Resource": [
                "arn:aws:iottwinmaker:us-east-2:111122223333:workspace/workspaceId",
                "arn:aws:iottwinmaker:us-east-2:111122223333:workspace/workspaceId/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iottwinmaker:ListWorkspaces",
            "Resource": "*"
        }
    ]
}
```

------

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

詳細については、「[ダッシュボード IAM ロールの作成](dashboard-IAM-role.md#dashboard-IAM-role.title)」を参照してください。

### AWS IoT TwinMaker クエリエディタパネルを設定する
<a name="tm-knowledge-graph-Grafana-panel"></a>

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

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

1. 新しい **[ダッシュボードパネル]** を作成します。パネルの作成方法の詳細については、Grafana ドキュメントの[「ダッシュボードの作成](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/)」を参照してください。

1. 視覚化のリストから、**AWS IoT TwinMaker クエリエディタ**を選択します。  
![\[AWS IoT TwinMaker ダッシュボードのドロップダウンリストには、 AWS IoT TwinMaker クエリエディタのオプションが含まれています。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/tw-query-editor-dropdown.png)

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

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

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

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

#### AWS IoT TwinMaker クエリエディタの使用方法
<a name="tm-knowledge-graph-Grafana-use"></a>

クエリの結果は、次の画像のとおり、グラフで視覚化、表で一覧表示、および実行サマリーとして表示、の 3 つの方法で表示されます。
+ **グラフの視覚化**  
![\[AWS IoT TwinMaker ビジュアルグラフとして表示されるクエリエディタの結果。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/kg-vis-graph.png)

  ビジュアルグラフには、結果に少なくとも 1 つのリレーションを含むクエリのデータのみが表示されます。グラフには、エンティティがノードとして表示され、関係が有向エッジとしてグラフに表示されます。
+ **表形式データ:**  
![\[AWS IoT TwinMaker クエリエディタの結果が表形式データとして表示されます。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/kg-table-data.png)

  表形式のデータには、すべてのクエリのデータ表示されます。テーブルで特定の結果または結果のサブセットを検索できます。データは JSON 形式または CSV 形式でエクスポートできます。
+ **実行サマリー**  
![\[AWS IoT TwinMaker クエリエディタの結果が実行概要として表示されます。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/kg-run-sum.png)

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