수집 서버 관리

수집 서버 관리에서는 수집 서버(Collector Server)를 등록/편집하고, 서버 설정을 구성하며, 알람 관리(알람 규칙 + 알람 연동 통합)를 할 수 있습니다.

권한별 화면 차이

역할 설정에서 설정 메뉴의 수집 서버 관리 접근 권한이 없으면 이 메뉴가 표시되지 않습니다. read 권한만 있는 경우, 알람 규칙 목록은 조회 가능하지만 규칙 생성/수정/비활성화 버튼이 비활성화됩니다.

1. 페이지 개요

1.1 기능 설명

기능	설명
수집 서버 관리	수집 서버 등록, 수정, 삭제
서버 설정	수집 서버별 상세 설정 (시스템, 네트워크, DB, 고급)
알람 규칙	메트릭 기반 알람 규칙 생성 및 관리
알람 연동	XLOG 알람 외부 시스템 연동 설정

1.2 접근 경로

URL: /workgroup/[workgroupId]/setting/collectors/list
메뉴: 설정 > 수집 서버 관리

2. 화면 구성

2.1 화면 구성

영역	설명
뷰서버 정보	현재 연결된 뷰서버 정보 표시
액션 버튼	추가, 새로고침 버튼
서버 목록	등록된 수집 서버 목록

2.2 전체 화면

수집 서버 관리 전체 화면

2.3 서버 목록 상호작용

액션	설명	동작
서버 추가	새 수집 서버 등록	추가 버튼 클릭 → 등록 팝업창 표시
서버 편집	기존 서버 정보 수정	행의 편집 버튼 클릭 → 수정 팝업창 표시
서버 삭제	수집 서버 삭제	행의 삭제 버튼 클릭 → 확인 후 삭제
기본 서버 설정	기본 수집 서버 지정	기본 설정 버튼 클릭 → 해당 서버를 기본으로 설정
새로고침	목록 갱신	새로고침 버튼 클릭
서버 설정 이동	연결된 서버 설정	연결된 서버 주소 클릭 → 설정 페이지 이동

2.4 목록→설정 네비게이션

연결된 서버의 주소를 클릭하면 설정 페이지로 바로 이동할 수 있습니다.

단일 진입점

"수집 서버 설정" 메뉴가 제거되어 목록이 단일 진입점입니다. serverId 쿼리 파라미터로 특정 서버 설정으로 바로 이동합니다.

서버 상태	클릭 가능	동작
연결됨	O (파란색 링크)	설정 페이지로 이동
연결 안 됨	X (회색)	이동 차단 + 도움말 표시

2.5 서버 등록 정보

항목	설명	필수
서버명	수집 서버 식별명	O
서버 IP	수집 서버 IP 주소	O
포트	수집 서버 포트 번호	O
설명	서버에 대한 설명	X

3. 사용 방법

3.1 설정 페이지 진입

수집 서버 목록에서 연결된 서버의 주소를 클릭하여 설정 페이지로 이동합니다.

서버 목록 접근: 설정 > 수집 서버 관리 메뉴 진입
서버 선택: 연결된 서버의 주소를 클릭합니다 (파란색 링크)
설정 페이지 이동: serverId 쿼리 파라미터와 함께 설정 페이지로 이동

미연결 서버

연결되지 않은 서버는 주소가 회색으로 표시되며 클릭해도 이동되지 않습니다. 도움말로 안내가 표시됩니다.

3.2 설정 페이지 구조

영역	설명
뒤로가기 버튼	수집 서버 목록으로 복귀
서버 정보 헤더	현재 설정 중인 서버 정보
설정 탭	네트워크/데이터베이스/시스템/고급 설정
파라미터 검색바	키 또는 설명으로 파라미터 검색
중요도 필터	필수/주요/상세/전체 필터 버튼
상태 필터	변경됨만, 기본값과 다른 항목만 선택 상자

서버 선택 패널 제거

기존 좌측 서버 선택 패널이 제거되어 전체 너비 레이아웃을 활용합니다. 서버 전환은 뒤로가기 후 목록에서 다른 서버를 선택하십시오.

