H22. 서버 그룹으로 서버 묶기
Diátaxis: How-to(목표별 가이드) · 대상: 관리자 — 메뉴가 관리자 계정에만 보입니다 ← 목차로
서버 그룹은 SYS 에이전트가 수집하는 서버를 업무나 역할 단위로 묶은 것입니다. 예를 들어 쿠버네티스 워커 노드, DB 서버, 결제 서비스가 도는 서버를 각각 한 그룹으로 묶습니다.
지금 서버 그룹을 쓰는 곳은 TV 월보드의 서버 보기입니다. 월보드는 서버 그룹 하나를 칸 하나로 보여줍니다(H21. TV 월보드로 상황판 만들기).
참고 설정 화면의 부제는 "TV 월보드와 서버 대시보드가 쓰는 서버 그룹을 묶습니다" 입니다. 다만 콘솔의 서버 대시보드는 아직 서버 그룹을 쓰지 않습니다. 지금 서버 그룹이 바꾸는 화면은 TV 월보드뿐입니다.
여는 법 — 좌측 메뉴 ▸ 접근 관리 ▸ 서버 그룹 (/settings/systemGroups)
이 메뉴는 관리자 계정에만 보입니다. 서버 그룹은 월보드 전체의 칸 구성을 바꾸므로 등록·수정·삭제는 관리자만 할 수 있습니다(관리자가 아니면 HTTP 403). 메뉴가 숨겨질 뿐이므로, 관리자가 아닌 사용자가 화면 주소를 직접 열면 목록을 볼 수는 있지만 바꿀 수는 없습니다.
애플리케이션 그룹과 무엇이 다른가
애플리케이션 그룹은 WAS 인스턴스를 묶고, 셀렉터·차트·권한·알림 등 콘솔 여러 곳에서 씁니다. 서버 그룹은 SYS 에이전트 서버를 묶고, 지금은 TV 월보드 서버 보기만 씁니다. 애플리케이션 그룹은 문법(glob·정규식·직접 지정) 하나만 고르지만, 서버 그룹은 방식(무엇에 맞추나)과 문법(어떻게 쓰나)을 따로 고릅니다. 컨테이너 환경에서는 WAS 의 IP 와 서버의 IP 가 달라 애플리케이션 그룹으로 서버를 찾을 수 없으므로, 서버는 서버 그룹으로 따로 묶습니다.
화면 구성
화면은 한 판이고, 카드 두 장으로 나뉩니다. 카드 제목을 누르면 접고 펼 수 있습니다.
01 / 서버 그룹
| 열 | 내용 |
|---|---|
| 서버 그룹 이름 | 그룹 이름 |
| 방식 | 호스트 이름 · IP · 직접 지정 |
| 패턴/멤버 | 패턴 그룹은 문법 표시(glob 또는 정규식)와 패턴. 직접 지정 그룹은 서버 n대 |
| 서버 | 지금 이 그룹에 든 서버 수. 0 이면 눈에 띄게 표시합니다 |
| 작업 | 수정 · 삭제 |
직접 지정 그룹의 멤버 중 지금 등록되어 있지 않은 서버가 있으면, 패턴/멤버 열에 지금 없음 n대 가
함께 나옵니다.
02 / 서버 리스트
지금 등록된 SYS 에이전트 서버 전부입니다. 카드 제목 옆에 서버 n대 · 미소속 n대 가 나옵니다.
| 열 | 내용 |
|---|---|
| (체크 상자) | 직접 지정 그룹을 편집할 때만 쓸 수 있습니다 |
| 호스트 이름 | 서버의 짧은 호스트 이름 |
| IP | 서버가 등록한 IP |
| 상태 | 에이전트 실행 상태 |
| 속한 서버 그룹 | 이 서버가 든 서버 그룹들. 없으면 경고 표시와 함께 없음 |
- 검색 칸에 호스트 이름이나 IP 일부를 넣으면 목록을 줄입니다.
- 미소속만을 누르면 어느 서버 그룹에도 들지 않은 서버만 남깁니다.
- 한 서버가 서버 그룹 여러 개에 들면 그룹 이름 뒤에 개수가 붙습니다. 이 서버는 월보드의 여러 칸에 나옵니다.
- 직접 지정 그룹의 멤버인데 지금 등록되어 있지 않은 서버는 목록 끝에 회색으로, 상태 지금 없음으로 나옵니다. 이런 서버는 자동으로 그룹에서 빠지지 않습니다.
서버 그룹 만들기 — 패턴으로
이름에 규칙이 있는 서버를 묶을 때 씁니다. 패턴으로 묶으면 나중에 같은 규칙의 서버가 새로 등록되어도 자동으로 그 그룹에 들어갑니다.
- 서버 그룹 추가를 누릅니다.
- 서버 그룹 이름을 입력합니다.
- 방식을 고릅니다 — 호스트 이름 또는 IP.
- 문법을 고릅니다 — 와일드카드 (glob) 또는 정규식.
- 패턴을 입력합니다.
- 미리보기를 누릅니다. 일치하는 서버 수와 이름이 나옵니다.
- 결과가 맞으면 저장을 누릅니다.
결과 — 표에 그룹이 한 줄 생기고, 02 서버 리스트의 「속한 서버 그룹」에 그룹 이름이 나옵니다. 월보드는 10분 안에 새 그룹을 읽습니다.
방식 — 무엇에 맞추나
| 방식 | 패턴을 맞추는 대상 | 언제 쓰나 |
|---|---|---|
| 호스트 이름 (기본) | 서버의 짧은 호스트 이름. 도메인까지 붙은 전체 이름(FQDN)에는 맞추지 않습니다 | 이름에 규칙이 있을 때(worker01, master03). 컨테이너 환경에서 권장합니다 |
| IP | 서버가 등록한 IP | 대역으로 묶을 때(192.168.23.*). 이름이 같은 서버를 클러스터별로 가를 때 |
| 직접 지정 | 없음 — 서버를 하나씩 골라 담습니다 | 이름·IP 에 규칙이 없을 때 → 직접 지정으로 만들기 |
컨테이너 환경에서 호스트 이름 방식을 권장하는 이유가 있습니다. 컨테이너로 도는 SYS 에이전트가 등록하는 IP 는 배포 설정에 따라 노드 IP 가 아닐 수 있기 때문입니다.
문법 — 패턴을 어떻게 쓰나
| 문법 | 일치 방식 | 쓸 수 있는 기호 |
|---|---|---|
| 와일드카드 (glob) (기본) | 전체 일치 — 값 전체가 패턴과 맞아야 합니다 | * 아무 글자 0개 이상 · ? 아무 글자 한 개 · {a,b} 둘 중 하나 · [abc] 글자 묶음 · [!abc] 묶음 밖의 글자 |
| 정규식 | 부분 일치 — 값의 일부만 맞아도 잡습니다 | 정규식 문법 전부. 전체 일치가 필요하면 ^ 와 $ 로 감쌉니다 |
중요 같은 패턴도 문법에 따라 잡는 서버가 다릅니다.
worker는 glob 이면 이름이 정확히worker인 서버만 잡고, 정규식이면my-worker03처럼 이름 어디에든worker가 있는 서버를 모두 잡습니다. 그래서 표의 패턴/멤버 열에 문법이 함께 나옵니다.
- glob 의
*는 빈 문자열도 받습니다.worker*는worker01뿐 아니라worker도 잡습니다. - 패턴은 대소문자를 구분합니다.
Worker*는worker01을 잡지 않습니다. - CIDR(
192.168.23.0/24)은 지원하지 않습니다. 패턴에/가 있으면 문법과 관계없이 저장되지 않고, "CIDR 은 아직 지원하지 않습니다. '192.168.23.*' 처럼 적어 주세요." 가 나옵니다. - 정규식이 틀리면 "정규식이 올바르지 않습니다:
<사유>(N번째 글자 근처)" 가 나옵니다. - 문법을 바꾸면 폼 아래 안내 문구와 예시가 그 문법에 맞게 바뀝니다.
패턴 예시
| 하려는 것 | 방식 | 문법 | 패턴 | 잡는 서버 |
|---|---|---|---|---|
| 워커 노드 전부 | 호스트 이름 | glob | worker* | worker, worker01, worker-gpu |
마스터 노드 master01~master09 | 호스트 이름 | glob | master0? | master01 ~ master09 (master10 은 아님) |
| 웹 서버와 WAS 서버 | 호스트 이름 | glob | {web,was}-prod-* | web-prod-01, was-prod-02 |
| 한 대역 전부 | IP | glob | 192.168.23.* | 192.168.23.1 ~ 192.168.23.254 |
worker- + 숫자만 | 호스트 이름 | 정규식 | ^worker-\d+$ | worker-01, worker-12 (worker-gpu 는 아님) |
이름 어디에든 db | 호스트 이름 | 정규식 | db | db01, order-db-master, mydb |
| 한 대역을 앞자리로 | IP | 정규식 | ^192\.168\.23\. | 192.168.23. 으로 시작하는 IP |
| 두 업무 중 하나 | 호스트 이름 | 정규식 | ^(pay|order)- | pay-was01, order-api02 |
정규식에서 . 은 아무 글자 하나라는 뜻입니다. IP 의 점을 글자 그대로 맞추려면 \. 로 씁니다.
서버 그룹 만들기 — 직접 지정으로
이름이나 IP 에 규칙이 없는 서버를 골라 담을 때 씁니다.
- 서버 그룹 추가를 누르고 서버 그룹 이름을 입력합니다.
- 방식에서 직접 지정을 고릅니다. 문법·패턴 칸과 미리보기 버튼이 사라지고 "아래 서버 목록에서 체크로 담습니다." 가 나옵니다.
- 02 서버 리스트에서 담을 서버의 체크 상자를 켭니다. 검색이나 미소속만으로 목록을 줄인 뒤 맨 위 체크 상자를 누르면, 보이는 서버를 한꺼번에 담거나 뺍니다.
- 담은 수(
n대를 담았습니다.)를 확인하고 저장을 누릅니다.
직접 지정 그룹은 서버를 IP 와 호스트 이름의 짝으로 기억합니다. 같은 IP 에 호스트 이름이 다른 서버가 있어도 따로 담깁니다. 담은 서버가 나중에 등록에서 사라져도 그룹에서 지우지 않고 지금 없음으로 남깁니다. 빼려면 그룹을 수정해서 그 서버의 체크를 끄고 저장합니다.
수정·삭제
- 수정 — 표의 그 줄에서 수정을 누르면 폼이 저장된 값으로 열립니다. 이름·방식·문법·패턴을 바꾸고 저장합니다. 직접 지정 그룹은 지금 없는 멤버까지 체크된 채로 열리므로, 이름만 고쳐 저장해도 멤버가 빠지지 않습니다.
- 삭제 — 삭제를 누르고 확인 창에서 확정합니다.
이름 규칙
- 이름은 40자까지입니다. 넘으면 저장되지 않고, 지금 몇 자인지 알려 줍니다.
- 이름은 대소문자를 구분하지 않고 겹칠 수 없습니다.
DB가 있으면db를 만들 수 없습니다. - 한 서버는 서버 그룹 여러 개에 들 수 있습니다. 막지는 않지만, 그 서버는 월보드의 여러 칸에 나옵니다. 의도한 것인지 02 서버 리스트의 개수 표시로 확인하세요.
TV 월보드에서 확인하기
- 상단 헤더의 TV 아이콘을 좌측 메뉴 서버 아래 화면에서 누릅니다. 월보드가 서버 보기로 열립니다.
- 칸 제목을 눌러 서버 그룹 묶음에서 만든 그룹을 고릅니다. 괄호 안 서버 수가 설정 화면의 서버 수와 같은지 확인합니다.
- 월보드는 서버 그룹을 10분마다 다시 읽습니다. 바로 확인하려면 월보드를 새로고침합니다.
- 서버 그룹이 하나도 없으면 월보드는 애플리케이션 그룹으로 칸을 묶습니다. 서버 그룹을 하나라도 만들면 서버 그룹 기준으로 바뀝니다.
- 어느 서버 그룹에도 들지 않은 서버는 월보드의 그룹 없음 칸에 모입니다. 02 서버 리스트의 미소속만과 같은 서버들입니다.
잘 안될 때
| 증상 | 점검 |
|---|---|
| 접근 관리에 서버 그룹 메뉴가 없음 | 관리자 계정인지 확인하세요. 이 메뉴는 관리자에게만 보입니다 |
| 미리보기가 "일치하는 서버가 없습니다" | 문법을 확인하세요. glob 은 전체 일치라 이름 일부만 적으면 잡지 못합니다. 앞뒤에 * 를 붙이세요(*worker*). 대소문자도 확인하세요 |
| 정규식으로 바꿨더니 너무 많이 잡힘 | 정규식은 부분 일치입니다. ^ 와 $ 로 감싸 전체 일치로 만드세요 |
| 호스트 이름 패턴이 FQDN 과 안 맞음 | 호스트 이름 방식은 짧은 이름에만 맞춥니다. master1.example.local 대신 master1 기준으로 쓰거나 IP 방식을 쓰세요 |
192.168.23.0/24 가 저장되지 않음 | CIDR 은 지원하지 않습니다. 192.168.23.*(glob) 또는 ^192\.168\.23\.(정규식)로 쓰세요 |
| 표의 서버 수가 0 | 패턴이 지금 등록된 서버와 맞지 않습니다. 오타를 확인하고 미리보기로 다시 확인하세요 |
| 직접 지정 그룹에 지금 없음 n대 | 담아 둔 서버가 지금 등록되어 있지 않습니다. 에이전트 상태를 확인하거나(H20), 필요 없으면 수정에서 체크를 끄세요 |
| 체크 상자를 누를 수 없음 | 직접 지정 그룹을 추가하거나 수정하는 중일 때만 켜집니다. 방식이 직접 지정인지 확인하세요 |
| 같은 서버가 월보드 두 칸에 보임 | 그 서버가 서버 그룹 두 개에 들어 있습니다. 「속한 서버 그룹」의 개수 표시를 확인하세요 |
| 만든 그룹이 월보드에 안 보임 | 월보드는 10분마다 다시 읽습니다. 기다리거나 월보드를 새로고침하세요 |
| 서버 목록에 서버가 없음 | SYS 에이전트가 수집 서버에 등록됐는지 확인하세요 → H20 |
관련 문서
- H21. TV 월보드로 상황판 만들기 — 서버 그룹을 칸으로 보여주는 서버 보기
- H19. 애플리케이션 그룹으로 대상 묶기 — WAS 인스턴스를 묶는 애플리케이션 그룹
- H20. 에이전트 상태 점검·문제 해결 — 서버 목록에 서버가 없거나 지금 없음일 때
- R1. 화면 지도 — 접근 관리 메뉴 전체