관리 모듈 생성 및 사용 › 메트릭 그룹화 구성

메트릭 그룹화 구성

메트릭 그룹화는 다음 정보를 저장하는 관리 모듈 개체입니다.

• 에이전트 표현식 -- 에이전트 이름까지의 데이터를 지정하여 메트릭에 대한 입력을 필터링하는 Perl 5 정규식입니다.
• 메트릭 표현식 -- 리소스(메트릭으로 이어지는 폴더 체인)와 메트릭을 지정하는 Perl 5 정규식입니다.
• 메트릭 그룹화가 속하는 관리 모듈

메트릭 그룹화 예

지원 가능성 관리 모듈을 예로 들어 살펴보겠습니다. 디스크 사용(mb) 메트릭 그룹화는 다음을 사용합니다.

메트릭 그룹화 에이전트 표현식:

(.*)\|Custom Metric Process \(Virtual\)\|(.*)

메트릭 표현식:

Enterprise Manager\|Data Store\|(.*)Disk Usage \(mb\)

메트릭 그룹화에 대한 표현식 지정

이 필드를 입력할 때는 Perl 5 정규식 언어를 사용하여 정보를 입력하거나 Investigator에서 메트릭 및 에이전트를 선택하여 필드로 끌어다 놓을 수 있습니다.

에이전트 표현식은 관리 모듈별로 정의할 수 있습니다. 그런 후에는 이러한 에이전트 표현식을 관리 모듈 내의 메트릭 그룹화에 적용할 수 있습니다.

기본적으로 모든 메트릭 그룹화는 자체 에이전트 표현식을 사용하여 에이전트를 찾습니다. 관리 모듈의 에이전트 표현식을 사용하려는 경우 메트릭 그룹화의 설정 창에서 이 옵션을 선택합니다. 이 옵션을 선택하면 관리 모듈의 에이전트 표현식이 변경될 경우 일치하는 에이전트가 자동으로 변경됩니다.

메트릭 이름 구조

정규화된 메트릭 이름은 다음과 같습니다.

Domain|Hostname|Process|AgentName|Resource:Metric

예를 들어 리소스에 있는 메트릭의 정규화된 메트릭 이름은 다음과 같습니다.

Acme|c1737019-a|AcmeUSA|AcmeWest|GC 힙:사용 중인 바이트

메트릭이 두 리소스 내에 있는 경우 이름은 다음과 같습니다.

Acme|c1737019-a|AcmeUSA|AcmeWest|서블릿|FileServlet:초당 응답 수

리소스 계층이 더 있는 경우 리소스는 파이프 문자(|)로 구분됩니다.

메트릭 이름의 구조에 대한 자세한 내용은 변수 사용을 참조하십시오.

참고: SuperDomain 이외 도메인의 사용자인 경우 다음 구문에서 도메인 정보를 제외한 메트릭 이름이 표시됩니다. Hostname|Process|AgentName|Resource:Metric. 예:

c1737019|AcmeUSA|AcmeWest|GC 힙:사용 중인 바이트

새 메트릭 그룹화 생성

다음을 수행할 수 있습니다.

• 기존 메트릭에서 새 메트릭 그룹화 생성
• "요소" 메뉴에서 새 메트릭 그룹화 생성
• 메트릭 그룹화에 다른 메트릭 추가
• 메트릭 그룹화 사용자 지정

참고: 관리 모듈 요소를 새로 생성하여 저장한 직후에 기록 시간 범위를 사용하여 이를 표시하려고 하면 데이터가 올바르게 표시되지 않을 수 있습니다. 올바른 기록 데이터가 표시되려면 몇 분이 걸릴 수 있습니다.

메트릭 이름에 멀티바이트 문자를 사용하는 경우 참고 사항

에이전트가 캡처하는 데이터는 지역화되지 않기 때문에 멀티바이트 로캘 컴퓨터의 사용자에게 멀티바이트 문자를 사용하여 생성된 메트릭의 이름이 "탐색" 트리에서 멀티바이트 문자를 사용하여 표시되지 않을 수 있습니다. 이 문제를 방지하려면 로마 문자를 사용하여 메트릭을 생성하십시오.

기존 메트릭에서 새 메트릭 그룹 생성

기존 메트릭에서 새 메트릭 그룹화를 생성하려면