3.3 설정 탭 구성

탭	설명
네트워크	네트워크 관련 설정 (포트, 타임아웃 등)
데이터베이스	DB 연결 및 데이터 보관 정책
시스템	기본 시스템 설정 (로깅, 스레드 등)
고급 설정	고급 옵션 설정 (주의 필요)

3.4 중요도 기반 단계적 공개

설정 파라미터는 중요도에 따라 3단계로 분류되어 표시됩니다.

중요도	배지	설명	표시 방식
필수 설정	빨간색	시스템 운영에 반드시 필요한 설정	항상 펼쳐진 상태
주요 설정	주황색	운영 시 자주 조정하는 설정	펼쳐진 상태 (접기 가능)
상세 설정	회색	고급 사용자를 위한 상세 설정	접힌 상태 (펼치기 가능)

기능별 서브그룹

각 중요도 그룹 내에서 파라미터는 기능별로 묶여 표시됩니다. 예: 네트워크 탭의 "리슨 설정", "NIO 설정", 데이터베이스 탭의 "데이터 보관 정책" 등으로 구분됩니다.

3.5 파라미터 검색 및 필터

검색바: 파라미터 키 이름 또는 설명으로 검색합니다.
중요도 필터: 필수/주요/상세/전체 중 하나를 선택하여 해당 중요도의 파라미터만 표시합니다.
변경됨만: 기본값에서 변경된 파라미터만 표시합니다.
기본값과 다른 항목만: 기본값과 다른 값을 가진 파라미터만 표시합니다.

3.6 설정 탭 화면

네트워크 설정

수집 서버 설정 - 네트워크

데이터베이스 설정

수집 서버 설정 - 데이터베이스

시스템 설정

수집 서버 설정 - 시스템

고급 설정

수집 서버 설정 - 고급 설정

고급 설정 주의

고급 설정 탭의 파라미터는 시스템 성능과 안정성에 직접적인 영향을 줄 수 있습니다. 변경하기 전에 현재 설정을 백업하고, 각 설정의 의미를 충분히 이해한 후 수정하십시오.

3.7 설정 변경 절차

설정 페이지 진입: 목록에서 연결된 서버 주소를 클릭합니다.
설정 탭 선택: 변경할 설정 탭을 선택합니다.
파라미터 검색: 검색바 또는 중요도 필터로 원하는 파라미터를 찾습니다.
값 수정: 입력 필드나 스위치로 값을 변경합니다.
저장: "변경사항 저장" 버튼을 클릭하여 변경 사항을 적용합니다.
뒤로가기: 목록으로 복귀하거나 다른 서버를 선택합니다.

설정 적용

일부 설정은 서버 재시작 후에 적용될 수 있습니다. 변경된 파라미터는 "변경됨만" 필터로 확인할 수 있습니다.

4. 알람 관리

통합 변경

알람 규칙과 알람 연동이 "알람 관리" 단일 페이지로 통합되었습니다. 탭 전환으로 알람 규칙과 알람 연동 설정을 동일한 서버 컨텍스트에서 관리할 수 있습니다.

4.1 개요

알람 관리는 수집된 메트릭을 기반으로 임계값 초과 시 알람을 발생시키는 규칙 관리와, 외부 시스템 알람 연동을 하나의 페이지에서 통합 관리하는 기능입니다.

URL: /workgroup/[workgroupId]/setting/collectors/alarm
메뉴: 설정 > 수집 서버 관리 > 알람 관리

4.2 화면 구성

영역	설명
서버 선택기	알람 규칙을 관리할 서버 선택
검색	규칙명/메트릭으로 검색
액션 버튼	빠른 생성, 템플릿, 새로고침
규칙 목록	등록된 알람 규칙 목록

4.3 알람 규칙 생성 방식

방식	설명	사용 시기
빠른 생성	기본 설정으로 빠르게 규칙 생성	간단한 규칙 생성 시
템플릿	미리 정의된 템플릿으로 생성	일반적인 규칙 템플릿 사용 시
고급	상세 조건 및 스크립트 설정	복잡한 조건 필요 시

