> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Topology

> Topology Explorerでクラウドインフラの依存関係をビジュアルにマッピングし、インシデントをRoot Causeまで遡ります

Topology Explorerはクラウドインフラとサービスの関係をインタラクティブなマップとして表示します。エージェントによるライブクラウドAPIからのマップ検出、Infrastructure as Codeからのインポート、または手動構築が可能です。

<Frame>
  <img src="https://mintcdn.com/cloudthinker/M-utUm-TaqDSbEEK/images/infrastructure/topology-explorer.jpg?fit=max&auto=format&n=M-utUm-TaqDSbEEK&q=85&s=b931c4d83fd7741964ff90dca6583bcc" alt="Topology Explorer" width="3578" height="2010" data-path="images/infrastructure/topology-explorer.jpg" />
</Frame>

## トポロジーマップの構築

<Tabs>
  <Tab title="エージェント主導の検出">
    接続されたクラウドアカウントから直接リソースと関係を検出するようエージェントに依頼します。インフラが変更されるとマップが同期されます。

    ```text theme={null}
    @alex discover and map the infrastructure topology for the production AWS account
    @kai map Kubernetes service dependencies in the main cluster
    ```

    検出には、マッピングしたい各プロバイダーのアクティブな[接続](/ja/guide/connections/overview)が必要です。
  </Tab>

  <Tab title="IaCからのインポート">
    TerraformステートファイルやCloudFormationスタックテンプレート、Pulumiステートファイルからトポロジーをインポートします。

    <Steps>
      <Step title="Topology Explorerを開く">
        **Infrastructure → Topology** に移動します。
      </Step>

      <Step title="インポートを開始する">
        **New View → Import from IaC** を選択します。
      </Step>

      <Step title="ソース形式を選択する">
        Terraform State・CloudFormation・その他サポートされている形式を選択します。
      </Step>

      <Step title="アップロードまたは接続する">
        ステートファイルをアップロードするか、リモートステートバックエンドに接続します。

        **成功状態：** インポートされたリソースとその関係がキャンバスに表示されます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="手動ビルダー">
    オンボーディング図など、厳選されたビューが必要な場合は手動でマップを構築します。

    <Steps>
      <Step title="ビューを作成する">
        Topology Explorerで **New View** をクリックします。
      </Step>

      <Step title="リソースを追加する">
        左パネルからキャンバスにリソースをドラッグします。
      </Step>

      <Step title="接続を描く">
        リソース間をクリック＆ドラッグして関係を作成します。
      </Step>

      <Step title="ビューを保存する">
        トポロジービューに名前を付けて保存します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## リソースタイプ

Topology Explorerはすべての主要なクラウドリソースタイプをサポートしています：

| カテゴリ       | リソース                                |
| ---------- | ----------------------------------- |
| コンピュート     | EC2、Lambda、ECS、EKS、VM、Cloud Run     |
| ネットワーキング   | VPC、ロードバランサー、CloudFront、API Gateway |
| データベース     | RDS、Aurora、DynamoDB、Cloud SQL       |
| ストレージ      | S3、EFS、EBS、Cloud Storage            |
| セキュリティ     | IAMロール、セキュリティグループ、ACM証明書            |
| Kubernetes | クラスター、デプロイメント、サービス、ポッド              |

## ビュー・フィルター・エクスポート

| コントロール                | 機能                                               |
| --------------------- | ------------------------------------------------ |
| **Load View** ドロップダウン | 保存済みトポロジービューを開く                                  |
| 検索・フィルターパネル           | 名前またはIDでリソースを検索、タイプ・タグ・メタデータでフィルタリング、カテゴリの表示/非表示 |
| **Synced** インジケーター    | トポロジーがインフラから最後に更新された時刻を表示                        |
| エクスポート                | ビューをPNG/SVG・PDF・JSONとして保存、または共有リンクを生成            |

## エージェントによるトポロジーの活用

すべてのエージェントがトポロジーマップを読み取り、依存パスを推論できます：

