사용하기

WhaTap MCP 서버에 연결한 후 AI 어시스턴트로 모니터링 데이터를 조회하는 방법을 안내합니다.

동작 방식

AI 어시스턴트에게 자연어로 질문하면 위 과정을 자동으로 처리합니다.

프로젝트 목록 조회 — 프로젝트 코드(pcode)를 확인합니다.
데이터 카탈로그 탐색 — 조회할 수 있는 데이터 종류를 확인합니다.
쿼리 실행 — 원하는 데이터를 조회합니다.

팁

"프로젝트 목록 보여줘"로 시작해서 프로젝트 코드를 먼저 확인하세요. 이후 해당 코드를 사용하면 더 정확한 결과를 얻을 수 있습니다.

제공 도구 목록

MCP 서버는 총 10개의 도구를 AI 어시스턴트에 제공합니다. 사용자가 직접 도구를 호출할 필요는 없으며, 자연어로 질문하면 AI가 적절한 도구를 자동으로 선택합니다.

프로젝트 관리 도구

도구	기능
`whatap_list_projects`	전체 모니터링 프로젝트 목록 조회 (pcode, 이름, 플랫폼)
`whatap_project_info`	특정 프로젝트의 상세 정보 조회
`whatap_list_agents`	프로젝트 내 에이전트(서버/인스턴스) 목록 조회

데이터 탐색 도구

도구	기능
`whatap_data_availability`	900개 이상 MXQL 쿼리 탐색, 20+ 카테고리 실시간 데이터 감지, OpenMetrics 메트릭 목록, 저장 PromQL 쿼리 표시
`whatap_describe_query`	MXQL 경로 또는 OpenMetrics 메트릭 상세 조회 (파라미터, 출력 필드, 메트릭 타입, 추천 PromQL)
`whatap_query_data`	MXQL, PromQL, 저장 쿼리 실행 (단위 변환, 임계값, 분석 가이드 포함)

복합 분석 도구

도구	기능
`whatap_apm_anomaly`	APM 이상 탐지 — TPS, 응답시간, 에러, Active TX 4개 쿼리를 동시 실행하여 통계 분석
`whatap_service_topology`	서비스 간 연결 관계 및 네트워크 병목 탐지 (NPM 에이전트 필요)

설치 및 PromQL 도구

도구	기능
`whatap_install_agent`	29개 플랫폼 에이전트 설치 명령어 생성 (접속 정보 자동 포함, 플랫폼 자동 감지)
`whatap_create_promql`	PromQL 쿼리 작성, 실시간 검증, 저장 (재사용 가능)

whatap_install_agent 지원 플랫폼

카테고리	플랫폼
인프라 OS	Debian/Ubuntu, Amazon Linux, RHEL/CentOS, SUSE, FreeBSD, Windows 등 9종
APM	Java, Node.js, Python, PHP, .NET, Go
데이터베이스	PostgreSQL, Oracle, MySQL, Redis, MongoDB, DB2 등 12종
컨테이너	Kubernetes (Helm)
서버 앱	Kafka, NGINX, Apache 등 7종

도구별 사용 흐름

데이터 조회 워크플로우 (MXQL)

whatap_list_projects → projectCode 확인
        ↓
whatap_data_availability(projectCode) → 사용 가능한 MXQL 경로 확인
        ↓
whatap_describe_query(path) → 파라미터, 필드, MXQL 원문 확인
        ↓
whatap_query_data(projectCode, path) → 데이터 조회

PromQL 워크플로우 (쿠버네티스/OpenMetrics)

whatap_data_availability(projectCode) → OpenMetrics 메트릭 목록 확인
        ↓
whatap_create_promql(projectCode, name, query) → PromQL 검증 및 저장
        ↓
whatap_query_data(projectCode, savedQuery="name") → 저장 쿼리 재사용

에이전트 설치 워크플로우

whatap_list_projects → projectCode + 플랫폼 확인
        ↓
whatap_install_agent(projectCode) → 접속 정보 + 설치 명령어 출력
        ↓
whatap_list_agents(projectCode) → 에이전트 등록 확인

팁

이 흐름은 AI가 자동으로 진행합니다. 사용자는 원하는 내용을 자연어로 질문하기만 하면 됩니다.

주요 MXQL 경로 레퍼런스

whatap_data_availability 호출 없이 바로 사용할 수 있는 주요 경로 목록입니다.

도메인	경로	설명
Server	`v2/sys/server_base`	CPU, 메모리, 기본 지표
Server	`v2/sys/server_disk`	디스크 사용량
Server	`v2/sys/server_network`	네트워크 I/O
APM	`v2/app/tps_pcode`	TPS (프로젝트 전체)
APM	`v2/app/resp_time_pcode`	응답시간 (프로젝트 전체)
APM	`v2/app/tx_error_pcode`	에러 수 (프로젝트 전체)
K8s	`v2/container/kube_pod`	Pod 상태
K8s	`v2/container/kube_node`	노드 상태
K8s	`v2/container/kube_event`	클러스터 이벤트
DB	`v2/db/instance_active_session`	활성 세션

동작 방식​

제공 도구 목록​

프로젝트 관리 도구​

데이터 탐색 도구​

복합 분석 도구​

설치 및 PromQL 도구​

whatap_install_agent 지원 플랫폼​

도구별 사용 흐름​

주요 MXQL 경로 레퍼런스​