如何搭配 Grafana 使用 AWS IoT TwinMaker 知識圖表 - AWS IoT TwinMaker
AWS IoT TwinMaker 查詢編輯器先決條件知識圖表 Grafana 許可

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

如何搭配 Grafana 使用 AWS IoT TwinMaker 知識圖表

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

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 查詢編輯器

您的查詢結果會以三種方式顯示，如下圖所示：以圖形視覺化、在資料表中列出，或顯示為執行摘要。

  • 圖形視覺化：

    AWS IoT TwinMaker 查詢編輯器結果以視覺化圖形顯示。

    視覺化圖形只會針對結果中至少具有一個關係的查詢顯示資料。圖形會將實體顯示為節點，並將關係顯示為圖形中的導向邊緣。

  • 表格式資料：

    AWS IoT TwinMaker 查詢編輯器結果顯示為表格式資料。

    表格式資料格式會顯示所有查詢的資料。您可以搜尋資料表以取得特定結果或結果子集。資料可以 JSON 或 CSV 格式匯出。

  • 執行摘要

    AWS IoT TwinMaker 查詢編輯器結果顯示為執行摘要。

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