> ## 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

> Ánh xạ trực quan các phụ thuộc hạ tầng cloud và truy vết incident về nguyên nhân gốc rễ bằng Topology Explorer

Topology Explorer hiển thị hạ tầng cloud và mối quan hệ dịch vụ của bạn dưới dạng bản đồ tương tác. Hãy để agent khám phá bản đồ từ các cloud API trực tiếp, nhập từ Infrastructure as Code hoặc xây dựng thủ công.

<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>

## Xây dựng bản đồ topology

<Tabs>
  <Tab title="Khám phá do agent dẫn dắt">
    Yêu cầu agent khám phá tài nguyên và mối quan hệ trực tiếp từ các tài khoản cloud đã kết nối. Bản đồ luôn đồng bộ khi hạ tầng của bạn thay đổi.

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

    Khám phá yêu cầu một [kết nối](/vi/guide/connections/overview) đang hoạt động cho mỗi nhà cung cấp bạn muốn ánh xạ.
  </Tab>

  <Tab title="Nhập từ IaC">
    Nhập topology từ Terraform state, CloudFormation stack template hoặc các file Pulumi state.

    <Steps>
      <Step title="Mở Topology Explorer">
        Đi đến **Infrastructure → Topology**.
      </Step>

      <Step title="Bắt đầu nhập">
        Chọn **New View → Import from IaC**.
      </Step>

      <Step title="Chọn định dạng nguồn">
        Chọn Terraform State, CloudFormation hoặc định dạng được hỗ trợ khác.
      </Step>

      <Step title="Upload hoặc kết nối">
        Upload file state, hoặc kết nối đến backend state từ xa.

        **Trạng thái thành công:** các tài nguyên đã nhập và mối quan hệ của chúng xuất hiện trên canvas.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Xây dựng thủ công">
    Xây dựng bản đồ thủ công khi bạn muốn một chế độ xem được quản lý — ví dụ: sơ đồ onboarding.

    <Steps>
      <Step title="Tạo một chế độ xem">
        Nhấp **New View** trong Topology Explorer.
      </Step>

      <Step title="Thêm tài nguyên">
        Kéo tài nguyên từ bảng bên trái lên canvas.
      </Step>

      <Step title="Vẽ kết nối">
        Nhấp và kéo giữa các tài nguyên để tạo mối quan hệ.
      </Step>

      <Step title="Lưu chế độ xem">
        Đặt tên và lưu chế độ xem topology của bạn.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Loại tài nguyên

Topology Explorer hỗ trợ tất cả loại tài nguyên cloud chính:

| Danh mục      | Tài nguyên                                  |
| ------------- | ------------------------------------------- |
| Tính toán     | EC2, Lambda, ECS, EKS, VM, Cloud Run        |
| Mạng          | VPC, load balancer, CloudFront, API Gateway |
| Cơ sở dữ liệu | RDS, Aurora, DynamoDB, Cloud SQL            |
| Lưu trữ       | S3, EFS, EBS, Cloud Storage                 |
| Bảo mật       | IAM role, security group, chứng chỉ ACM     |
| Kubernetes    | Cluster, deployment, service, pod           |

## Chế độ xem, bộ lọc và xuất

| Điều khiển             | Chức năng                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------- |
| Dropdown **Load View** | Mở chế độ xem topology đã lưu                                                       |
| Bảng tìm kiếm và lọc   | Tìm tài nguyên theo tên hoặc ID; lọc theo loại, thẻ hoặc metadata; hiện/ẩn danh mục |
| Chỉ báo **Synced**     | Hiển thị thời điểm topology được cập nhật lần cuối từ hạ tầng của bạn               |
| Xuất                   | Lưu chế độ xem dưới dạng PNG/SVG, PDF hoặc JSON, hoặc tạo liên kết chia sẻ          |

## Cách agent sử dụng topology

Mọi agent đều có thể đọc bản đồ topology và suy luận về các đường dẫn phụ thuộc:

| Agent                             | Cách sử dụng topology                                           |
| --------------------------------- | --------------------------------------------------------------- |
| [Alex](/vi/guide/agents/alex)     | Trực quan hóa tác động chi phí, đường dẫn tối ưu hóa tài nguyên |
| [Oliver](/vi/guide/agents/oliver) | Ánh xạ mức độ phơi nhiễm bảo mật, trực quan hóa tuân thủ        |
| [Tony](/vi/guide/agents/tony)     | Chuỗi phụ thuộc database, điểm nghẽn hiệu suất                  |
| [Kai](/vi/guide/agents/kai)       | Trực quan hóa service mesh, mối quan hệ pod                     |
| [Anna](/vi/guide/agents/anna)     | Phối hợp incident đa dịch vụ, đánh giá kiến trúc                |

