버전: 5.1.0-11.0

H20. 에이전트 상태 점검·문제 해결

Diátaxis: How-to(목표별 가이드) · 대상: 관리자 — 에이전트 상태 메뉴는 관리자 권한 계정에만 보입니다 ← 목차로

차트가 비거나 특정 인스턴스만 데이터가 안 들어올 때, 가장 먼저 볼 곳이 에이전트 상태 화면입니다. 에이전트는 각 인스턴스에 붙어 데이터를 수집해 APM 서버로 보내는 수집기이므로, 이게 끊기면 화면도 빕니다.

에이전트·인스턴스 개념은 E2.1을 보세요.

여는 법 — 좌측 메뉴 ▸ 설정 ▸ 에이전트 상태 (/settings/agents, 관리자만 보임)

에이전트 상태 화면 읽기

화면은 WAS · 웹서버 · 시스템 영역으로 나뉘고, 각 영역에 인스턴스들이 카드로 늘어섭니다. 각 영역 헤더 우측의 카운트 배지(예: 22 / 22)는 연결된 수 / 전체 수입니다.

상태는 인스턴스마다 상태 점(dot)과 색으로 표시합니다.

상태	의미
RUNNING(정상)	에이전트가 연결돼 정상 수집 중(점이 살짝 깜빡임)
STOPPED(중지)	연결이 끊겼거나 인스턴스가 내려감 — 데이터 수집 안 됨

각 인스턴스의 IP·버전도 함께 표시됩니다. 버전이 다른 인스턴스가 섞여 있으면 에이전트 업데이트 누락을 의심할 수 있습니다.

참고 카운트 배지의 "연결 수 / 전체 수"가 어긋나 있으면(예: 21 / 22) 한 대가 빠진 것입니다. 어느 영역·어느 인스턴스가 STOPPED인지 바로 찾을 수 있습니다.

STOPPED이거나 데이터가 안 들어오는 인스턴스를 만나면 다음 순서로 좁힙니다.

새로고침으로 최신 상태 확인 — 화면 상단의 그룹 다시읽기(Refresh Groups) / 정보 재 수집(Collect information again), 또는 해당 인스턴스 메뉴의 에이전트 새로고침(Agent Refresh)을 눌러 현재 상태를 다시 받습니다.
실제로 내려간 것인지 구분 — 인스턴스(프로세스) 자체가 중지된 것인지, 살아 있는데 에이전트 연결만 끊긴 것인지 확인합니다. 전자는 인스턴스를 다시 띄워야 하고, 후자는 네트워크·에이전트 설정 문제입니다.
웹서버 LB 워커는 인스턴스 메뉴에서 시작 / 종료(Start/Stop)로 직접 조작할 수 있습니다.

주의 위 액션들은 누르면 무슨 작업을 하는지 설명하는 확인창이 먼저 뜨고, 예(Yes) 를 눌러야 실행됩니다. 운영 중 영향이 있을 수 있으니 확인창 내용을 읽고 진행하세요.

연결이 끊기면 보통 이벤트로도 알림이 옵니다(에이전트 중지 등). 이벤트별 의미는 R3. 이벤트 종류 레퍼런스를 보세요.

"인스턴스는 살아 있는데 응답이 없다"(무응답·행) 싶을 때는, 멈춘 지점을 보려고 덤프를 요청합니다.

스레드 덤프 분석(Thread Dump Analyze) — 지금 스레드들이 무엇을 하다 멈췄는지 봅니다. 데드락·잠금 경합 의심 시 유용합니다.
힙 오브젝트 분석(Heap Object Analyze) — 메모리에 무엇이 쌓였는지(누수 후보) 봅니다.

데드락·OOM 이벤트가 나면 덤프가 자동 수집되기도 합니다. 메모리·누수 쪽 진단 절차는 H7. 메모리 누수 의심 시 점검에 자세히 있습니다.

주의 덤프 수집은 그 순간 JVM에 부하를 줍니다. 트래픽이 적은 시간대에, 필요한 인스턴스에만 요청하세요.

증상	점검
에이전트 상태 메뉴가 안 보임	관리자 권한 계정인지 확인 — 에이전트 상태는 관리자에게만 보입니다
새로고침해도 STOPPED 그대로	인스턴스(프로세스)가 실제로 떠 있는지, 호스트·네트워크 상태 확인
데이터는 오는데 버전이 제각각	에이전트 업데이트 누락 — 가이드 & 다운로드에서 최신 에이전트 확인
차트만 비고 상태는 RUNNING	셀렉터 대상·기간 문제일 수 있음 → H1 · H2