센트리 관리
센트리 관리 페이지에서는 센트리 모니터링 시스템의 설정과 모니터 상태를 관리할 수 있습니다.
본 페이지는 관리자 권한이 필요합니다. 일반 사용자는 읽기 전용으로 접근할 수 있습니다.
1. 페이지 개요
1.1 기능 설명
| 기능 | 설명 |
|---|---|
| 시스템 상태 | 센트리 모니터링 시스템의 전체 상태 요약 (2카드 구조) |
| 시스템 설정 | 센트리 시스템 기본 설정 및 알림 설정 |
| 데이터베이스 설정 | 저장소 데이터베이스 상세 정보, 관리 기능, 디렉토리 정보 |
1.2 접근 경로
URL: /workgroup/[workgroupId]/setting/uptime/config
메뉴: 설정 > 센트리 관리
[...slug] 위치에는 config만 유효합니다. 그 외 경로로 접근하면 설정 페이지가 표시되지 않을 수 있습니다.
설정 페이지 상단에 시스템 상태(SystemStatus) 컴포넌트가 embedded 방식으로 통합되어 있습니다. 별도의 "업타임 상태" 메뉴 없이 설정 페이지에서 바로 시스템 상태를 확인할 수 있습니다.
2. 시스템 상태 (SystemStatus)
2.1 개요
시스템 상태(SystemStatus) 컴포넌트가 설정 페이지 상단에 embedded 방식으로 통합되어 있으며, System Health 카드와 System Statistics 카드 2개로 구성됩니다.
2.2 System Health 카드
시스템 전체 건강 상태를 요약하여 표시합니다.
| 항목 | 설명 |
|---|---|
| 상태 | healthy / unhealthy — 전체 시스템 정상 여부 |
| 업타임 | 서비스가 연속 운영된 시간 |
| 버전 | 현재 센트리 서비스 버전 |
| 최종 업데이트 | 마지막 상태 갱신 시각 |
| 메시지 | 상태 관련 추가 메시지 (이상 발생 시 원인 안내) |
2.3 System Statistics 카드
모니터 현황과 시스템 리소스를 수치로 표시합니다.
| 항목 | 설명 |
|---|---|
| 총 모니터 | 등록된 센트리 모니터 총 개수 |
| 활성 모니터 | 활성 상태의 모니터 수 |
| 정상(up) 모니터 | 정상 동작 중인 모니터 수 |
| 장애(down) 모니터 | 장애 상태의 모니터 수 |
| heartbeat | 최근 하트비트 수신 현황 |
| 활동 클라이언트 | 현재 연결된 클라이언트 수 |
| 메모리 사용률 | 현재 메모리 사용 비율 |
| CPU 사용률 | 현재 CPU 사용 비율 |
2.4 자동 갱신
시스템 상태(SystemStatus) 컴포넌트는 30초 간격으로 자동 갱신됩니다. 별도의 새로고침 버튼을 클릭할 필요 없이 시스템 상태가 주기적으로 업데이트됩니다.
| 설정 | 값 |
|---|---|
| 자동 갱신 | 사용 |
| 갱신 주기 | 30초 |
| 표시 방식 | embedded (설정 페이지에 내장) |
2.5 메뉴 통합 변경사항
3. 화면 구성
3.1 주요 영역
| 영역 | 설명 |
|---|---|
| 시스템 상태 카드 | System Health + System Statistics (상단 embedded) |
| 시스템 설정 카드 | 알림 설정 포함 기본 설정 항목 그룹 |
| 데이터베이스 설정 카드 | DB 상세 정보, 관리 기능, 디렉토리 정보 |
| 저장 버튼 | 변경 사항 저장 |
3.2 UI 구성도
4. 사용 방법
4.1 설정 변경
- 설정 페이지 진입: 설정 > 센트리 관리 메뉴를 선택합니다.
- 설정 수정: 변경할 설정 항목의 값을 수정합니다.
- 저장: 저장 버튼을 클릭하여 변경 사항을 적용합니다.
일부 설정은 저장 후 서비스 재시작이 필요할 수 있습니다.
4.2 주요 설정 항목
시스템 설정 (NotificationSettingsCard)
| 항목 | 설명 | 비고 |
|---|---|---|
| TLS 인증서 만료 알림 | TLS 인증서 만료 임박 시 알림 발송 여부 설정 | 전환(토글) 또는 만료 D-day 기준 설정 |
| 서버 시간대 | 센트리 서버의 시간대 설정 | UTC 기준 또는 지역 시간대 목록에서 선택 |
| 데이터 보존 기간 | 모니터링 데이터 보관 기간 설정 | 기본값: 180일 |
데이터베이스 설정
DB 상세 정보
| 항목 | 설명 |
|---|---|
| DB 타입 | 데이터베이스 종류 (SQLite) |
| DB 경로 | 데이터베이스 파일 경로 |
| 데이터 디렉토리 | 데이터 저장 디렉토리 위치 |
| 크기 | 현재 DB 파일 크기 |
| 파일 상태 | DB 파일 정상 여부 |
| 보관 기간 | 데이터 보존 기간 (기본값: 180일) |
DB 관리 기능
| 기능 | 설명 |
|---|---|
| 압축 | DB 파일을 압축하여 용량을 줄입니다 |
| 백업 | 현재 DB 파일의 백업 사본을 생성합니다 |
| 오래된 통계 삭제 | 보관 기간을 초과한 오래된 통계 데이터를 삭제합니다 |
디렉토리 정보
| 항목 | 설명 |
|---|---|
| 업로드 디렉토리 | 업로드된 파일이 저장되는 경로 |
| 스크린샷 디렉토리 | 모니터링 스크린샷이 저장되는 경로 |
| Docker TLS 디렉토리 | Docker TLS 인증서가 저장되는 경로 |
5. 검증 및 확인
5.1 설정 적용 확인
설정 변경 후 다음 항목을 확인하십시오.
| 확인 항목 | 설명 |
|---|---|
| 모니터 동작 | 새 설정으로 모니터링 동작 확인 |
| 데이터 저장 | 데이터 정상 저장 확인 |
| 알림 수신 | TLS 인증서 만료 알림 정상 수신 확인 |
| 시간 표시 | 변경된 시간대로 시각 표시 확인 |
5.2 롤백 방법
| 상황 | 롤백 방법 |
|---|---|
| 설정 오류 | 이전 값으로 복원 |
| 서비스 오동작 | 기본값으로 재설정 |
6. 가이드 팝업창
6.1 개요
센트리 관리 페이지 우측 상단의 ? (물음표) 아이콘을 클릭하면 시스템 설정 가이드 팝업창이 표시됩니다.
6.2 가이드 내용
| 항목 | 아이콘 | 설명 |
|---|---|---|
| 시스템 상태 | 상태 아이콘 | 모니터링 시스템의 전체 상태 요약 확인 |
| 데이터 보관 | 보관 아이콘 | 데이터 보존 기간 및 저장소 설정 |
| 데이터베이스 | DB 아이콘 | 저장소 데이터베이스 유형 및 설정 |
| 알림 설정 | 알림 아이콘 | TLS 인증서 만료 알림 및 서버 시간대 설정 |
6.3 주의사항
일부 설정(데이터베이스 유형 변경, 보존 기간 변경 등)은 서비스 재시작 후에 적용됩니다.
7. 문제 해결
7.1 자주 발생하는 문제
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 설정이 저장되지 않음 | 유효하지 않은 값 | 입력값 확인 |
| 모니터링이 동작하지 않음 | 설정 오류 | 기본값으로 복원 |
| 시스템 상태가 unhealthy | 서비스 이상 | 메시지 내용 확인 후 서비스 재시작 |
| TLS 알림이 수신되지 않음 | 알림 설정 비활성 | NotificationSettingsCard에서 알림 활성화 확인 |
| DB 관리 기능 실패 | 디스크 공간 부족 | 디스크 여유 공간 확인 |
잘못된 설정은 모니터링 기능에 영향을 줄 수 있습니다. 변경 전에 기존 값을 기록해 두십시오.