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

# 如何搭配 Grafana 使用 AWS IoT TwinMaker 知識圖表
<a name="tm-knowledge-Grafana-panel"></a>

本節說明如何將查詢編輯器面板新增至 Grafana AWS IoT TwinMaker 儀表板，以執行和顯示查詢。

## 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/)中建立工作區。
+ 設定 AWS IoT TwinMaker 以與 Grafana 搭配使用。如需說明，請參閱[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/zh_tw/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>

您的查詢結果會以三種方式顯示，如下列影像所示：以圖形視覺化、在資料表中列出，或顯示為執行摘要。
+ **圖形視覺化：**  
![\[AWS IoT TwinMaker 查詢編輯器結果以視覺化圖形顯示。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/kg-vis-graph.png)

  視覺化圖形只會針對結果中至少具有一個關係的查詢顯示資料。圖形會將實體顯示為節點，並將關係顯示為圖形中的導向邊緣。
+ **表格式資料：**  
![\[AWS IoT TwinMaker 查詢編輯器結果顯示為表格式資料。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/kg-table-data.png)

  表格式資料格式會顯示所有查詢的資料。您可以搜尋資料表以取得特定結果或結果子集。資料可以 JSON 或 CSV 格式匯出。
+ **執行摘要**  
![\[AWS IoT TwinMaker 查詢編輯器結果顯示為執行摘要。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/kg-run-sum.png)

  執行摘要會顯示有關查詢狀態的查詢和中繼資料。