Dynatrace の接続

組み込みの双方向統合

現在、 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 ユーザーインターフェイスに発行します。

前提条件

AWS DevOps エージェントと Dynatrace の統合には、Dynatrace SaaS が必要です。統合は、Dynatrace SaaS 環境でのみ利用可能な Dynatrace プラットフォーム機能 (ワークフロー、SRE エージェントアプリを含む AppEngine アプリ、OAuth クライアント) によって異なります。

Dynatrace Managed (オンプレミス) はサポートされておらず、Dynatrace はこれらのプラットフォーム機能を Managed に持ち込む予定はありません。Dynatrace Managed を実行している場合は、 AWS DevOps エージェントに接続する前に Dynatrace SaaS にアップグレードする必要があります。「Dynatrace Managed から SaaS へのアップグレード」を参照してください。

オンボーディング

オンボーディングプロセス

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

Connect - アカウントアクセス認証情報を設定し、必要なすべての環境を使用して Dynatrace への接続を確立します。
有効 - 特定の Dynatrace 環境を持つ特定のエージェントスペースで Dynatrace をアクティブ化する
Dynatrace 環境を設定する - Dynatrace SRE エージェントアプリを使用して、2 回のクリックで接続を完了します。

ステップ 1: 接続する

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

設定

機能プロバイダーページに移動する (サイドナビゲーションからアクセス可能)
Telemetry の「利用可能なプロバイダー」セクションで Dynatrace を検索し、Register をクリックします。
詳細なアクセス許可を使用して、Dynatrace で OAuth クライアントを作成します。
1. 「Dynatrace ドキュメント」を参照してください。
2. 準備ができたら、次へを押します
3. 複数の Dynatrace 環境とそれ以降のスコープを、DevOps エージェントスペースごとに特定の環境に接続できます。
OAuth クライアント設定から Dynatrace の詳細を入力します。
- クライアント名
- クライアント ID
- クライアントシークレット
- アカウント URN
[次へ] をクリックします。
確認して追加する

ステップ 2: を有効にする

特定のエージェントスペースで Dynatrace をアクティブ化し、適切なスコープを設定する

設定

エージェントスペースページからエージェントスペースを選択し、詳細の表示を押します。
機能タブを選択する
Telemetry セクションを見つけ、Add キーを押します。
Dynatrace のステータスが「登録済み」であることがわかります。add をクリックして、これをエージェントスペースに追加します。
Dynatrace 環境 ID - この DevOps エージェントスペースに関連付ける Dynatrace 環境 ID を指定します。
1 つ以上の Dynatrace エンティティ IDs を入力します。これらは、DevOps エージェントが最も重要なリソースを検出するのに役立ちます。例としては、サービスやアプリケーションなどがあります。不明な場合は、削除を押します。
確認して保存を押します
Webhook URL と Webhook Secret をコピーします。Dynatrace SRE Agents アプリでこれらを使用して接続を完了します。詳細については、「開始方法」セクションを参照してください。

ステップ 3: Dynatrace 環境を設定する

Dynatrace のセットアップを完了するには、Dynatrace SRE エージェントアプリを使用して、統合の Dynatrace 側を 2 回クリックで設定します。手動ワークフローのセットアップは必要ありません。詳細については、「開始方法」セクションを参照してください。

サポートされているイベントスキーマ

AWS DevOps Agent は、ウェブフックを使用した Dynatrace からの 2 種類のイベントをサポートします。サポートされているイベントスキーマを以下に示します。

インシデントイベント

インシデントイベントは、調査をトリガーするために使用されます。イベントスキーマは次のとおりです。


{
    "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[];
}

緩和イベント

緩和イベントは、次のステップの調査の緩和レポートの生成をトリガーするために使用されます。イベントスキーマは次のとおりです。


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

削除

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

ステップ 1: エージェントスペースから削除する

エージェントスペースページからエージェントスペースを選択し、詳細の表示を押します。
機能タブを選択する
Telemetry セクションまで下にスクロールします。
Dynatrace を選択する
削除を押す

ステップ 2: アカウントから登録を解除する

機能プロバイダーページに移動する (サイドナビゲーションからアクセス可能)
現在登録されているセクションまでスクロールします。
エージェントスペース数がゼロであることを確認します (他のエージェントスペースで上記のステップ 1 を繰り返しない場合）。
Dynatrace の横にある登録解除を押します

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

テレメトリソースの接続

DataDog の接続