4.4 알람 규칙 생성 탭 구성

알람 규칙 생성/수정 팝업창은 다음 탭으로 구성됩니다.

탭	설명
일반 (general)	규칙명, 메트릭, 조건, 우선순위 등 기본 설정
조건	임계값 조건 상세 설정
알림	알림 채널 및 알림 대상 설정
고급	자바스크립트 편집기를 이용한 고급 조건 설정

4.5 규칙 구성 항목

항목	설명
규칙명	알람 규칙 식별명
메트릭	모니터링할 메트릭 (CPU, 메모리 등)
조건	임계값 조건 (> 80%, < 10% 등)
우선순위	알람 우선순위 (정보, 경고, 에러, 긴급)
알림 채널	알람 발생 시 통지할 채널
활성화	규칙 활성화/비활성화

알람 우선순위 4단계

우선순위	설명
정보 (info)	참고 목적의 낮은 수준 알람
경고 (warning)	주의가 필요한 상태
에러 (error)	오류가 발생한 상태
긴급 (critical)	즉각 조치가 필요한 심각한 상태

4.6 규칙 상호작용

액션	설명	동작
규칙 편집	기존 규칙 수정	행 클릭 또는 편집 버튼
규칙 활성화/비활성화	규칙 전환	전환 스위치 클릭
규칙 비활성화	규칙을 비활성 상태로 전환	비활성화 버튼 클릭 → "이 규칙을 비활성화하시겠습니까?" 확인 팝업창 → 확인

규칙 비활성화

규칙을 삭제하는 대신 비활성화(disable)하면 규칙 설정을 보존하면서 알람 발생을 중지할 수 있습니다. 비활성화된 규칙은 목록에서 회색으로 표시되며, 언제든지 다시 활성화할 수 있습니다.

4.7 다중 조건 설정 (추가 조건)

알람 규칙에는 기본 조건 외에 추가 조건(additionalConditions)을 설정하여 여러 조건을 동시에 적용할 수 있습니다.

항목	설명
조건 추가 버튼	새 조건을 추가합니다
조건 연산자	AND/OR 논리 연산자로 조건을 연결합니다
조건 삭제	개별 조건을 제거합니다

다중 조건 활용

예: CPU 사용률 > 80% AND 메모리 사용률 > 70% 와 같이 복합 조건으로 정밀한 알람 규칙을 만들 수 있습니다.

4.8 고급 탭 - 자바스크립트 편집기

알람 규칙 생성/수정 팝업창의 고급 탭에서는 자바스크립트 코드로 복잡한 알람 조건을 직접 작성할 수 있습니다.

영역	설명
자바스크립트 편집기	알람 조건 스크립트를 직접 작성하는 코드 편집기
컴파일 로그	스크립트 컴파일 결과 및 오류 메시지 표시
API 레퍼런스 패널	사용 가능한 메트릭 변수 및 함수 목록 참고

고급 탭 주의

자바스크립트 편집기는 고급 사용자를 위한 기능입니다. 잘못된 스크립트는 알람이 발생하지 않을 수 있습니다. 컴파일 로그를 확인하여 오류 여부를 반드시 검토하십시오.

5. 알람 연동 (알람 관리 탭)

5.1 개요

알람 연동은 알람 관리 페이지의 "알람 연동" 탭에서 관리합니다.

5.2 연동 유형

유형	설명
XLOG(트랜잭션 로그) 알람	XLOG 기반 성능 알람 연동 (성능 임계값 + 에러 알람 포함)

XLOG 알람 카드 구성

XLOG 알람은 단일 카드로 제공되며, 카드 내부에 성능 임계값 설정과 에러 알람 설정 섹션이 함께 포함되어 있습니다. 하나의 카드에서 성능과 에러 알람을 통합 관리할 수 있습니다.

5.3 XLOG 알람 설정

XLOG 알람 카드를 클릭하여 상세 설정을 구성할 수 있습니다.

성능 임계값 설정

