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

> DQL 쿼리, 문제 조사, 보안 취약점 검토, 엔티티 탐색을 위해 Dynatrace를 CloudThinker에 연결합니다

Dynatrace 환경을 연결하면 CloudThinker 에이전트가 DQL 쿼리 실행, 문제 조사, 보안 취약점 검토, 엔티티 및 소유권 컨텍스트 탐색, 옵저버빌리티 스택 전반의 노트북 및 대시보드 같은 문서 검사를 수행할 수 있습니다.

CloudThinker는 공식 Dynatrace MCP 서버를 통해 **Dynatrace Platform 토큰**과 **Dynatrace Platform 환경 URL**로 Dynatrace에 연결합니다.

***

## 사전 요구 사항

* CloudThinker가 조사할 로그, 이벤트, 스팬, 메트릭, 문제, 엔티티 또는 문서가 포함된 **Dynatrace Platform 환경**.
* `https://abc12345.apps.dynatrace.com` 형식의 **Dynatrace Platform 환경 URL**.
* CloudThinker에 필요한 읽기 스코프가 부여된 **Dynatrace Platform 토큰**.

<Info>
  CloudThinker는 `npx`로 Dynatrace MCP 서버를 실행하므로, 연결 양식에 Dynatrace 환경 URL과 Platform 토큰만 입력하면 됩니다.
</Info>

***

## 설정

