本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 连接到 Dynatrace 数据来源
的数据源 [https://www.dynatrace.com/](https://www.dynatrace.com). 要使用此数据来源，您必须拥有 Dynatrace 账户。
**注意**
此数据来源仅适用于 Grafana Enterprise。有关更多信息，请参阅 [管理对 Enterprise 插件的访问](upgrade-to-enterprise-plugins.md)。
此外，在支持版本 9 或更高版本的工作区中，此数据来源可能需要您安装相应的插件。有关更多信息，请参阅 [使用插件扩展您的工作区](grafana-plugins.md)。
**已知限制条件**
模板变量不能多选。仅支持选择单个选项。
仅支持 v2 指标 API。
## 功能
### 核心功能
+ 模板变量
+ 指标名称
+ 仅限单选（**不支持多选**）
+ Ad-Hoc 筛选器
+ Annotations
+ 当前不支持
+ 别名
+ 指标名称
+ 聚合
+ 显示名称
+ 主机
+ 说明
+ 警报
+ 全面的警报支持
### Dynatrace 的特定功能
使用 Dynatrace 指标 v2 API 支持内置指标和自定义指标。有关详细信息，请参阅 Dynatrace 文档：[指标 API v2](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/) 和[指标摄取](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/)。
根据指标，API 可能支持其他转换选项。
## Dynatrace 权限
在 Dynatrace 中您需要以下权限：使用 API V2 读取指标（metrics.read）的权限、使用 API V2 读取实体（entities.read）的权限
## 从 Dynatrace 获取 API 密钥
要设置 API 令牌，请参阅 [Dynatrace API – 令牌和身份验证](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication/?api-token%3C-%3Epersonal-access-token=api-token)
为您的 API 令牌设置 `metrics.read` 和 `entities.read` 权限。
### 配置
1. 在逻辑 Grafana 服务器用户界面中选择 “**Settings/Data 源**”，然后**选择 “**添加数据源”。
1. 在**添加数据来源**页面上，筛选 **Dynatrace**,，然后选择 Dynatrace 插件。
1. 配置 Dynatrace 数据来源需要使用以下参数：
+ `Name`：要应用于 Dynatrace 数据来源的名称（默认值：Dynatrace）。
+ `Dynatrace API Type`：您要连接的 Dynatrace 实例的类型。这是 `SaaS` 或 `Managed Cluster`。
+ `Dynatrace API Token`：这是您在上一步中生成的 API 令牌。
接下来的两个设置取决于您是 Dynatrace SaaS 还是托管的 Dynatrace
+ 在 `yfc55578.live.dynatrace.com` 的 SaaS 示例中，您的**环境 ID** 应为 `yfc55578`。
+ 在 `yd8888.managed-sprint.dynalabs.io/e/abc99984-3af2-55tt-72kl-0672983gc45` 的托管示例中，您的**环境 ID** 应为 `abc99984-3af2-55tt-72kl-0672983gc45`，您的**域**应为 `yd8888.managed-sprint.dynalabs.io`
1. 设置完所有配置值后，选择**保存并测试**以验证配置并保存所做的更改。
### 查询数据来源
使用查询编辑器查询 Dynatrace 指标和问题。查询类型可以是 `metric` 或 `problem`。
**指标查询类型**
+ `Metric`：选择要查看的指标。要再次从 Dynatrace 获取指标列表，请选择**刷新**按钮。
+ `Aggregations`：选择要用于特定指标的聚合。选择聚合值以更改聚合类型，或选择 **\+** 添加其他聚合。
+ `Transformations`：不能在查询编辑器中选择转换。然后，在选定的转换中输入多个参数。目前，仅支持合并转换。有关转换的详细信息，请参阅[合并转换](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)。
+ `Filters`：Dynatrace 数据来源动态地查询每个指标的相应筛选器。要添加筛选器，请选择 Dynatrace 查询编辑器中**筛选器**标签旁边的 **\+** 符号，选择要筛选的字段，选择要使用的运算符，然后选择要筛选的值。Dynatrace 数据来源允许您创建筛选器组，您可以将这些筛选器联接在一起以创建复杂的逻辑比较。对于大多数用例而言，筛选器组并不是必需的。使用标签创建筛选器时，无论选择哪个连接词，Dynatrace 都将始终使用 AND。Dynatrace 不支持带标签的 OR 筛选器。
+ `Alias`：在使用 Dynatrace 数据来源时，您会遇到两种不同类型的别名。第一个是静态别名。您生成的每个查询都可以使用这种类型的别名，并且别名的名称以小写字母开头。第二个是动态别名，它会根据您在查询中使用的指标而变化，别名的名称以大写字母开头。Dynatrace 插件支持几个不同的别名：`Metric Names`、`Aggregation`、`Display Name`、`Host` 和 `Description`。
| Name | 值 |
| --- | --- |
| $name | 内置:apps.other.key UserActions.reportedErrorCount.os |
| $aggregation | auto,value |
| $displayName | 报告的错误数（按关键用户操作、操作系统划分）[移动、自定义] |
**问题查询类型**
+ `Problem Query Type`：选择问题查询类型。目前，仅支持源问题查询类型。有关源问题查询类型的信息，请参阅[合并转换](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)
+ `Status Filter`：按状态筛选结果问题。
+ `Impact Filter`：按影响级别筛选结果问题。
+ `Severity Filter`：按严重性级别筛选结果问题。
+ `Expand Details`：如果已设置，则在响应中包含相关事件。
#### 使用模板变量
要添加新的 Dynatrace 查询变量，请参阅[添加新的模板变量](variables-types.md#add-a-query-variable)。使用您的 Dynatrace 数据来源作为以下可用查询的数据来源：
+ `Query type`：选择查询类型。查询类型将某些数据与某个键或描述符相关联。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/dynatrace-AMG-datasource.html)
+ `Regex`：（可选）使用正则表达式筛选出查询中的任何返回值。
**注意**
`Multi-value` 和 `Include All option` 目前不受 Dynatrace 数据来源的支持。
创建变量后，您可以在**指标**下拉菜单中找到该变量。
##### 导入 Dynatrace 的控制面板
要导入控制面板，请参阅 [导入控制面板](dashboard-export-and-import.md#importing-a-dashboard)。导入的控制面板可在**配置** > **数据来源** > 选择您的 Dynatrace 数据来源 > 选择**控制面板**选项卡中找到，以查看可用的预制控制面板。