1. 메트릭을 마우스 오른쪽 단추로 클릭하고 메뉴에서 "메트릭 <Name>에서 메트릭 그룹화 새로 만들기"를 선택합니다.
2. 메트릭 그룹화의 기본 이름을 그대로 사용합니다.
3. 다음 방법 중 하나로 메트릭 그룹화를 포함할 관리 모듈을 선택합니다.
   • 드롭다운 목록 상자에서 관리 모듈을 선택합니다.
   • "선택"을 클릭하고 목록에서 관리 모듈을 선택한 다음 "선택"을 다시 클릭합니다.
4. "확인"을 클릭합니다.

   새로 생성한 메트릭 그룹화가 관리 모듈 편집기 트리에서 해당 그룹화를 저장한 관리 모듈 아래에 강조 표시됩니다.

   참고: 메트릭 그룹화는 활성 상태로 생성되며 비활성화할 수 없습니다.

   메트릭 그룹화의 "설정" 창에서 메트릭 그룹화 "에이전트 표현식" 및 "메트릭 표현식" 필드에는 이미 메트릭 정보가 포함되어 있습니다.

   참고: 에이전트 이름을 기반으로 하는 필터링은 introscope.agent.perfmon.agentExpression 속성을 사용합니다. 올바른 에이전트 표현식은 다음과 같습니다.

   ProcessName|AgentName 
   

   또는

   *|MyAgent
   

5. "설명" 탭을 선택하고 "설명 텍스트" 필드에 메트릭 그룹화에 대한 설명 텍스트와 중요 정보를 입력합니다.

   이 필드의 데이터는 64 KB를 초과하지 않아야 합니다. 값이 적용된 후에는 관리 모듈 jar에 계속 유지됩니다.

6. 사용할 에이전트 표현식을 선택합니다.
   • 관리 모듈에 대해 정의된 에이전트 표현식을 사용하려면 "관리 모듈 에이전트 표현식 사용"을 선택합니다.
   • 이 메트릭 그룹화에 대해 정의된 에이전트 표현식을 사용하려면 "메트릭 그룹화 에이전트 표현식 사용"을 선택합니다.
7. "적용"을 클릭합니다.

"요소" 메뉴에서 새 메트릭 그룹화 생성

"요소" 메뉴에서 새 메트릭 그룹화를 생성하려면

1. "Workstation" 창에서 "Workstation" > "관리 모듈 편집기"를 선택합니다.
2. "관리 모듈 편집기" 창에서 "요소" > "메트릭 그룹화 새로 만들기"를 선택합니다.
3. "이름" 필드에 메트릭 그룹화의 이름을 입력합니다.
4. 다음 방법 중 하나로 메트릭 그룹화를 포함할 관리 모듈을 선택합니다.
   • 드롭다운 목록 상자에서 관리 모듈을 선택합니다.
   • "선택"을 클릭하고 목록에서 관리 모듈을 선택한 다음 "선택"을 다시 클릭합니다.
5. "확인"을 클릭합니다.

   새로 생성한 메트릭 그룹화가 Investigator 트리에서 강조 표시되며 해당 설정이 설정 창에 나타납니다.

   참고: 메트릭 그룹화는 활성 상태로 생성되며 비활성화할 수 없습니다.

6. "메트릭 그룹화 에이전트 표현식" 및 "메트릭 표현식" 필드에 특정 에이전트 및 메트릭 정보를 입력합니다.

   다음 방법 중 하나로 정보를 입력할 수 있습니다.

   • 정규식에 정보를 입력합니다.
   • 다른 Investigator 창을 열고, 메트릭을 선택하고, 정보를 메트릭 그룹화 창으로 끌어서 "메트릭 그룹화 에이전트 표현식" 및 "메트릭 표현식" 필드 주위에 파란색 선이 나타나도록 합니다.

   마우스 단추에서 손을 떼면 "메트릭 그룹화 에이전트 표현식" 및 "메트릭 표현식" 필드에 메트릭 정보가 자동으로 입력됩니다.

7. 사용할 에이전트 표현식을 선택합니다.
   • 관리 모듈에 대해 정의된 에이전트 표현식을 사용하려면 "관리 모듈 에이전트 표현식 사용"을 선택합니다.
   • 이 메트릭 그룹화에 대해 정의된 에이전트 표현식을 사용하려면 "메트릭 그룹화 에이전트 표현식 사용"을 선택합니다.