<Steps>
  <Step title="Dynatrace 열기">
    Dynatrace Platform 환경에 로그인합니다. `https://<environment-id>.apps.dynatrace.com` 형식의 Platform URL을 사용합니다.
  </Step>

  <Step title="Platform 토큰 생성">
    CloudThinker 전용 Dynatrace **Platform 토큰**을 생성하고, 활성화할 워크플로에 필요한 [필수 권한](#필수-권한)의 스코프만 부여합니다.

    토큰은 즉시 복사하세요 — 이후에는 다시 표시되지 않을 수 있습니다.
  </Step>

  <Step title="CloudThinker에 연결 추가">
    **Connections → Dynatrace**로 이동하여 다음을 입력합니다.

    * **DT\_ENVIRONMENT**: Dynatrace Platform 환경 URL
    * **DT\_PLATFORM\_TOKEN**: 방금 생성한 Platform 토큰

    **Connect**를 클릭합니다. CloudThinker가 자격 증명을 검증하고 **Connected** 상태를 표시합니다.
  </Step>
</Steps>

<Warning>
  클래식 Dynatrace API 토큰이 아닌 Dynatrace **Platform 토큰**을 사용하세요. 클래식 API 토큰은 MCP 서버에 필요한 Platform 스코프를 제공하지 않습니다.
</Warning>

***

## 연결 세부 정보

| 필드                      | 설명                        | 예시                                    |
| ----------------------- | ------------------------- | ------------------------------------- |
| **DT\_ENVIRONMENT**     | Dynatrace Platform 환경 URL | `https://abc12345.apps.dynatrace.com` |
| **DT\_PLATFORM\_TOKEN** | Dynatrace Platform 토큰     | —                                     |

<Note>
  클래식 `live.dynatrace.com` URL이 아닌 Platform 환경 URL을 사용하세요. MCP 서버는 `DT_ENVIRONMENT`를 통해 Dynatrace Platform API 및 Grail 데이터에 접근합니다.
</Note>

***

## 필수 권한

CloudThinker 전용 Dynatrace **Platform 토큰**을 생성하고, 사용할 워크플로에 필요한 스코프만 부여합니다.

| 스코프                            | 활성화되는 기능                             |
| ------------------------------ | ------------------------------------ |
| `app-engine:apps:run`          | 대부분의 Dynatrace MCP 도구 실행             |
| `storage:buckets:read`         | Grail에 저장된 시스템 데이터 읽기 및 접근 가능한 버킷 탐색 |
| `storage:logs:read`            | DQL로 로그 쿼리                           |
| `storage:metrics:read`         | DQL로 메트릭 쿼리                          |
| `storage:bizevents:read`       | DQL로 비즈니스 이벤트 쿼리                     |
| `storage:spans:read`           | DQL로 트레이스 및 스팬 쿼리                    |
| `storage:entities:read`        | DQL로 모니터링 엔티티 쿼리                     |
| `storage:events:read`          | DQL로 이벤트 쿼리                          |
| `storage:security.events:read` | DQL로 보안 이벤트 쿼리                       |
| `storage:system:read`          | DQL로 시스템 데이터 쿼리                      |
| `storage:user.events:read`     | DQL로 사용자 이벤트 쿼리                      |
| `storage:user.sessions:read`   | DQL로 사용자 세션 쿼리                       |
| `storage:smartscape:read`      | DQL로 Smartscape 데이터 쿼리               |
| `storage:files:read`           | 조회 데이터를 위한 DQL `load` 문 사용           |
| `document:documents:read`      | 노트북, 대시보드, 런치패드 목록 조회 및 읽기           |
| `document:documents:write`     | 승인된 워크플로에서 문서 생성 (선택 사항)             |

<Tip>
  필요한 데이터 유형에 대한 읽기 스코프와 함께 `app-engine:apps:run`부터 시작하세요. `document:documents:write`는 에이전트가 Dynatrace 문서를 생성해야 하는 승인된 워크플로에만 추가하세요. 이전 MCP 서버 버전에서는 `app-engine:functions:run`, `settings:objects:read`, `environment-api:entities:read`도 필요했지만, 현재 버전에서는 이 스코프들이 더 이상 필요하지 않습니다.
</Tip>

***

## 에이전트 기능

연결 후 에이전트는 Platform 토큰이 허용하는 Dynatrace 옵저버빌리티 데이터에 접근할 수 있습니다.

| 기능                   | 설명                                                |
| -------------------- | ------------------------------------------------- |
| **DQL 실행**           | Grail 데이터에 대해 Dynatrace Query Language 쿼리 실행 및 검증 |
| **로그, 이벤트, 스팬, 메트릭** | 짧은 시간 범위와 집중 쿼리로 텔레메트리 조사                         |
| **문제 조사**            | Dynatrace 문제 조회 및 영향받는 서비스나 인프라 요약                |
| **보안 취약점**           | 토큰에 보안 문제 읽기 접근 권한이 포함된 경우 보고된 취약점 검토             |
| **엔티티 탐색**           | 영향받은 시스템의 모니터링 엔티티 및 소유권 컨텍스트 탐색                  |
| **문서**               | 문서 스코프가 부여된 경우 노트북 및 대시보드 검사                      |

### 연결 확인

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

### 예시 프롬프트

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

대규모 환경에서는 알려진 서비스, 엔티티, 버킷, 짧은 시간 범위로 요청 범위를 좁혀 DQL 쿼리가 집중적으로 실행되도록 하세요.

***

## 문제 해결

<Accordion title="잘못된 환경 URL">
  **DT\_ENVIRONMENT**가 `https://abc12345.apps.dynatrace.com` 형식의 Dynatrace Platform URL인지 확인하세요. 클래식 `live.dynatrace.com` URL은 이 연결에 유효하지 않습니다.
</Accordion>

<Accordion title="인증되지 않았거나 만료된 토큰">
  Platform 토큰이 누락되었거나, 만료되었거나, 취소되었거나, 잘못 복사되었습니다. 필요한 스코프로 새 Dynatrace Platform 토큰을 생성하고 다시 연결하세요.
</Accordion>

<Accordion title="권한 오류">
  토큰에 하나 이상의 필수 스코프가 누락되었습니다. DQL이 이벤트에는 작동하지만 로그에는 작동하지 않는 경우 `storage:logs:read`를 추가하세요. 대부분의 도구가 실패하는 경우 토큰에 `app-engine:apps:run`이 포함되어 있는지 확인하세요.
</Accordion>

<Accordion title="빈 DQL 결과">
  쿼리가 빈 버킷, 토큰이 읽을 수 없는 데이터 유형, 또는 일치하는 텔레메트리가 없는 시간 범위를 대상으로 할 수 있습니다. 알려진 서비스, 버킷, 또는 시간 범위를 대상으로 더 짧은 쿼리를 시도하세요.
</Accordion>

<Accordion title="크거나 느린 Grail 쿼리">
  범위가 없는 DQL 쿼리는 너무 많은 데이터를 반환하거나 너무 오래 걸릴 수 있습니다. 필터를 추가하고, 짧은 시간 범위를 사용하고, 에이전트에게 쿼리를 확장하기 전에 검증하도록 요청하세요.
</Accordion>

***

## 보안

* **최소 권한** — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
* **기본 읽기 전용** — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
* **자격증명 교체** — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
* **오프보딩 시 취소** — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.

- **Platform 토큰만 사용** — 클래식 API 토큰이 아닌 Dynatrace Platform 토큰을 사용하세요. 클래식 토큰은 MCP 서버에 필요한 스코프가 없습니다.
- **읽기 스코프로 시작** — 에이전트가 문서를 생성해야 하는 워크플로에만 `document:documents:write`를 부여하세요.

***

## 관련 항목

<CardGroup cols={2}>
  <Card title="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="/ko/guide/connections/datadog" width="24" height="24" data-path="images/icons/datadog.svg">
    로그, 메트릭, APM, 인시던트
  </Card>

  <Card title="New Relic 연결" icon="https://mintcdn.com/cloudthinker/wCGuHK6EQ4nmA6Df/images/icons/newrelic.svg?fit=max&auto=format&n=wCGuHK6EQ4nmA6Df&q=85&s=5c54d5df836916a27f3e0b7e6c8f8edb" href="/ko/guide/connections/newrelic" width="45" height="52" data-path="images/icons/newrelic.svg">
    APM, NRQL, 인프라, 알림
  </Card>
</CardGroup>