## RCA dựa trên topology

Topology tăng tốc [phân tích nguyên nhân gốc rễ](/vi/guide/incident/root-cause-analysis) vì hầu hết các incident bắt nguồn từ một phụ thuộc, không phải từ dịch vụ đã cảnh báo. Đây là một ví dụ thực tế.

**Cảnh báo:** tỷ lệ thành công của checkout giảm xuống 60%. Log của checkout hiển thị các timeout rải rác, nhưng dịch vụ thanh toán, database và cache đều báo cáo bình thường.

1. Bắt đầu từ cảnh báo, không phải từ log. Căn giữa bản đồ trên dịch vụ cảnh báo với trạng thái sức khỏe được phủ lên:

   ```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="Topology hiển thị các phụ thuộc dịch vụ" width="3578" height="2010" data-path="images/infrastructure/topology-explorer.jpg" />
   </Frame>

2. Truy vết lên trên. Bản đồ hiển thị chuỗi phụ thuộc checkout service → payment gateway → external payment API — và node API bên ngoài được đánh dấu là bị suy giảm.

3. Xác nhận bằng metric và loại trừ các thay đổi gần đây trước khi hành động:

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

   Alex hiển thị các timeout tập trung trên cạnh gateway-to-external-API, không có deployment gần đây trên đường thanh toán — xác nhận nhà cung cấp bên thứ ba là nguồn gốc vấn đề.

4. Giải quyết và ghi lại. Chuyển sang nhà cung cấp thanh toán dự phòng, sau đó xuất ảnh chụp topology cho [hồ sơ incident](/vi/guide/incident/manual-logging) và postmortem.

### Đọc lỗi cascading

Khi nhiều dịch vụ cùng lúc gặp sự cố, chế độ xem dòng thời gian topology hiển thị nguồn gốc và thứ tự lan truyền trong một chế độ xem duy nhất, thay vì mỗi nhóm điều tra dịch vụ của mình. Trong cascade này, mọi sự cố downstream đều truy về một chứng chỉ SSL hết hạn:

| Thời gian | Dịch vụ         | Trạng thái | Nguyên nhân              |
| --------- | --------------- | ---------- | ------------------------ |
| 10:00:00  | Auth service    | Lỗi        | Chứng chỉ SSL hết hạn    |
| 10:00:05  | User service    | Lỗi        | Không thể xác thực token |
| 10:00:08  | Order service   | Lỗi        | Phụ thuộc Auth           |
| 10:00:10  | Payment service | Lỗi        | Phụ thuộc Auth           |
| 10:00:15  | Tất cả dịch vụ  | Lỗi        | Cascade hoàn tất         |

<Tip>
  Xây dựng topology và kết nối nguồn dữ liệu sức khỏe trước khi xảy ra incident. Một bản đồ được xây dựng sẵn và đồng bộ là điều làm cho bước đầu tiên mất vài giây thay vì vài phút.
</Tip>

## Các câu hỏi khác có thể hỏi

* `@alex show downstream dependencies of payment-service` — kiểm tra phạm vi ảnh hưởng trước một thay đổi rủi ro
* `@oliver map all connections from instance i-0abc123` — xác định phạm vi bảo mật trong quá trình điều tra
* `@tony map every service connecting to the production database` — tìm nguồn gây cạn kiệt kết nối
* `@kai show service dependencies and single points of failure in the cluster` — củng cố độ tin cậy Kubernetes
* `@alex compare the production topology with the DR region and list missing resources` — xác thực vùng phủ sóng khắc phục thảm họa

## Liên quan

<CardGroup cols={2}>
  <Card title="Resources" icon="cubes" href="/vi/guide/infrastructure/resources">
    Xem tất cả tài nguyên hạ tầng đã khám phá
  </Card>

  <Card title="Phân tích nguyên nhân gốc rễ" icon="magnifying-glass-chart" href="/vi/guide/incident/root-cause-analysis">
    Chạy RCA do agent dẫn dắt trên các incident
  </Card>

  <Card title="Assessment" icon="clipboard-check" href="/vi/guide/infrastructure/assessment">
    Chạy đánh giá hạ tầng
  </Card>
</CardGroup>