翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

## 組み込みの双方向統合
<a name="built-in-2-way-integration"></a>

現在、 AWS DevOps Agent は、以下を可能にする 2 方向統合が組み込まれた Dynatrace ユーザーをサポートしています。
+ **トポロジーリソースマッピング** - AWS DevOps Agent は、Dynatrace 環境から利用可能なエンティティと関係で DevOps Agent Space Topology を強化します。
+ **自動調査トリガー** - Dynatrace ワークフローは、Dynatrace 問題からインシデント解決調査をトリガーするように設定できます。
+ **テレメトリのイントロスペクション** - AWS DevOps Agent は、 AWS DevOps Agent がホストする Dynatrace MCP サーバーを介して問題を調査する際に、Dynatrace テレメトリをイントロスペクションできます。
+ **ステータスの更新** - AWS DevOps Agent は、主要な調査結果、根本原因分析、生成された緩和計画を Dynatrace ユーザーインターフェイスに発行します。

## オンボーディング
<a name="onboarding"></a>

### オンボーディングプロセス
<a name="onboarding-process"></a>

Dynatrace オブザーバビリティシステムのオンボーディングには、次の 3 つの段階があります。

1. **Connect** - アカウントアクセス認証情報を設定し、必要なすべての環境を使用して Dynatrace への接続を確立します。

1. **有効** - 特定の Dynatrace 環境を持つ特定のエージェントスペースで Dynatrace をアクティブ化する

1. **Dynatrace 環境を設定する** - ワークフローとダッシュボードをダウンロードして Dynatrace にインポートし、ウェブフックの詳細を書き留めて、指定されたエージェントスペースで調査をトリガーします。

### ステップ 1: 接続する
<a name="step-1-connect"></a>

Dynatrace 環境への接続を確立する

#### 設定
<a name="configuration"></a>

1. **機能プロバイダー**ページに移動する (サイドナビゲーションからアクセス可能)

1. Telemetry の**「利用可能な**プロバイダー」セクションで **Dynatrace** を検索し、**Register** をクリックします。 ****

1. **詳細なアクセス許可を使用して、Dynatrace で OAuth クライアントを作成します。**

   1. [「Dynatrace ドキュメント](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)」を参照してください。

   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. Telemetry セクションを見つけ、Add キーを押します。

1. Dynatrace のステータスが「登録済み」であることがわかります。add をクリックして、これをエージェントスペースに追加します。

1. Dynatrace 環境 ID - この DevOps エージェントスペースに関連付ける Dynatrace 環境 ID を指定します。

1. 1 つ以上の Dynatrace エンティティ IDs を入力します。これは、DevOps エージェントが最も重要なリソースを検出するのに役立ちます。例としては、サービスやアプリケーションなどがあります。**不明な場合は、削除を押します。**

1. 確認して保存を押します

1. Webhook URL と Webhook Secret をコピーします。これらの認証情報を [Dynatrace に追加するには、Dynatrace のドキュメント](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)を参照してください。

### ステップ 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 は、ウェブフックを使用した Dynatrace からの 2 種類のイベントをサポートします。サポートされているイベントスキーマを以下に示します。

##### インシデントイベント
<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>

テレメトリソースは、エージェントスペースレベルとアカウントレベルで 2 つのレベルで接続されます。これを完全に削除するには、まずそれを使用するすべてのエージェントスペースから削除してから、登録を解除する必要があります。

### ステップ 1: エージェントスペースから削除する
<a name="step-1-remove-from-agent-space"></a>

1. エージェントスペースページからエージェントスペースを選択し、詳細の表示を押します。

1. 機能タブを選択する

1. Telemetry セクションまで下にスクロールします。

1. Dynatrace を選択する

1. 削除を押す

### ステップ 2: アカウントから登録解除する
<a name="step-2-deregister-from-account"></a>

1. **機能プロバイダー**ページに移動する (サイドナビゲーションからアクセス可能)

1. **現在登録**されているセクションまでスクロールします。

1. エージェントスペース数がゼロであることを確認します (他のエージェントスペースで上記のステップ 1 を繰り返しない場合）。

1. Dynatrace の横にある登録解除を押します