| エージェント                            | トポロジーの活用                     |
| --------------------------------- | ---------------------------- |
| [Alex](/ja/guide/agents/alex)     | コストへの影響の可視化、リソース最適化パス        |
| [Oliver](/ja/guide/agents/oliver) | セキュリティ露出のマッピング、コンプライアンスの可視化  |
| [Tony](/ja/guide/agents/tony)     | データベース依存チェーン、パフォーマンスボトルネック   |
| [Kai](/ja/guide/agents/kai)       | サービスメッシュの可視化、ポッドの関係          |
| [Anna](/ja/guide/agents/anna)     | クロスサービスのインシデント調整、アーキテクチャレビュー |

## トポロジー主導のRCA

ほとんどのインシデントはアラートを発したサービスではなく、依存関係で発生するため、トポロジーは[Root Cause分析](/ja/guide/incident/root-cause-analysis)を加速します。以下は実例です。

**アラート：** チェックアウトの成功率が60%に低下。チェックアウトのログには断続的なタイムアウトが見られますが、決済サービス・データベース・キャッシュはすべて正常と報告しています。

1. ログからではなく、アラートから始めます。健全性オーバーレイを付けてアラートが発したサービスをマップの中心に：

   ```text theme={null}
   @alex show the topology centered on checkout-service with health status overlaid
   ```

   <Frame>
     <img src="https://mintcdn.com/cloudthinker/M-utUm-TaqDSbEEK/images/infrastructure/topology-explorer.jpg?fit=max&auto=format&n=M-utUm-TaqDSbEEK&q=85&s=b931c4d83fd7741964ff90dca6583bcc" alt="サービスの依存関係を示すトポロジー" width="3578" height="2010" data-path="images/infrastructure/topology-explorer.jpg" />
   </Frame>

2. 上流を追跡します。マップはチェックアウトサービス → 決済ゲートウェイ → 外部決済APIの依存チェーンを示し、外部APIノードが低下と表示されています。

3. メトリクスで確認し、最近の変更を排除してから対応します：

   ```text theme={null}
   @alex overlay latency and error-rate metrics on this topology view
   @alex show topology changes in the last 24 hours
   ```

   Alexはゲートウェイから外部APIへのエッジにタイムアウトが集中していることを示し、決済パスに最近のデプロイがないことを確認—サードパーティプロバイダーが原因と特定します。

4. 解決と記録。バックアップ決済プロバイダーにフェイルオーバーし、[インシデントレコード](/ja/guide/incident/manual-logging)とポストモーテム用にトポロジースナップショットをエクスポートします。

### カスケード障害の読み取り

複数のサービスが同時に障害を起こした場合、トポロジーのタイムラインビューは、各チームが独自のサービスを調査する代わりに、単一ビューで起源と伝播順序を示します。このカスケードでは、すべての下流の障害が1つの期限切れSSL証明書に遡ります：

| 時刻       | サービス     | ステータス | 原因          |
| -------- | -------- | ----- | ----------- |
| 10:00:00 | 認証サービス   | 障害    | SSL証明書の期限切れ |
| 10:00:05 | ユーザーサービス | 障害    | トークン検証不可    |
| 10:00:08 | 注文サービス   | 障害    | 認証依存        |
| 10:00:10 | 決済サービス   | 障害    | 認証依存        |
| 10:00:15 | 全サービス    | 障害    | カスケード完了     |

<Tip>
  インシデント前にトポロジーを構築し、ヘルスデータソースを接続してください。事前に構築・同期されたマップがあれば、最初のステップが数分ではなく数秒で完了します。
</Tip>

## 活用例

* `@alex show downstream dependencies of payment-service` — リスクのある変更前に影響範囲を確認する
* `@oliver map all connections from instance i-0abc123` — 調査中のセキュリティ露出のスコープを確認する
* `@tony map every service connecting to the production database` — 接続枯渇の原因を特定する
* `@kai show service dependencies and single points of failure in the cluster` — Kubernetesの信頼性を強化する
* `@alex compare the production topology with the DR region and list missing resources` — ディザスタリカバリのカバレッジを検証する

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="Resources" icon="cubes" href="/ja/guide/infrastructure/resources">
    検出済みのすべてのインフラリソースを確認する
  </Card>

  <Card title="Root cause analysis" icon="magnifying-glass-chart" href="/ja/guide/incident/root-cause-analysis">
    エージェント主導のRCAをインシデントに対して実行する
  </Card>

  <Card title="Assessment" icon="clipboard-check" href="/ja/guide/infrastructure/assessment">
    インフラアセスメントを実行する
  </Card>
</CardGroup>