本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Connect 连接到 AWS X-Ray 数据源
**注意**
在支持版本 9 或更高版本的工作区中，此数据来源可能需要您安装相应的插件。有关更多信息，请参阅 [使用插件扩展您的工作区](grafana-plugins.md)。
添加 AWS X-Ray 为数据源，然后构建仪表板或使用 Explore with 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)
# 使用 AWS 数据源配置将 X-Ray 添加为数据源
要使用 AWS 数据源配置，首先要使用 Amazon Managed Grafana 控制台启用服务管理的 IAM 角色，这些角色向工作空间授予读取账户或整个组织单位中的 X-Ray 资源所必需的 IAM 策略。然后，您可以使用 Amazon Managed Grafana 工作区控制台，将 X-Ray 添加为数据来源。
**使用 AWS 数据源配置将 X-Ray 添加为数据源**
1. 打开 Amazon Managed Grafana 控制台，其位于 [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)。
1. 在页面左上角，选择菜单图标，然后选择**所有工作区**。
1. 选择工作区的名称。
1. 如果您在创建此工作空间时没有选择使用服务管理权限，请从使用客户托管权限更改为使用服务管理权限，以确保启用适当的 IAM 角色和策略以使用 Grafana 工作区控制台中的 AWS 数据源配置选项。为此，请按 **IAM 角色**选择编辑图标，然后选择**服务托管**、**保存更改**。有关更多信息，请参阅 [亚马逊托管 Grafana 数据源的权限和政策 AWS](AMG-manage-permissions.md)。
1. 选择**数据来源**选项卡。然后选中 **AWS X-Ray** 的复选框，选择**操作**和**启用服务管理的策略**。
1. 再次选择**数据来源**选项卡，然后在 **AWS X-Ray** 行中选择**在 Grafana 中配置**。
1. 如有必要，使用 IAM Identity Center 登录 Grafana 工作区控制台。
1. **在 Grafana 工作区控制台的左侧导航栏中，选择图标，然后选择 AWS **AWS 服务** X-Ray。**
1. 选择您希望 X-Ray 数据来源从中查询的默认区域，选择账户，然后选择**添加数据来源**。
# 手动添加 X-Ray 数据来源
**手动添加 X-Ray 数据来源**
1. 在 Grafana 控制台侧边菜单中，将鼠标悬停在**配置**（齿轮）图标上，然后选择**数据来源**。
1. 选择**添加数据来源**。
1. 选择 **X-Ray** 数据来源。如有必要，您可以在搜索框中键入 **X-Ray**，帮助查找。
## X-Ray 设置
| Name | 说明 |
| --- | --- |
| Name | 数据来源名称。您将在面板和查询中通过其名称查看数据来源。 |
| 默认 | 默认数据来源意味着将为新面板预先选择该数据来源。 |
| 默认区域 | 在查询编辑器中用于设置区域（可根据每个查询进行更改）。 |
| 身份验证提供商 | 指定要获取凭证的提供商。 |
| 凭证配置文件名称 | 指定要使用的配置文件名称（如果使用 \$1/.aws/credentials 文件），默认留空。 |
| 代入角色 Arn | 指定要代入的角色的 ARN。 |
| 外部 ID | 如果您在使用外部 ID 创建的另一个账户中代入角色，请在此处指定外部 ID。 |
### 身份验证
本节介绍了可用于 X-Ray 数据来源的不同类型的身份验证。
#### IAM 角色
目前，所有对 X-Ray 的访问都是在服务器端使用官方 SDK 在 Grafana 工作空间后端完成的。 AWS 如果您的 Grafana 服务器正在运行 AWS，则可以使用 IAM 角色，身份验证将自动处理。
有关更多信息，请参阅 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。
### IAM 策略
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 证书示例
在 Amazon Managed Grafana 中，不能使用凭证文件方法。
# 使用 X-Ray 数据来源
## 查询编辑器
编辑器中最重要的字段是查询类型。有四种查询类型：
+ 跟踪列表（输入的痕迹 AWS）
+ Trace Statistics
+ 追踪分析（中的分析 AWS）
+ 见解
## Trace List
Trace List 类型允许搜索以表形式显示的跟踪。在第一列中选择跟踪 ID 会在右侧打开跟踪。注意编辑器中的查询字段。您可以编写查询、筛选表达式，也可以插入显示在跟踪视图中的单个跟踪 ID。有关筛选表达式的更多详细信息，请参阅 [AWS X-Ray 文档](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html)。
**注意**
跟踪列表仅显示前 1000 条跟踪。
## Trace Statistics
在 Trace Statistics 中，您可以看到一个图形和一个表，其中显示了有关错误、故障、限制、成功和总数的信息。您可以使用查询编辑器中的列字段，仅查看指定的列。
## 跟踪分析
在 Trace Analytics 中，您对以下表进行可视化。
+ 根本原因
+ 响应时间
+ 根本原因服务（路径中的最后一个服务）
+ 路径（多条路径）
+ 错误
+ 根本原因服务（路径中的最后一个服务）
+ 路径
+ 错误消息
+ 故障
+ 根本原因服务（路径中的最后一个服务）
+ 路径
+ 错误消息
+ 最终用户影响
+ URL
+ HTTP 状态代码
## 见解
在 Insights 中，您可以查看 Insights 的摘要表。选择， InsightId 将带您进入 AWS 管理控制台。
## 警报
由于 X-Ray 查询可以返回数值数据，因此支持警报。有关更多信息，请参阅 [Grafana Alerting](alerts-overview.md)。