프로세스 그룹 설정

홈 화면 > 프로젝트 선택 > 실험실 > 프로세스 그룹 설정

프로세스 그룹 설정은 프로젝트에 속한 서버별 프로세스를 패턴 기반으로 커스텀 그룹화하는 설정 메뉴입니다. 서버 상세 화면에서 개별 프로세스를 하나씩 그룹화하는 대신, 이 화면에서 여러 서버의 프로세스 그룹을 한 곳에서 만들고 관리할 수 있습니다. 프로젝트 수정 권한 또는 알림 설정 권한이 필요합니다. 설정된 프로세스 그룹 이름은 infra_process_group 카테고리의 name 필드로 수집됩니다.

노트

권한에 대한 자세한 내용은 다음 문서를 참조하세요.

프로세스 그룹 추가하기

1. 홈 화면에서 서버 모니터링 프로젝트를 선택하세요.

2. 실험실 > 프로세스 그룹 설정 메뉴를 선택하세요.

3. 화면 오른쪽 상단의 + 프로세스 그룹 추가 버튼을 클릭하세요.

4. 그룹 설정 창이 열리면 다음 항목을 입력하세요.

   Item	Description
   프로세스 그룹 이름(필수)	프로세스 그룹 이름을 입력하세요. $1, $2를 쓰면 프로세스 패턴의 괄호에 맞은 문자열로 그룹을 나눌 수 있습니다. 자세한 내용은 프로세스 패턴 추출을 참조하세요.
   프로세스 패턴(필수)	그룹에 포함할 프로세스 패턴을 정규식 형태로 입력하세요. (예를 들어 java*yard*)
   프로세스 제외 패턴	그룹화 시 제외할 프로세스 패턴을 정규식 형태로 입력하세요. (예를 들어 except)
   프로세스 User(필수)	패턴으로 정의된 프로세스를 실행하는 사용자 정보를 입력하세요.
   활성화	그룹 활성화 여부를 설정하세요. 비활성 상태에서도 그룹을 저장할 수 있습니다.

5. 그룹 설정 창 오른쪽 대상 지정 방식에서 그룹을 적용할 대상을 선택하세요. 서버 직접 선택, 프로젝트 관리 서버 전체, Host Name 패턴, OS Type 패턴 중 하나를 사용합니다. 방식별 자세한 내용은 아래 대상 지정 방식 설명을 참고하세요.

6. 추가 버튼을 클릭하세요. 설정한 패턴에 해당하는 프로세스가 하나의 그룹으로 묶입니다.

   • 프로세스 명칭은 화면에 표시되는 프로세스 이름을 기준으로 합니다.

   • 프로세스 그룹 설정은 해당 프로젝트의 선택한 서버에만 적용됩니다.

   • 기존 서버 상세 화면의 그룹화로 추가한 그룹은 프로세스 그룹 설정에서 관리할 수 없습니다.

프로세스 패턴 추출

프로세스 그룹 이름에 $1, $2를 쓰면 프로세스 패턴의 괄호 ( )에 맞은 문자열로 그룹 이름을 만듭니다. 추출한 값마다 그룹이 따로 생기므로 규칙 하나로 여러 프로세스를 그룹별로 나눌 수 있습니다. jar 파일마다 규칙을 따로 만들 필요가 없습니다.

그룹 이름에 $숫자가 없으면 패턴 추출은 동작하지 않고, 지금과 같이 입력한 이름으로 그룹 하나를 만듭니다.

정보

프로세스 패턴 추출은 Linux, Windows는 에이전트 2.9.27 이상, Unix(AIX, HP-UX, Solaris)는 1.4.18 이상에서 지원합니다. 이보다 낮은 버전에서는 입력한 이름($1 등) 그대로 그룹 하나가 됩니다.

사용 예시

다음은 명령줄에 whatap.server.front.jar 또는 whatap.server.yard.jar가 있는 프로세스를 그룹으로 나누는 예시입니다.

