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

# Dynatrace

> Kết nối Dynatrace với CloudThinker để chạy truy vấn DQL, điều tra sự cố, xem xét lỗ hổng bảo mật và khám phá thực thể

Kết nối môi trường Dynatrace của bạn để cho phép các agent CloudThinker chạy truy vấn DQL, điều tra sự cố, xem xét lỗ hổng bảo mật, khám phá thực thể và ngữ cảnh sở hữu, cũng như kiểm tra các tài liệu như notebook và dashboard trên toàn bộ stack quan sát của bạn.

CloudThinker kết nối với Dynatrace thông qua Dynatrace MCP server chính thức bằng **Dynatrace Platform token** và **URL môi trường Dynatrace Platform** của bạn.

***

## Điều kiện tiên quyết

* Một **môi trường Dynatrace Platform** chứa log, sự kiện, span, số liệu, sự cố, thực thể hoặc tài liệu mà bạn muốn CloudThinker điều tra.
* **URL môi trường Dynatrace Platform** của bạn, ví dụ `https://abc12345.apps.dynatrace.com`.
* Một **Dynatrace Platform token** với các phạm vi đọc mà CloudThinker cần.

<Info>
  CloudThinker chạy Dynatrace MCP server bằng `npx`, vì vậy bạn chỉ cần cung cấp URL môi trường Dynatrace và Platform token trong biểu mẫu kết nối.
</Info>

***

## Thiết lập

