이 매뉴얼의 구성

Diátaxis: 안내 · 대상: 모든 독자 ← 목차로

이 매뉴얼은 OPENMARU APM을 배우고(따라하기), 일하다 막히면 찾고(목표별 가이드), 정확한 값을 확인하는(참조) 세 가지 쓰임새에 맞춰 네 부로 나뉘어 있습니다. 처음부터 끝까지 순서대로 읽는 책이 아니라, 지금 필요한 부로 바로 들어가는 구조입니다.

네 부의 역할

부	장	성격	언제 읽나
1부. 개념 이해	E1 ~ E3	왜·무엇 (Explanation)	화면을 열기 전에 큰 그림을 잡고 싶을 때
2부. 따라하기	T1 ~ T3	처음부터 끝까지 실습 (Tutorial)	처음 쓰는 날 — 순서대로 따라 하면 결과가 나옵니다
3부. 목표별 가이드	H1 ~ H20	"이걸 하려면 어떻게" (How-to)	운영 중 특정 작업·문제가 생겼을 때 해당 장만 펴서
4부. 참조	R1 ~ R10	찾아보는 사전 (Reference)	차트·이벤트·용어의 정확한 의미와 임계치를 확인할 때

추천 경로

• 오늘 처음 접속한다면 — E1. OPENMARU APM 개요 → T1. 5분 빠른 시작 → T2. 대시보드로 문제 발견하기 순서를 권장합니다.
• 운영 중 문제가 생겼다면 — 3부에서 증상에 맞는 장으로 바로 갑니다. 예: 느린 응답은 H6, 메모리 의심은 H7, 알림이 너무 많으면 H16.
• 화면의 숫자가 무슨 뜻인지 궁금하면 — E3. 지표의 의미에서 개념을, R2. 차트 지표 레퍼런스에서 차트별 임계치를 봅니다. 화면에서는 차트 제목 옆 ? 아이콘이 같은 설명을 보여 줍니다.

표기 규칙

• 메뉴 경로 — 좌측 메뉴 ▸ WAS ▸ 대시보드 처럼 ▸ 로 단계를 잇습니다.
• 굵은 글씨 — 화면에 실제로 표시되는 버튼·메뉴·항목 이름입니다.
• 콜아웃 — 본문 중 상자로 표시된 참고(알아두면 좋은 것), 핵심(꼭 기억할 것), 주의(실수하기 쉬운 것)는 그 절의 요점입니다.
• 각 장 머리에는 그 장의 성격(개념/실습/목표별/참조)과 대상 독자가 표시되어 있습니다.

참고 모든 화면 캡처는 다크 테마 기준입니다. 라이트 테마에서도 위치와 동작은 같습니다.

CogentAI 기능 안내

이 매뉴얼 곳곳에 등장하는 CogentAI는 OPENMARU APM에 내장된 AI 분석 기능입니다. 헤더의 AI 진단(그룹 전체), 차트 카드의 AI 아이콘(차트 1개), 이벤트의 AI 진단, SQL AI 쿼리 진단, 스레드 덤프 CogentAI 분석처럼 화면 곳곳의 AI 버튼이 모두 CogentAI로 연결됩니다 — 무엇이 어디에 있는지는 H14. AI로 차트·이벤트 분석 받기, 따라하기는 T3. AI로 원인 분석하기에 정리돼 있습니다.

• 폐쇄망에서도 동작합니다 — CogentAI는 gpt-oss-20b 정도의 작은 LLM으로 구동되어, 외부 AI 서비스 호출 없이 인터넷이 안 되는 환경(폐쇄망) 에서도 사용할 수 있습니다.

• 전용 GPU 서버가 필요합니다 — 외부 클라우드 AI를 쓰지 않는 대신, CogentAI는 APM과는 별도의 GPU 서버에서 구동됩니다. 이 서버에는 다음 구성요소가 함께 올라갑니다.

  • vLLM — LLM(작은 모델)을 빠르게 실행하는 추론 서버. GPU를 사용합니다.
  • CogentAI Server — AI 분석 요청을 받아 LLM·도구 호출을 조율하는 본체.
  • Guardrail(가드레일) — AI에 오가는 질문·답변이 부적절하거나 위험한 내용을 담지 않도록 걸러 주는 안전장치입니다.
  • RAG(Retrieval-Augmented Generation, 검색 증강 생성) + VectorDB(벡터 데이터베이스) — 관련 자료·과거 이력을 의미로 검색해 답변 근거로 보태는 부분입니다.
  • Crawler(크롤러) — 매뉴얼·기술 문서 같은 참고 자료를 수집해 VectorDB에 쌓아 주는 수집기입니다. RAG가 검색할 자료가 여기서 만들어집니다.
  • MCP(Model Context Protocol) 도구 — AI가 실제 데이터를 직접 조회하도록 연결하는 표준 인터페이스입니다. APM · Database · Forecast · Chart 등 용도별 MCP가 붙습니다.

  즉 AI 기능을 쓰려면 이 AI 전용 GPU 서버(vLLM · CogentAI Server · Guardrail · RAG · VectorDB · Crawler · MCP) 가 구축돼 있어야 합니다. APM 서버만으로는 동작하지 않습니다.

  다만 CogentAI는 gpt-oss-20b 정도의 작은 LLM을 쓰므로, 대규모 GPU 클러스터까지는 필요 없습니다 — GPU 한 장을 갖춘 작은 서버 한 대 정도면 위 구성요소를 모두 올려 운영할 수 있습니다.

• 선택 기능입니다 — 관리자가 켜 두었을 때만(설정 ▸ Cogent AI) AI 버튼이 보입니다.

참고 CogentAI 사용을 원하시면 오픈마루 영업팀으로 연락해 주세요 — sales@openmaru.io · 02-469-5426