本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 连接 Dynatrace
<a name="connecting-telemetry-sources-connecting-dynatrace"></a>

## 内置、双向集成
<a name="built-in-2-way-integration"></a>

目前， AWS DevOps Agent 通过内置的双向集成支持 Dynatrace 用户，可实现以下功能：
+ **拓扑资源映射**- AWS DevOps 代理将使用您的 Dynatrace 环境中可用的实体和关系来增强您的 DevOps 代理空间拓扑。
+ **自动触发调查** ——可以将 Dynatrace 工作流程配置为触发事件解决方案 Dynatrace Problems 中的调查。
+ **遥测内省—— AWS DevOps 代理可以在通过代理托管的 Dynatrace MCP 服务器调查问题**时反省 Dynatrace 遥测数据。 AWS DevOps 
+ **状态更新**- AWS DevOps 代理将在 Dynatrace 用户界面上发布关键调查结果、根本原因分析和生成的缓解计划。

## 信息载入
<a name="onboarding"></a>

### 入职流程
<a name="onboarding-process"></a>

启动您的 Dynatrace 可观测性系统包括三个阶段：

1. **Connect**-通过配置账户访问凭证，与您可能需要的所有环境建立与 Dynatrace 的连接

1. **启用**-在具有特定 Dynatrace 环境的特定代理空间中激活 Dynatrace

1. **配置您的 Dynatrace 环境**-下载工作流程和仪表板并导入 Dynatrace，记下 webhook 的详细信息以便在指定的代理空间中触发调查

### 步骤 1：Connect
<a name="step-1-connect"></a>

与你的 Dynatrace 环境建立连接

#### 配置
<a name="configuration"></a>

1. 转到**能力提供者**页面（可从侧面导航栏访问）

1. **在 “**遥测**” 下的 “**可用**提供商” 部分中找到 **Dynatrac** e，然后单击 “注册”**

1. **在 Dynatrace 中创建具有详细权限的 OAuth 客户端。**

   1. 请参阅 [Dynatrac](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent) e 文档

   1. 准备就绪后，按下一步

   1. 您可以将多个 Dynatrace 环境连接起来，然后将范围连接到您可能拥有的每个 DevOps 代理空间的特定环境。

1. 在 OAuth 客户端设置中输入你的 Dynatrace 详细信息：
   + **客户名称**
   + **客户端 ID**
   + **客户机密钥**
   + **账号 URN**

1. 单击下一步

1. 查看并添加

### 步骤 2：启用
<a name="step-2-enable"></a>

在特定的代理空间中激活 Dynatrace 并配置适当的作用域

#### 配置
<a name="configuration"></a>

1. 在座席空间页面上，选择一个座席空间，然后按查看详情

1. 选择 “权能” 选项卡

1. 找到 “遥测” 部分，按添加

1. 你会注意到 Dynatrace 的状态为 “已注册”。单击 “添加” 将其添加到您的代理空间

1. Dynatrace 环境 ID-提供你想与该代理空间关联的 Dynatrace 环境 ID。 DevOps 

1. 输入一个或多个 Dynatrace 实体 IDs ——这些帮助 DevOps 代理发现你最重要的资源，例如服务或应用程序。**如果您不确定，可以按删除。**

1. 查看并按保存

1. 复制 Webhook 网址和 Webhook 密钥。要将这些凭证添加到 [Dynatrace，请参阅 Dynatrace 文档](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)。

### 第 3 步：配置你的 Dynatrace 环境
<a name="step-3-configure-your-dynatrace-environment"></a>

要完成 Dynatrace 设置，你需要在 Dynatrace 环境中执行某些设置步骤。按照 [Dynatrac](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent) e 文档中的说明进行操作。

#### 支持的事件架构
<a name="supported-event-schemas"></a>

AWS DevOps Agent 使用 webhook 支持来自 Dynatrace 的两种类型的事件。下面记录了支持的事件架构：

##### 事件事件
<a name="incident-event"></a>

事件事件用于触发调查。事件架构是：

```
{
    "event.id": string;
    "event.status": "ACTIVE" | "CLOSED";
    "event.status_transition": string;
    "event.description": string;
    "event.name": string;
    "event.category": "AVAILABILITY" | "ERROR" | "SLOWDOWN" | "RESOURCE_CONTENTION" | "CUSTOM_ALERT" | "MONITORING_UNAVAILABLE" | "INFO";
    "event.start"?: string;
    "affected_entity_ids"?: string[];
}
```

##### 缓解事件
<a name="mitigation-event"></a>

缓解事件用于触发生成缓解报告，以便调查后续步骤。事件架构是：

```
{
    "task_id": string;
    "task_version": number;
    "event.type": "mitigation_request";
}
```

## 移除
<a name="removal"></a>

遥测源在两个级别上连接，分别是代理空间级别和账户级别。要将其完全删除，必须先将其从所有使用它的代理空间中删除，然后才能将其取消注册。

### 步骤 1：从代理空间中移除
<a name="step-1-remove-from-agent-space"></a>

1. 在座席空间页面上，选择一个座席空间，然后按查看详情

1. 选择 “权能” 选项卡

1. 向下滚动到 “遥测” 部分

1. 选择 Dynatrace

1. 按移除

### 第 2 步：注销账号
<a name="step-2-deregister-from-account"></a>

1. 转到**能力提供者**页面（可从侧面导航栏访问）

1. 滚动到 “**当前注册**” 部分。

1. 检查代理空间计数是否为零（如果不是，请在其他代理空间中重复上述步骤 1）

1. 按 Dynatrace 旁边的 “取消注册”