<Steps>
  <Step title="Mở Dynatrace">
    Đăng nhập vào môi trường Dynatrace Platform của bạn. Sử dụng Platform URL theo định dạng `https://<environment-id>.apps.dynatrace.com`.
  </Step>

  <Step title="Tạo Platform token">
    Tạo một Dynatrace **Platform token** riêng dành cho CloudThinker và chỉ cấp các phạm vi được liệt kê trong [Quyền yêu cầu](#quyền-yêu-cầu) cho các luồng công việc bạn muốn kích hoạt.

    Sao chép token ngay lập tức — token có thể không hiển thị lại.
  </Step>

  <Step title="Thêm kết nối trong CloudThinker">
    Điều hướng đến **Connections → Dynatrace** và nhập:

    * **DT\_ENVIRONMENT**: URL môi trường Dynatrace Platform của bạn
    * **DT\_PLATFORM\_TOKEN**: Platform token vừa tạo

    Nhấn **Connect**. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái **Connected**.
  </Step>
</Steps>

<Warning>
  Sử dụng Dynatrace **Platform token**, không phải classic Dynatrace API token. Classic API token không cung cấp các phạm vi Platform mà MCP server yêu cầu.
</Warning>

***

## Chi tiết kết nối

| Trường                  | Mô tả                             | Ví dụ                                 |
| ----------------------- | --------------------------------- | ------------------------------------- |
| **DT\_ENVIRONMENT**     | URL môi trường Dynatrace Platform | `https://abc12345.apps.dynatrace.com` |
| **DT\_PLATFORM\_TOKEN** | Dynatrace Platform token          | —                                     |

<Note>
  Sử dụng URL môi trường Platform, không phải URL `live.dynatrace.com` dạng classic. MCP server dùng `DT_ENVIRONMENT` để kết nối Dynatrace Platform API và dữ liệu Grail.
</Note>

***

## Quyền yêu cầu

Tạo một Dynatrace **Platform token** riêng và chỉ cấp các phạm vi cần thiết cho các luồng công việc CloudThinker bạn dự định sử dụng.

| Phạm vi                        | Chức năng                                                                  |
| ------------------------------ | -------------------------------------------------------------------------- |
| `app-engine:apps:run`          | Chạy hầu hết các công cụ Dynatrace MCP                                     |
| `storage:buckets:read`         | Đọc dữ liệu hệ thống lưu trên Grail và khám phá các bucket có thể truy cập |
| `storage:logs:read`            | Truy vấn log qua DQL                                                       |
| `storage:metrics:read`         | Truy vấn số liệu qua DQL                                                   |
| `storage:bizevents:read`       | Truy vấn sự kiện kinh doanh qua DQL                                        |
| `storage:spans:read`           | Truy vấn trace và span qua DQL                                             |
| `storage:entities:read`        | Truy vấn các thực thể được giám sát qua DQL                                |
| `storage:events:read`          | Truy vấn sự kiện qua DQL                                                   |
| `storage:security.events:read` | Truy vấn sự kiện bảo mật qua DQL                                           |
| `storage:system:read`          | Truy vấn dữ liệu hệ thống qua DQL                                          |
| `storage:user.events:read`     | Truy vấn sự kiện người dùng qua DQL                                        |
| `storage:user.sessions:read`   | Truy vấn phiên người dùng qua DQL                                          |
| `storage:smartscape:read`      | Truy vấn dữ liệu Smartscape qua DQL                                        |
| `storage:files:read`           | Sử dụng lệnh `load` trong DQL để tra cứu dữ liệu                           |
| `document:documents:read`      | Liệt kê và đọc notebook, dashboard và launchpad                            |
| `document:documents:write`     | Tạo tài liệu cho các luồng công việc đã được phê duyệt (tùy chọn)          |

<Tip>
  Bắt đầu với `app-engine:apps:run` cộng các phạm vi đọc cho các loại dữ liệu bạn cần. Chỉ thêm `document:documents:write` cho các luồng công việc đã phê duyệt cần agent tạo tài liệu Dynatrace. Các phiên bản MCP server cũ hơn cũng yêu cầu `app-engine:functions:run`, `settings:objects:read` và `environment-api:entities:read` — các phiên bản hiện tại không còn cần các phạm vi đó nữa.
</Tip>

***

## Khả năng của agent

Sau khi kết nối, các agent có quyền truy cập vào dữ liệu quan sát Dynatrace được cho phép bởi Platform token.

| Khả năng                          | Mô tả                                                                                |
| --------------------------------- | ------------------------------------------------------------------------------------ |
| **Thực thi DQL**                  | Chạy và xác thực các truy vấn Dynatrace Query Language đối với dữ liệu Grail         |
| **Log, sự kiện, span và số liệu** | Điều tra telemetry trong các cửa sổ thời gian ngắn và truy vấn tập trung             |
| **Điều tra sự cố**                | Lấy các sự cố Dynatrace và tóm tắt các dịch vụ hoặc cơ sở hạ tầng bị ảnh hưởng       |
| **Lỗ hổng bảo mật**               | Xem xét các lỗ hổng được báo cáo khi token bao gồm quyền đọc sự cố bảo mật           |
| **Khám phá thực thể**             | Khám phá các thực thể được giám sát và ngữ cảnh sở hữu cho các hệ thống bị ảnh hưởng |
| **Tài liệu**                      | Kiểm tra notebook và dashboard khi các phạm vi tài liệu được cấp                     |

### Xác minh kết nối

```text theme={null}
@alex run Dynatrace discovery and list active problems and monitored entity count
```

### Ví dụ lệnh

```text theme={null}
@alex investigate current Dynatrace problems affecting production and summarize impacted entities
@alex run a Dynatrace DQL query for error logs from the checkout service over the last 30 minutes
@oliver check Dynatrace security vulnerabilities affecting internet-facing services
```

Với môi trường lớn, hãy giới hạn yêu cầu bằng tên dịch vụ, thực thể, bucket đã biết và cửa sổ thời gian ngắn để các truy vấn DQL luôn tập trung.

***

## Khắc phục sự cố

<Accordion title="URL môi trường không hợp lệ">
  Đảm bảo **DT\_ENVIRONMENT** là URL Dynatrace Platform, chẳng hạn `https://abc12345.apps.dynatrace.com`. URL dạng `live.dynatrace.com` classic không hợp lệ cho kết nối này.
</Accordion>

<Accordion title="Token không hợp lệ hoặc đã hết hạn">
  Platform token bị thiếu, hết hạn, bị thu hồi hoặc sao chép không chính xác. Tạo một Dynatrace Platform token mới với các phạm vi yêu cầu và kết nối lại.
</Accordion>

<Accordion title="Lỗi quyền truy cập">
  Token thiếu một hoặc nhiều phạm vi yêu cầu. Nếu DQL hoạt động cho sự kiện nhưng không hoạt động cho log, hãy thêm `storage:logs:read`. Nếu hầu hết các công cụ đều thất bại, hãy xác nhận token bao gồm `app-engine:apps:run`.
</Accordion>

<Accordion title="Kết quả DQL trống">
  Truy vấn có thể nhắm đến bucket trống, loại dữ liệu mà token không thể đọc, hoặc khoảng thời gian không có telemetry phù hợp. Hãy thử một truy vấn ngắn đã biết đối với một dịch vụ, bucket hoặc khung thời gian đã biết.
</Accordion>

<Accordion title="Truy vấn Grail chậm hoặc quá lớn">
  Các truy vấn DQL không giới hạn có thể trả về quá nhiều dữ liệu hoặc mất quá nhiều thời gian. Thêm bộ lọc, sử dụng cửa sổ thời gian ngắn và yêu cầu agent xác thực truy vấn trước khi mở rộng.
</Accordion>

***

## Bảo mật

* **Quyền tối thiểu** — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
* **Chỉ đọc theo mặc định** — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
* **Xoay vòng thông tin xác thực** — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
* **Thu hồi khi bàn giao** — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

- **Chỉ dùng Platform token** — sử dụng Dynatrace Platform token, không phải classic API token; classic token thiếu các phạm vi mà MCP server yêu cầu.
- **Bắt đầu với phạm vi đọc** — chỉ cấp `document:documents:write` cho các luồng công việc cần agent tạo tài liệu.

***

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối Datadog" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48" href="/vi/guide/connections/datadog" width="24" height="24" data-path="images/icons/datadog.svg">
    Log, số liệu, APM và sự cố
  </Card>

  <Card title="Kết nối New Relic" icon="https://mintcdn.com/cloudthinker/wCGuHK6EQ4nmA6Df/images/icons/newrelic.svg?fit=max&auto=format&n=wCGuHK6EQ4nmA6Df&q=85&s=5c54d5df836916a27f3e0b7e6c8f8edb" href="/vi/guide/connections/newrelic" width="45" height="52" data-path="images/icons/newrelic.svg">
    APM, NRQL, cơ sở hạ tầng và cảnh báo
  </Card>
</CardGroup>