8. "적용"을 클릭합니다.

메트릭 그룹화에 다른 메트릭 추가

기존 메트릭 그룹화에 다른 메트릭을 추가하려면

1. 메트릭 그룹화 설정 창에서 "추가"를 클릭합니다.

   그러면 두 번째 메트릭의 정보를 입력할 수 있는 다른 에이전트/메트릭 표현식 필드 쌍이 추가됩니다.

2. 다른 Investigator 창을 시작합니다.
3. 두 번째 Investigator 창에서 새 메트릭 그룹화를 표시할 메트릭을 선택하고, 이를 설정 창의 "메트릭 그룹화 에이전트 표현식" 필드로 끌어다 놓습니다.
4. 두 번째 Investigator 창에서 메트릭을 다시 선택하고 "메트릭 표현식" 필드로 끌어다 놓습니다.

메트릭 그룹화 사용자 지정

데이터 끌어다 놓기를 통해 얻는 정보보다 더 세부적으로 사용자 지정된 정보가 필요한 경우에는 "메트릭 그룹화 에이전트 표현식" 및 "메트릭 표현식" 필드를 편집하여 찾을 메트릭을 지정함으로써 메트릭 그룹화의 정규식을 사용자 지정할 수 있습니다.

메트릭 그룹화를 사용자 지정하려면

1. 정의를 편집하려면 다음 규칙을 준수합니다.
   • 연속되는 Investigator 트리 수준은 백슬래시 파이프 기호로 구분합니다. 백슬래시가 이스케이프 문자의 역할을 합니다.
     • 메트릭 그룹화 에이전트 표현식: Host\|Process\|AgentName
   • 하나의 리소스 세그먼트를 나타내려면 ([^\|:]*)를 사용합니다.
     • Servlets\|([^\|:]*):Average Response Time \(ms\)
   • 구분 문자와 괄호에는 이스케이프 문자(백슬래시)가 필요합니다. 예를 들어 \|, \( 및 \)와 같이 입력합니다.
     • Servlets\|Servlet1:Average Response Time \(ms\)
   • 하나의 표현식에서 여러 항목을 일치시키려면 파이프 문자를 사용하여 괄호 사이에 항목 목록을 포함할 수 있습니다.
     • Servlets\|Servlet(1|14|18):Average Response Time \(ms\).
   • AgentName과 메트릭 사이에 리소스 폴더가 없는 경우에는 메트릭 이름만 입력합니다. 그렇지 않은 경우에는 리소스 폴더를 백슬래시 파이프 기호로 구분하고 메트릭 이름 앞에 콜론(:)을 입력합니다.
     • 메트릭 표현식: resource\|subresource:Metric
     • 메트릭 표현식: resource:Metric
     • 메트릭 표현식: Metric

     예를 들어 메트릭 표현식에서 OptionReport라는 서블릿에 대한 평균 JDBC 쿼리 시간을 "Servlets\|OptionReport\|JDBC:Average Query Time"으로 지정합니다.

   • "임의 항목(any)"을 나타내려면 (.*)를 사용합니다.
     • 예를 들어 Cherubim\|PhoneHome\|(.*) 뒤에 Sockets:Output Bandwidth를 지정하면 호스트 Cherubim에서 실행 중인 프로세스 PhoneHome의 모든 인스턴스에 대한 모든 소켓의 출력 대역폭을 지정하는 것입니다.
     • "메트릭 표현식" 필드에서 File System:(.*)의 항목은 Investigator에서 파일 시스템 아래에 있는 파일 입력 및 출력 메트릭이 표시할 데이터라는 의미입니다. 이와 반대로 File System:File Input Rate의 경우는 파일 입력 비율만 표시합니다.
     • 메트릭 그룹화가 모든 서버, 모든 프로세스 및 모든 에이전트의 데이터를 표시하도록 하려면 "에이전트" 필드에 (.*)\|(.*)\|(.*)를 사용합니다. 또는 지정된 호스트, 프로세스 및/또는 에이전트 이름과 일치하는 에이전트를 찾기 위해 임의 세그먼트 또는 모든 세그먼트를 지정할 수 있습니다.
2. 필요한 경우 "추가"를 클릭하여 메트릭 그룹화에 대한 추가 메트릭을 지정합니다.
3. "적용"을 클릭합니다.