H14. AI로 차트·이벤트 분석 받기 (CogentAI)
Diátaxis: How-to(목표별 가이드) · 대상: 운영자 / 관리자 ← 목차로
OPENMARU APM은 화면의 차트·이벤트를 CogentAI에게 넘겨, 무엇이 이상한지와 다음에 무엇을 볼지 자연어로 받아볼 수 있습니다. 앞의 H5~H8이 "사람이 직접 읽는 법"이라면, 이 문서는 그 판단을 AI에게 1차로 맡기는 법입니다.
사전 조건 AI 기능은 관리자가 켜 두었을 때만(
cogent.ai.use설정) 버튼이 보입니다. 버튼이 안 보이면 비활성 상태이므로 관리자에게 문의하세요.
AI 버튼은 분석 대상에 따라 위치가 다릅니다. 먼저 무엇을 진단할지 정하고 맞는 버튼을 쓰세요.
| 버튼 위치 | 분석 대상 | 던지는 질문 |
|---|---|---|
| 헤더 우측 "AI 진단" | 선택한 앱 그룹 전체 | "지금 시스템 전반 괜찮은가?" |
| 차트 카드의 AI 아이콘 | 그 차트 하나의 지표 | "이 차트 왜 이런 모양인가?" |
| 트랜잭션 상세의 AI 버튼 | 트랜잭션 1건 | "이 요청 왜 느렸나/실패했나?" |
| 이벤트 행의 AI 아이콘 | 그 이벤트 1건 | "이 이벤트 원인·조치는?" |
헤더에서 AI 도우미 열기 — 전체 시스템 종합 진단
가장 넓게 보는 버튼입니다. 화면 위쪽(헤더) 우측의 "AI 진단"(CogentAI 아이콘 + 라벨)을 누릅니다.
- 헤더의 AI 진단 버튼을 클릭합니다. (hover 시 "지금 시스템에 이상은 없는지 — AI 진단" 표시)
- CogentAI 위젯이 열리며, 현재 선택된 앱 그룹 전체의 운영 상태를 자동으로 묻습니다 — "[그룹명] 애플리케이션 및 시스템에 문제는 없는지 현재 상황을 분석하여 알려줘."
- AI가 그룹 전반(애플리케이션·시스템)을 점검해 이상 징후와 권고를 자연어로 보고합니다.
참고 이 버튼은 지금 보고 있는 탭과 무관하게 항상 선택된 앱 그룹 전체를 봅니다. 특정 차트만 보고 싶으면 아래의 차트 카드 AI 버튼을 쓰세요.
분석 대상 그룹을 바꾸려면 먼저 컨텍스트 셀렉터에서 그룹을 고릅니다 → H1.
차트 옆 AI 버튼 — 메트릭 즉시 분석
개별 차트가 이상해 보일 때, 그 차트 카드 안의 AI 아이콘을 누르면 그 차트만 집중 분석합니다.
- 분석할 차트 카드 우상단의 AI 아이콘을 클릭합니다. (hover 시 "CogentAI 분석")
- 그 차트의 제목·지표 데이터·대상(호스트/인스턴스)·차트 이미지가 함께 AI로 전달됩니다. (과거·일간 구간은 10분 단위 평균으로 요약해 보냄)
- AI가 *"이 차트는 …한 상태이며, …를 더 확인하라"*는 식으로 해석과 다음 점검을 제안합니다.
참고 H6의 JVM 힙 차트, H8의 CPU/디스크 차트처럼 모양 해석이 핵심인 차트에서 특히 유용합니다. 사람이 R2 임계치로 확인하기 전, AI로 1차 스크리닝을 받는 식으로 씁니다.
이벤트 AI 분석
발생한 이벤트의 원인이 한눈에 안 들어올 때, 이벤트의 AI 아이콘으로 그 이벤트 1건을 분석시킵니다.
- 이벤트 목록에서 이벤트 행의 AI 아이콘을 누르거나, 이벤트를 열어 상세 드로어의 AI 분석을 사용합니다.
- 그 이벤트의 종류·레벨·대상·메시지(그리고 스레드 덤프·진단 응답 같은 부가 데이터)가 함께 AI로 전달됩니다.
- AI가 원인 추정과 조치 방향을 제안합니다.
데드락·OOM처럼 덤프가 자동 수집된 이벤트는, 그 덤프까지 함께 분석되어 더 구체적인 답을 받을 수 있습니다. 이벤트 종류별 의미는 R3. 이벤트 종류 레퍼런스를 보세요.
AI 활용 팁과 한계
잘 쓰는 법
- AI 답을 출발점으로 삼고, 제안된 지표를 R2 레퍼런스·실제 차트로 교차 확인합니다.
- 넓게 → 좁게: 헤더 AI 진단으로 전체를 본 뒤, 지목된 영역의 차트 AI 버튼으로 좁힙니다.
- 추적이 필요한 답이면 H5~H8의 사람 진단 절차로 이어 갑니다.
한계와 주의
- 주의 — AI는 추정을 제공합니다. 재시작·설정 변경 같은 돌이키기 어려운 조치는 사람이 근거를 확인한 뒤 결정하세요.
- AI에는 위험·민감 정보 노출을 막는 가드레일/필터가 적용됩니다 — 일부 질의는 의도적으로 제한될 수 있습니다.
- 버튼이 안 보이면 관리자가 기능을 꺼 둔 것입니다(
cogent.ai.use).
관련 문서
- H6 · H7 · H8 · H10 — 사람이 직접 진단하는 절차
- R2. 차트 지표 레퍼런스 — AI 답을 교차 확인할 임계치
- R3. 이벤트 종류 레퍼런스 — 이벤트 의미·조사 포인트