

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

# 連線至 an AWS IoT TwinMaker 資料來源
<a name="AMG-iot-twinmaker"></a>

**注意**  
在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。

 使用 Amazon Managed Grafana，您可以在 Grafana 工作區中新增強大的工業資料分析服務 AWS IoT TwinMaker，做為應用程式和資料來源。透過 AWS IoT TwinMaker，您可以建立最終使用者 3D 數位分身應用程式來監控工業操作。 AWS IoT TwinMaker 是一種服務，可讓開發人員更快速地建立真實世界系統的數位複本，協助更多客戶實現數位分身的潛力以最佳化操作。 AWS IoT TwinMaker for Grafana 提供自訂面板、儀表板範本和資料來源，以連線至您的數位分身資料。

# 手動新增 AWS IoT TwinMaker 資料來源
<a name="twinmaker-add-the-data-source"></a>

## 先決條件
<a name="twinmaker-prerequisites"></a>

開始之前，請確定您可以從 存取 **AWS IoT TwinMaker** AWS 帳戶。

 若要了解如何將許可新增至工作區 IAM 角色以存取 AWS IoT TwinMaker，請參閱 [將 AWS IoT TwinMaker 的許可新增至您的工作區使用者角色](AMG-iot-twinmaker.md#twinmaker-add-permission)。

**若要新增 AWS IoT TwinMaker 資料來源：**

1. 確保您的使用者角色是管理員或編輯器。

1.  在 Grafana 主控台側邊選單中，將滑鼠游標暫留在**組態** （齒輪） 圖示上，然後選擇**資料來源**。

1. 選擇**新增資料來源**。

1. 選擇 **AWS IoT TwinMaker** 資料來源。如有必要，您可以開始**TwinMaker**在搜尋方塊中輸入 ，以協助您找到它。

1. 這會開啟**連線詳細資訊**頁面。請遵循設定 中的步驟[AWS IoT TwinMaker 連線詳細資訊設定](AMG-iot-twinmaker.md#twinmaker-connection-details)。

## 將 AWS IoT TwinMaker 的許可新增至您的工作區使用者角色
<a name="twinmaker-add-permission"></a>

**若要將 AWS IoT TwinMaker 許可新增至工作區使用者角色，請擔任 Amazon Managed Grafana 工作區和 TwinMaker 儀表板角色之間的角色許可。**

1. 前往 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。

1. 手動建立儀表板角色。如需建立儀表板角色的詳細資訊，請參閱 [手動建立 Grafana AWS IoT TwinMaker 儀表板角色](#iot-twinmaker-dashboard-role)。

## AWS IoT TwinMaker 連線詳細資訊設定
<a name="twinmaker-connection-details"></a>

**設定連線詳細資訊設定**

1.  在**連線詳細資訊**功能表中，選取身分驗證提供者 （建議：**工作區 IAM 角色**)。

1.  選擇您要查詢**的預設區域**。

1.  在 **TwinMaker 設定**中，輸入 AWS IoT TwinMaker 工作區名稱。

# 使用 AWS IoT TwinMaker 資料來源
<a name="IoT-twinmaker-using"></a>

如需有關如何使用 AWS IoT TwinMaker 資料來源的資訊，請參閱 GitHub 上的 [AWS IoT TwinMaker 資料來源](https://github.com/grafana/grafana-iot-twinmaker-app)。

## 手動建立 Grafana AWS IoT TwinMaker 儀表板角色
<a name="iot-twinmaker-dashboard-role"></a>

**手動建立 Grafana AWS IoT TwinMaker 儀表板角色**

1. 登入 IAM 主控台，網址為 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。

1. 在摘要中尋找您的 Amazon Managed Grafana 工作區角色。它如下所示：

   ```
    AmazonGrafanaServiceRole-random_ID
   ```

1. 將下列內嵌政策新增至角色：

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

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": {
           "Effect": "Allow",
           "Action": "sts:AssumeRole",
           "Resource": "arn:aws:iam::111122223333:role/TwinMakerDashboardRole"
       }
   }
   ```

------

1. 為每個儀表板角色新增內嵌政策。或者，在資源列新增角色 Amazon **Resource** Name (ARNs) 的清單。

1. 在 IAM 主控台中尋找您的儀表板角色。它應該有 `SceneViewer`政策，以及選擇性`VideoPlayer`的政策。

1. 選擇**信任關係**索引標籤。

1. 選擇**編輯信任關係**。

1. 輸入下列政策，將 *AMGWorkspaceRoleArn* 取代為來自您帳戶的 Arn：

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

****  

   ```
      {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "AWS": "AMGWorkspaceRoleARN"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

## 範例 an AWS IoT TwinMaker 政策
<a name="AMG-TM-policy"></a>

以下是您可以連接到儀表板角色的 minimal AWS IoT TwinMaker 政策。您必須根據自己的資源，取代 AWS IoT TwinMaker 工作區 ARN 和 ID 以及 Amazon S3 儲存貯體 ARN 的值。