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

# 連接 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 問題的事件解決調查。
+ **遙測自我檢查** - AWS DevOps 代理程式可以透過 AWS DevOps 代理程式託管的 Dynatrace MCP 伺服器調查問題時，可以自我檢查 Dynatrace 遙測。
+ **狀態更新** - AWS DevOps 代理程式會將金鑰調查結果、根本原因分析和產生的緩解計畫發佈至 Dynatrace 使用者介面。

## 上線
<a name="onboarding"></a>

### 加入程序
<a name="onboarding-process"></a>

加入您的 Dynatrace 可觀測性系統包含三個階段：

1. **Connect** - 透過設定帳戶存取登入資料與您可能需要的所有環境來建立與 Dynatrace 的連線

1. **啟用** - 在具有特定 Dynatrace 環境的特定代理程式空間中啟用 Dynatrace

1. **設定您的 Dynatrace 環境** - 下載工作流程和儀表板，並匯入 Dynatrace，記下 Webhook 詳細資訊，以觸發指定客服人員空間中的調查

### 步驟 1：連線
<a name="step-1-connect"></a>

建立與 Dynatrace 環境的連線

#### Configuration
<a name="configuration"></a>

1. 前往**能力提供者頁面 **（可從側邊導覽存取）

1. 在**遙測**下的**可用**提供者區段中尋找 **Dynatrace**，然後按一下**註冊**

1. **在 Dynatrace 中建立具有詳細許可的 OAuth 用戶端。**

   1. 請參閱 [Dynatrace 文件](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)

   1. 準備就緒後，按下一步

   1. 您可以針對您可能擁有的每個 DevOps Agent 空間，將多個 Dynatrace 環境和更新範圍連接到特定環境。

1. 從 OAuth 用戶端設定輸入您的 Dynatrace 詳細資訊：
   + **用戶端名稱**
   + **用戶端 ID**
   + **用戶端秘密**
   + **帳戶 URN**

1. 按一下下一步

1. 檢閱並新增

### 步驟 2：啟用
<a name="step-2-enable"></a>

在特定客服人員空間中啟用 Dynatrace，並設定適當的範圍

#### Configuration
<a name="configuration"></a>

1. 從客服人員空間頁面，選取客服人員空間並按下檢視詳細資訊

1. 選取功能索引標籤

1. 找到遙測區段，按下新增

1. 您會注意到 Dynatrace 狀態為「已註冊」。按一下新增以將此新增至您的客服人員空間

1. Dynatrace 環境 ID - 提供您要與此 DevOps 代理程式空間建立關聯的 Dynatrace 環境 ID。

1. 輸入一或多個 Dynatrace IDs - 這些可協助 DevOps 代理程式探索您最重要的資源，範例可能是服務或應用程式。**如果您不確定可以按移除。**

1. 檢閱並按下儲存

1. 複製 Webhook URL 和 Webhook 秘密。請參閱 [Dynatrace 文件](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)，將這些登入資料新增至 Dynatrace。

### 步驟 3：設定您的 Dynatrace 環境
<a name="step-3-configure-your-dynatrace-environment"></a>

若要完成 Dynatrace 設定，您需要在 Dynatrace 環境中執行特定設定步驟。遵循 [Dynatrace 文件](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)中的指示。

#### 支援的事件結構描述
<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 旁的取消註冊