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

# 連線至 AWS X-Ray 資料來源
<a name="x-ray-data-source"></a>

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

 新增 AWS X-Ray 做為資料來源，然後建置儀表板或使用 探索搭配 X-Ray 來查看追蹤、分析或洞見。

 使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的 AWS 資料來源組態選項，將 X-Ray 新增為資料來源。此功能可探索您現有的 X-Ray 帳戶，並管理存取 X-Ray 所需的身分驗證憑證組態，以簡化將 X-Ray 新增為資料來源的程序。您可以使用此方法來設定身分驗證，並將 X-Ray 新增為資料來源，也可以使用與自我管理 Grafana 伺服器上相同的方法手動設定資料來源和必要的身分驗證憑證。

**Topics**
+ [使用 AWS 資料來源組態將 X-Ray 新增為資料來源](xray-adding-AWS-config.md)
+ [手動新增 X-Ray 資料來源](xray-add-the-data-source.md)
+ [X-Ray 設定](#xray-settings)
+ [使用 X-Ray 資料來源](xray-using.md)

## X-Ray 設定
<a name="xray-settings"></a>


|  名稱  |  描述  | 
| --- | --- | 
|  Name  |  資料來源名稱。這是您在面板和查詢中看到資料來源的方式。 | 
|  預設  |  預設資料來源表示新面板會預先選取。 | 
|  預設區域  |  在查詢編輯器中用於設定區域 （可以根據每個查詢進行變更）。 | 
|  驗證提供者  |  指定要取得登入資料的提供者。 | 
|  登入資料設定檔名稱  |  指定要使用的設定檔名稱 （如果您使用 \~/.aws/credentials 檔案），預設請保留空白。 | 
|  擔任角色 Arn  |  指定要擔任的角色 ARN。 | 
|  外部 ID  |  如果您在另一個帳戶中擔任角色，而該角色是以外部 ID 建立的，請在此處指定外部 ID。 | 

### 身分驗證
<a name="xray-authentication"></a>

本節涵蓋可用於 X-Ray 資料來源的不同身分驗證類型。

#### IAM 角色
<a name="xray-iam-roles"></a>

 目前，Grafana 工作區後端會使用官方 AWS SDK 完成對 X-Ray 的所有存取。如果您的 Grafana 伺服器正在執行 AWS，您可以使用 IAM 角色，系統會自動處理身分驗證。

 如需詳細資訊，請參閱 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。

### IAM 政策
<a name="xray-iam-policies"></a>

 Grafana 需要透過 IAM 授予的許可，才能讀取 X-Ray 資料和 EC2 tags/instances/regions。您可以將這些許可連接到 IAM 角色，並使用內建的 Grafana 支援來擔任角色。

 下列程式碼範例顯示最少的政策。

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "xray:BatchGetTraces",
                "xray:GetTraceSummaries",
                "xray:GetTraceGraph",
                "xray:GetGroups",
                "xray:GetTimeSeriesServiceStatistics",
                "xray:GetInsightSummaries",
                "xray:GetInsight",
                "ec2:DescribeRegions"
            ],
            "Resource": "*"
        }
    ]
}
```

------

#### AWS 登入資料範例
<a name="xray-example-aws-credentials"></a>

 您無法在 Amazon Managed Grafana 中使用登入資料檔案方法。