사전 요구 사항
- CloudThinker가 조사할 로그, 이벤트, 스팬, 메트릭, 문제, 엔티티 또는 문서가 포함된 Dynatrace Platform 환경.
https://abc12345.apps.dynatrace.com형식의 Dynatrace Platform 환경 URL.- CloudThinker에 필요한 읽기 스코프가 부여된 Dynatrace Platform 토큰.
CloudThinker는
npx로 Dynatrace MCP 서버를 실행하므로, 연결 양식에 Dynatrace 환경 URL과 Platform 토큰만 입력하면 됩니다.설정
Dynatrace 열기
Dynatrace Platform 환경에 로그인합니다.
https://<environment-id>.apps.dynatrace.com 형식의 Platform URL을 사용합니다.Platform 토큰 생성
CloudThinker 전용 Dynatrace Platform 토큰을 생성하고, 활성화할 워크플로에 필요한 필수 권한의 스코프만 부여합니다.토큰은 즉시 복사하세요 — 이후에는 다시 표시되지 않을 수 있습니다.
연결 세부 정보
| 필드 | 설명 | 예시 |
|---|---|---|
| DT_ENVIRONMENT | Dynatrace Platform 환경 URL | https://abc12345.apps.dynatrace.com |
| DT_PLATFORM_TOKEN | Dynatrace Platform 토큰 | — |
클래식
live.dynatrace.com URL이 아닌 Platform 환경 URL을 사용하세요. MCP 서버는 DT_ENVIRONMENT를 통해 Dynatrace Platform API 및 Grail 데이터에 접근합니다.필수 권한
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 | 승인된 워크플로에서 문서 생성 (선택 사항) |
에이전트 기능
연결 후 에이전트는 Platform 토큰이 허용하는 Dynatrace 옵저버빌리티 데이터에 접근할 수 있습니다.| 기능 | 설명 |
|---|---|
| DQL 실행 | Grail 데이터에 대해 Dynatrace Query Language 쿼리 실행 및 검증 |
| 로그, 이벤트, 스팬, 메트릭 | 짧은 시간 범위와 집중 쿼리로 텔레메트리 조사 |
| 문제 조사 | Dynatrace 문제 조회 및 영향받는 서비스나 인프라 요약 |
| 보안 취약점 | 토큰에 보안 문제 읽기 접근 권한이 포함된 경우 보고된 취약점 검토 |
| 엔티티 탐색 | 영향받은 시스템의 모니터링 엔티티 및 소유권 컨텍스트 탐색 |
| 문서 | 문서 스코프가 부여된 경우 노트북 및 대시보드 검사 |
연결 확인
예시 프롬프트
문제 해결
잘못된 환경 URL
잘못된 환경 URL
DT_ENVIRONMENT가
https://abc12345.apps.dynatrace.com 형식의 Dynatrace Platform URL인지 확인하세요. 클래식 live.dynatrace.com URL은 이 연결에 유효하지 않습니다.인증되지 않았거나 만료된 토큰
인증되지 않았거나 만료된 토큰
Platform 토큰이 누락되었거나, 만료되었거나, 취소되었거나, 잘못 복사되었습니다. 필요한 스코프로 새 Dynatrace Platform 토큰을 생성하고 다시 연결하세요.
권한 오류
권한 오류
토큰에 하나 이상의 필수 스코프가 누락되었습니다. DQL이 이벤트에는 작동하지만 로그에는 작동하지 않는 경우
storage:logs:read를 추가하세요. 대부분의 도구가 실패하는 경우 토큰에 app-engine:apps:run이 포함되어 있는지 확인하세요.빈 DQL 결과
빈 DQL 결과
쿼리가 빈 버킷, 토큰이 읽을 수 없는 데이터 유형, 또는 일치하는 텔레메트리가 없는 시간 범위를 대상으로 할 수 있습니다. 알려진 서비스, 버킷, 또는 시간 범위를 대상으로 더 짧은 쿼리를 시도하세요.
크거나 느린 Grail 쿼리
크거나 느린 Grail 쿼리
범위가 없는 DQL 쿼리는 너무 많은 데이터를 반환하거나 너무 오래 걸릴 수 있습니다. 필터를 추가하고, 짧은 시간 범위를 사용하고, 에이전트에게 쿼리를 확장하기 전에 검증하도록 요청하세요.
보안
- 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
- 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
- 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
- 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
- Platform 토큰만 사용 — 클래식 API 토큰이 아닌 Dynatrace Platform 토큰을 사용하세요. 클래식 토큰은 MCP 서버에 필요한 스코프가 없습니다.
- 읽기 스코프로 시작 — 에이전트가 문서를 생성해야 하는 워크플로에만
document:documents:write를 부여하세요.
관련 항목
Datadog 연결
로그, 메트릭, APM, 인시던트
New Relic 연결
APM, NRQL, 인프라, 알림