항목	설명
응답시간 임계값	느린 트랜잭션 감지 기준 (ms)
성능 필터 활성화 (perfFilterEnabled)	성능 임계값 필터 적용 여부
성능 제외 패턴 (perfExcludePattern)	성능 알람에서 제외할 URL 패턴
성능 대상 URL 패턴 (perfTargetUrlPattern)	성능 알람을 적용할 특정 URL 패턴

에러 알람 설정

항목	설명
에러 알람 활성화	에러 발생 시 알람 발송 여부
에러 제외 패턴 (errorExcludePattern)	알람에서 제외할 에러 유형 패턴

공통 설정

항목	설명
알림 채널	알람 발생 시 통지 채널
무음 시간 (snoozeTimeSec)	알람 반복 발송을 억제하는 대기 시간(초)
UptimeKat 알림 연동 (uptimeNotificationIds)	연결할 UptimeKat 알림 채널 ID 목록

무음 시간(snooze) 설정

동일한 알람이 짧은 시간 내에 반복 발송되는 것을 방지합니다. 예: snoozeTimeSec: 300 설정 시 같은 알람은 5분에 1회만 발송됩니다.

UptimeKat 알림 연동

UptimeKat과 연동하면 수집 서버 알람을 UptimeKat의 알림 채널(이메일, 슬랙 등)로 함께 수신할 수 있습니다. uptimeNotificationIds에 UptimeKat 알림 채널 ID를 지정하십시오.

6. 가이드 팝업창

6.1 개요

수집 서버 관리 페이지 우측 상단의 ? (물음표) 아이콘을 클릭하면 가이드 팝업창이 표시됩니다. 이 팝업창은 주요 기능을 간략히 안내합니다.

6.2 가이드 내용

항목	아이콘	설명
서버 목록	목록 아이콘	수집 서버 목록 확인 및 관리
서버 추가	추가 아이콘	새 수집 서버 등록
새로고침	새로고침 아이콘	서버 목록 갱신

6.3 주의사항

기본 서버

현재 기본 서버로 설정된 서버는 삭제할 수 없습니다. 먼저 다른 서버를 기본 서버로 설정한 후 삭제하십시오.

7. 문제 해결

7.1 자주 발생하는 문제

증상	원인	해결 방법
서버 연결 실패	네트워크 문제	서버 IP/포트 확인
알람이 발생하지 않음	규칙 비활성화	규칙 활성화 상태 확인
설정이 저장되지 않음	권한 부족	관리자 권한 확인
데이터 수집 안 됨	수집 서버 중단	수집 서버 상태 확인

Primary 서버 삭제

현재 Primary로 설정된 서버는 삭제할 수 없습니다. 먼저 다른 서버를 Primary로 설정한 후 삭제하십시오.

1. 페이지 개요​

1.1 기능 설명​

1.2 접근 경로​

2. 화면 구성​

2.1 화면 구성​

2.2 전체 화면​

2.3 서버 목록 상호작용​

2.4 목록→설정 네비게이션​

2.5 서버 등록 정보​

3. 사용 방법​

3.1 설정 페이지 진입​

3.2 설정 페이지 구조​

3.3 설정 탭 구성​

3.4 중요도 기반 단계적 공개​

3.5 파라미터 검색 및 필터​

3.6 설정 탭 화면​

네트워크 설정​

데이터베이스 설정​

시스템 설정​

고급 설정​

3.7 설정 변경 절차​

4. 알람 관리​

4.1 개요​

4.2 화면 구성​

4.3 알람 규칙 생성 방식​

4.4 알람 규칙 생성 탭 구성​

4.5 규칙 구성 항목​

알람 우선순위 4단계​

4.6 규칙 상호작용​

4.7 다중 조건 설정 (추가 조건)​

4.8 고급 탭 - 자바스크립트 편집기​

5. 알람 연동 (알람 관리 탭)​

5.1 개요​

5.2 연동 유형​

5.3 XLOG 알람 설정​

성능 임계값 설정​

에러 알람 설정​

공통 설정​

6. 가이드 팝업창​

6.1 개요​

6.2 가이드 내용​

6.3 주의사항​

7. 문제 해결​

7.1 자주 발생하는 문제​

8. 관련 문서​