프로세스 그룹 이름	프로세스 패턴	생성되는 그룹
$1	/whatap\.server\.(\w+)\.jar	front, yard
$1	/(whatap\.server\.\w+\.jar)	whatap.server.front.jar, whatap.server.yard.jar (파일 이름 전체)
whatap-$1	/whatap\.server\.(\w+)\.jar	whatap-front, whatap-yard
$1_svc	/whatap\.server\.(\w+)\.jar	front_svc, yard_svc
$0	whatap\.server\.\w+\.jar	whatap.server.front.jar, whatap.server.yard.jar (패턴에 맞은 문자열 전체)
$1	python3? .*?([\w-]+)\.py	Python 스크립트 이름별 그룹 (예: daily_report)
$1-$2	(java|python3?) .*?([\w.-]+)\.(?:jar|py)	괄호 두 개의 조합 (예: java-whatap.server.front)

작성 규칙

• $0은 패턴에 맞은 문자열 전체입니다.

• $1, $2는 여는 괄호 (를 왼쪽부터 센 순서입니다.

• (?: )는 묶기만 하고 번호를 매기지 않습니다.

• $12는 12번 괄호로 읽습니다. $1 뒤에 숫자를 붙이려면 $1-2처럼 구분 문자를 넣으세요.

• ${1}, $name, $$는 지원하지 않습니다.

• 정규식은 프로세스 명령줄 전체를 대상으로 하며, 일부만 맞아도 매칭됩니다.

• 대소문자를 구분합니다.

• 패턴이 여러 번 맞으면 가장 왼쪽 위치에서 맞은 값을 사용합니다.

동작 방식

• 참조한 괄호가 없거나 비어 있으면 입력한 이름(예: $1) 그대로 그룹이 됩니다.

• 고정 이름 규칙을 먼저 평가하고 패턴 추출 규칙은 나중에 평가합니다. 프로세스 하나는 처음 맞는 규칙 하나에만 속합니다.

• 그룹은 규칙 하나당 최대 20개, 서버당 패턴 추출 그룹은 모두 합쳐 최대 100개까지 만들어집니다. 상한을 넘는 프로세스는 입력한 이름 그대로 그룹 하나로 묶입니다.

• 그룹 이름은 최대 128자이며, 넘는 부분은 잘립니다.

• 매칭되는 프로세스가 없으면 고정 이름 규칙은 프로세스 수 0으로 표시되지만, 패턴 추출 규칙은 표시되지 않습니다.

• 추출한 이름이 다른 규칙의 고정 이름과 같으면 한 그룹으로 합쳐집니다.

주의 사항

• 괄호 범위를 넓게 잡지 마세요. (.*)\.jar처럼 쓰면 명령줄 앞부분 전체가 그룹 이름이 됩니다.

• 숫자, 날짜, 포트, PID처럼 프로세스마다 달라지는 값은 괄호로 잡지 마세요. 프로세스마다 그룹이 새로 생기고, 사라진 그룹도 24시간 동안 값이 0인 행으로 남습니다.

• 번호가 필요 없는 부분은 (?: )로 묶어 괄호 번호가 밀리지 않게 하세요.

• 반복되는 괄호는 마지막으로 맞은 값만 남습니다. 반복 전체를 가져오려면 ((?:...)+)처럼 바깥을 괄호로 한 번 더 감싸세요.

• whatap.conf를 직접 편집할 때는 역슬래시를 두 번 입력하세요(예: \\w). 서비스 화면에서 저장하면 자동으로 처리됩니다.

대상 지정 방식

그룹 설정 창의 대상 지정 방식에서 프로세스 그룹을 적용할 서버 범위를 지정합니다. 개별 서버를 직접 선택하는 방식 외에, 프로젝트 관리 서버 전체나 Host Name, OS Type 패턴으로 대상을 지정할 수 있습니다.

Item	Description
서버 직접 선택	그룹을 적용할 서버를 직접 선택
프로젝트 관리 서버 전체	프로젝트에 속한 모든 서버에 그룹 적용
Host Name 패턴	지정한 호스트명 패턴에 해당하는 서버에 그룹 적용
OS Type 패턴	지정한 OS 타입에 해당하는 서버에 그룹 적용

노트

적용 대상을 지정하지 않으면 서버 직접 선택 방식이 기본으로 사용됩니다.

Host Name 패턴과 OS Type 패턴은 정규식이 아니라 와일드카드로 입력하며, 대소문자를 구분하지 않습니다. 여러 패턴을 지정하면 그중 하나라도 일치하는 서버가 대상이 됩니다.

프로세스 그룹화는 Linux, Windows는 에이전트 2.9.18 이상, Unix(AIX, HP-UX, Solaris)는 1.4.9 이상에서 지원됩니다. 조건을 충족하지 않는 에이전트는 대상으로 선택할 수 없습니다.

매칭 서버 미리 보기

Host Name 패턴 또는 OS Type 패턴으로 대상을 지정하면, 입력한 패턴에 실제로 매칭되는 서버 목록을 저장 전에 확인할 수 있습니다. 패턴을 입력하면 화면에 매칭된 서버 수와 서버 목록이 표시됩니다. 의도한 범위보다 넓거나 좁게 지정하지 않았는지 저장 전에 점검할 때 사용합니다.

• 패턴을 입력하기 전에는 안내 문구만 표시되고, 패턴을 입력하면 매칭 결과로 바뀝니다.

• 와일드카드(*)는 하나의 패턴에 최대 2개까지 사용할 수 있습니다. 3개 이상 입력하면 경고를 표시합니다.

• 패턴은 최대 10개까지 등록할 수 있습니다.

프로세스 그룹 목록 화면의 검색도 개선했습니다. 적용 대상 기준으로 그룹을 검색할 수 있으며, 활성화 여부를 바꾸는 스위치 컬럼이 목록 맨 앞으로 이동했습니다.

프로세스 그룹 수정하기

1. 실험실 > 프로세스 그룹 설정 메뉴를 선택하세요.

2. 수정할 그룹의 관리 아이콘을 클릭하세요.

3. 그룹 설정 창에서 항목을 변경한 뒤 저장 버튼을 클릭하세요.

프로세스 그룹 복사하기

프로세스 그룹을 하나 이상의 프로젝트로 한 번에 복사할 수 있습니다. 같은 그룹 설정을 여러 프로젝트에서 재사용할 때 활용합니다.

1. 실험실 > 프로세스 그룹 설정 메뉴를 선택하세요.

2. 복사할 그룹을 하나 이상 선택하면 상단에 복사 버튼이 나타납니다. 복사를 클릭하면 프로세스 그룹 복사 창이 열립니다.

3. 복사할 대상 프로젝트를 선택하세요. 현재 프로젝트를 포함해 여러 프로젝트를 한 번에 선택할 수 있습니다.

4. 복사를 클릭하세요. 선택한 그룹이 대상 프로젝트마다 새 그룹으로 생성됩니다.

• 복사본은 원본과 동일한 그룹 이름으로 생성됩니다.

• 복사본은 항상 비활성 상태로 생성됩니다. 각 프로젝트에서 설정을 확인한 뒤 활성화하세요.

• 복사 대상으로는 설정 편집(수정) 권한이 있는 프로젝트만 선택할 수 있습니다.

• 대상 프로젝트에서 프로세스 그룹 설정 기능이 활성화되어 있어야 복사한 그룹을 확인하고 관리할 수 있습니다.

• 대상 프로젝트에 이름이 같은 그룹이 이미 있으면 해당 프로젝트에는 복사되지 않고 건너뜁니다.

노트

그룹 적용 대상(서버 선택) 처리

원본 그룹의 적용 대상이 특정 서버 선택 방식일 때, 다른 프로젝트로 복사하면 선택된 서버 목록은 복사되지 않습니다. 서버 목록은 프로젝트마다 다르기 때문입니다. OS 타입 패턴이나 호스트명 패턴으로 지정한 적용 대상은 프로젝트와 무관하므로 그대로 복사됩니다.

프로세스 그룹 삭제하기

1. 실험실 > 프로세스 그룹 설정 메뉴를 선택하세요.

2. 삭제할 그룹 행의 오른쪽에 버튼을 클릭하세요.

3. 확인 메시지가 나타나면 삭제 버튼을 클릭하세요.

주의

삭제한 프로세스 그룹의 과거 데이터는 유지되지만, 이후 새로운 데이터는 수집되지 않습니다.