mfwkadm 명령

이 절에서는 설명서 페이지 섹션 1M의 유지 관리 명령인 mfwkadm 명령의 설명서 페이지를 재현합니다. 이 명령을 사용하여 모니터링하는 구성 요소에 대한 모든 모듈 및 노드에 정의한 작업이라고도 알려진 모든 모니터링 규칙을 비롯한 노드 에이전트의 내용을 관리합니다. 설명서 페이지의 일부 용어와 설명은 이 문서에 사용된 내용과 일치하도록 여기에서 수정되었습니다.

개요

성능 모니터링

작업 상태 모니터링

임계값 모니터링

설명

mfwkadm 유틸리티는 노드 에이전트라고도 하는 Monitoring Framework 에이전트를 관리하기 위한 명령줄 인터페이스입니다. 노드 에이전트는 공통 에이전트 컨테이너 내에서 실행됩니다. mfwkadm 유틸리티를 사용하여 노드 에이전트를 중지 및 재시작하고 수행하는 모니터링 작업을 관리할 수 있습니다. 이 명령은 노드 에이전트가 실행 중인 동일한 호스트에서 실행해야 합니다. 여기에 제공된 이 명령의 인수 순서를 유지해야 합니다.

출력 메시지의 언어를 변경하려면 LC_MESSAGE 환경 변수를 해당 로켈로 설정합니다. mfwkadm 명령은 lib/resources 디렉토리에 있는 JesmfMessages_ locale.pm이라는 파일에 포함된 메시지를 사용합니다. 해당 메시지 파일이 로켈에 없거나 로켈이 지정되지 않은 경우 mfwkadm 명령은 JesmfMessages.pm 파일에 있는 기본 메시지 집합을 사용합니다.

mfwkadm 유틸리티에는 다음 하위 명령이 있습니다. 별표(*)가 표시된 경우에는 공통 에이전트 컨테이너가 실행 중이어야 하고 노드 에이전트가 로드되어야 합니다.

• start

• stop

• restart

• list-params(*)

• list-modules(*)

• info(*)

• pm-job(*)

• opstat-job(*)

• thrsh-job(*)

로드할 공통 에이전트 컨테이너 모듈 수에 따라서 노드 에이전트를 시작하는 시간과 mfwkadm 유틸리티를 사용할 수 있을 때까지의 시간 사이에 몇 초 또는 몇 분의 시간 지연이 발생할 수 있습니다. 이 기간 동안 명령은 명시적 메시지와 함께 실패합니다.

옵션

다음 옵션이 지원됩니다.

--help

사용법 요약을 표시합니다.

하위 명령

start

공통 에이전트 컨테이너를 중지하지 않고 Monitoring Framework 노드 에이전트 및 연관된 구성 요소 제품 모듈을 시작합니다.

이 작업은 먼저 노드 에이전트를 배포한 다음 공통 에이전트 컨테이너의 연관된 구성 요소 제품 모듈을 배포합니다. 이 기능은 cacaoadm 유틸리티의 lock 및 undeploy 하위 명령 우위의 래퍼입니다.

start 하위 명령은 Monitoring Framework와 연관된 노드 에이전트 및 Java ES 구성 요소 모듈만 시작합니다. 구성 요소 모듈에는 접두어 com.sun.cmm이 있습니다.

보안: start 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다. 다른 사용자가 실행할 경우 다음과 같은 오류 메시지가 표시됩니다.

Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

stop

공통 에이전트 컨테이너에 있는 Monitoring Framework 노드 에이전트 및 연관된 Java ES 구성 요소 모듈을 중지합니다.

이 작업은 먼저 공통 에이전트 컨테이너에 배포된 모든 Java ES 구성 요소의 모듈을 중지한 다음 노드 에이전트를 중지합니다. 이 기능은 cacaoadm lock 및 unlock 하위 명령 우위의 래퍼입니다.

stop 하위 명령은 Monitoring Framework와 연관된 Java ES 구성 요소 모듈만 중지한 다음 노드 에이전트 자체를 중지합니다. 구성 요소 모듈에는 접두어 com.sun.cmm이 있습니다.

보안: stop 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다. 다른 사용자가 실행할 경우 다음과 같은 오류 메시지가 표시됩니다.

Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

restart

공통 에이전트 컨테이너에 있는 Monitoring Framework 노드 에이전트 및 연관된 Java ES 구성 요소 모듈을 다시 시작합니다.

이 작업은 stop 및 start 하위 명령과 같은 방법으로 공통 에이전트 컨테이너에 있는 노드 에이전트 및 연관된 모듈을 중지한 다음 시작합니다.

보안: restart 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다. 다른 사용자가 실행할 경우 다음과 같은 오류 메시지가 표시됩니다.

Error occured in mfwkadm Problem running //usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

list-params

Monitoring Framework 노드 에이전트와 관련된 모든 구성 매개 변수를 나열합니다.

보안: 이 명령에 대한 사용자 제한은 없습니다.

list-modules

공통 모니터링 모델(CMM)을 구현하고 공통 에이전트 컨테이너에 로드되는 구성 요소 제품 모듈의 목록을 표시합니다. 또한 이 하위 명령은 설치된 각 Java ES 구성 요소의 모든 실행 중인 인스턴스를 나열합니다. 각 구성 요소는 0개, 1개 또는 그 이상의 실행 중인 인스턴스를 가질 수 있습니다.

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 설치된 Java ES 구성 요소의 목록에 구성 요소 인스턴스가 포함되지 않습니다.

info runningInstance

명명된 runningInstance에 대한 정보를 표시합니다. runningInstance는 list-modules 하위 명령의 출력에 나열된 실행 중인 인스턴스와 일치해야 합니다.

다음과 같은 정보가 표시됩니다.

• 각 유형의 모니터링 작업에 대한 클래스 이름으로 정렬된 실행 중인 인스턴스와 연관된 관찰 가능한 모든 객체. 관찰 가능한 객체는 각각 pm-job, opstat-job 또는 thrsh-job 하위 명령을 사용하여 성능 모니터링 작업, 작업 상태 작업 또는 임계값 모니터링 작업을 만들 수 있는 객체입니다.

• 관찰 가능한 객체의 각 클래스에 대한 각각의 이름 및 유형을 포함하는 관찰 가능한 모든 속성

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 어떠한 정보도 표시되지 않습니다.

성능 모니터링

pm-job observable-classes

성능 모니터링 작업을 만들 수 있는 객체의 현재 관찰 가능한 모든 클래스의 목록을 표시합니다.

pm-job observable-objects [class= objectC lass] [domain=objectDomain]

성능 모니터링 작업을 만들 수 있는 현재 관찰 가능한 모든 객체의 목록을 표시합니다. 기본적으로 관찰 가능한 모든 클래스 및 모든 도메인에 있는 모든 객체가 나열됩니다. 객체 목록은 클래스 이름으로 정렬됩니다.

class=objectClass

선택적 objectClass를 지정하면 해당 특정 클래스의 관찰 가능한 객체로 출력이 제한됩니다. objectClass는 pm-job observable-classes 하위 명령이 나열하는 클래스 중 하나여야 합니다.

domain=objectDomain

선택적 objectDomain을 지정하면 해당 도메인의 관찰 가능한 객체로 출력이 제한됩니다. 객체의 도메인은 객체 이름에서 콜론(“:”) 문자 앞에 있는 문자열입니다.

pm-job observable-attributes class=objectClass

지정된 objectClass에 있는 모든 관찰 가능한 속성의 목록을 표시합니다. 속성은 이름 및 유형과 함께 표시됩니다. objectClass는 pm-job observable-classes 하위 명령이 나열하는 성능 모니터링 작업을 지원하는 클래스 중 하나여야 합니다.

pm-job list

현재 정의된 모든 성능 모니터링 작업의 목록을 표시합니다. 정의된 성능 작업이 있는 각 객체에 대한 작업이 나열되며 객체는 해당 클래스 이름으로 정렬됩니다. 각 작업에 대해 표시되는 정보는 pm-job info 하위 명령이 표시하는 정보와 동일합니다.

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 어떠한 작업도 표시되지 않습니다.

pm-job info jobName

jobName이라는 성능 모니터링 작업에 대한 세부 정보를 표시합니다. jobName은 pm-job list 하위 명령이 표시하는 이름이어야 합니다. 이 하위 명령은 다음 정보를 표시합니다.

• 성능 모니터링 작업의 이름

• 성능 모니터링 작업의 유형인 "객체별" 또는 "클래스별".객체별 작업은 하나 이상의 명명된 객체 인스턴스를 모니터링하고 클래스별 작업은 객체 클래스의 모든 인스턴스를 모니터링합니다. mfwkadm 유틸리티를 사용하여 클래스별 작업을 만들 수 없습니다.

• 성능 모니터링 작업의 상태: 활성 작동, 활성 비작동 또는 일시 중지됨. 활성 작동 작업은 실행하도록 예약되어 있고 데이터를 수집하는 중입니다. 활성 비작동 작업은 현재 시간이 작업 일정을 벗어났기 때문에 실행 중이지만 데이터를 수집하지는 않습니다. 일시 중지된 작업은 실행 중이거나 데이터를 수집하는 중이 아닙니다. pm-job suspend 및 pm-job resume 하위 명령을 사용하여 성능 모니터링 작업의 실행 상태를 변경합니다.

• 성능 모니터링 작업의 세부 기간(초). 이 작업의 데이터 수집 간격입니다.

• 모니터링 작업의 보고 기간. 보고 기간에 세부 기간을 곱하면 알림 빈도가 됩니다. 예를 들어, 세부 기간이 10초이고 보고 기간이 6인 경우 이벤트에 의한 작업 보고는 10초마다 데이터를 수집하고 60(10*6)초마다 6개의 보고서를 포함한 알림을 보냅니다. 작업이 또한 파일로 보고되는 경우 생성된 6개 파일의 위치를 포함하는 이벤트가 60초마다 보내집니다.

• 성능 모니터링 작업이 이벤트에 의해 보고되고 있는지 여부. 이는 성능 모니터링 작업의 결과가 등록된 클라이언트에게 알림으로 보내진다는 것을 의미합니다.

• 성능 모니터링 작업이 파일로 보고되고 있는지 여부. 이는 성능 모니터링 작업의 보고서가 로컬 파일에 기록되고 파일 이름을 포함하는 알림이 등록된 클라이언트에게 보내진다는 것을 의미합니다.

• 항상 XML인 성능 모니터링 작업의 보고서 형식

• 성능 모니터링 작업의 일정. 일정은 작업이 활성 작동 또는 활성 비작동(각각 데이터를 수집 중이거나 수집하지 않는 중)인 날짜와 시간을 지정합니다.

그런 다음 객체별 작업에 대한 다음 정보가 표시됩니다.

• 이름별로 순서가 지정된 관찰된 객체 목록

• 관찰 가능한 속성의 하위 집합만 지정된 경우 관찰된 객체의 관찰된 속성이 이름 및 유형별로 나열됩니다.

또한 클래스별 작업에 대한 다음 정보가 표시됩니다.

• 이름별로 순서가 지정된 관찰된 클래스 목록

• 관찰 가능한 속성의 하위 집합만 지정된 경우 관찰된 클래스의 관찰된 속성이 이름 및 유형별로 나열됩니다. 이러한 속성은 모든 클래스에 공통됩니다.

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 어떠한 정보도 표시되지 않습니다.

pm-job create jobName granularity= integerValue object=objectName [object= objectName ...]

하나 이상의 객체에서 새 성능 모니터링 작업을 만듭니다. mfwkadm 명령은 클래스별 작업을 만들 수 없습니다. 성능 모니터링 작업을 만들 경우 다음 매개 변수를 설정할 수 있습니다.

jobName

성능 모니터링 작업을 고유하게 식별하는 문자열. jobName은 다른 성능 모니터링 작업에서 이미 사용 중일 수 없습니다.

granularity=integerValue

작업이 활성 작동인 도중에 두 개의 연속된 측정 데이터 수집이 시작되는 시간 간격(초). 예를 들어, 세부 기간은 300초(5분), 900초(15분), 1800초(30분), 3600초(1시간)일 수 있습니다. 대부분의 경우 세부 기간이 300초면 충분합니다. 일부 측정의 경우 더 큰 세부 기간으로 데이터를 수집하는 것이 더 의미 있을 수 있습니다.

object=objectName [object= objectName ...]

성능 모니터링 작업이 데이터를 수집하고 보고하는 하나 이상의 관찰 가능한 객체. objectName은 pm-job list 또는 pm-job observable-objects 하위 명령이 표시하는 이름이어야 합니다. 여러 object= objectName 매개 변수를 지정할 경우 여러 객체를 모니터링하는 단일 성능 모니터링 작업이 만들어집니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

pm-job delete jobName

jobName이라는 성능 모니터링 작업을 삭제합니다. jobName은 pm-job list 하위 명령이 표시하는 이름이어야 합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

pm-job suspend jobName

jobName이라는 성능 모니터링 작업을 일시 중지합니다. 일시 중지된 작업은 활성 상태가 아니며 일정에 상관 없이 더 이상 데이터를 수집하지 않습니다. 그러나 작업은 정의된 상태로 유지되며 pm-job resume 하위 명령을 사용하여 다시 활성화할 수 있습니다. jobName은 pm-job list 하위 명령이 표시하는 이름이어야 합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

pm-job resume jobName

jobName이라는 성능 모니터링 작업을 다시 시작합니다. 다시 시작된 작업은 데이터 수집을 시작하고 일정에 따라 보고서를 보냅니다. jobName은 pm-job list 하위 명령이 표시하는 이름이어야 합니다. 이 하위 명령은 pm-job suspend 하위 명령에 대응합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

작업 상태 모니터링

opstat-job observable-classes

작업 상태 모니터링 작업을 만들 수 있는 객체의 현재 관찰 가능한 모든 클래스의 목록을 표시합니다.

opstat-job observable-objects [class= objectClass] [domain=objectDomain]

작업 상태 모니터링 작업을 만들 수 있는 현재 관찰 가능한 모든 객체의 목록을 표시합니다. 기본적으로 관찰 가능한 모든 클래스 및 모든 도메인에 있는 모든 객체가 나열됩니다. 객체 목록은 클래스 이름으로 정렬됩니다.

class=objectClass

선택적 objectClass를 지정하면 해당 특정 클래스의 관찰 가능한 객체로 출력이 제한됩니다. objectClass는 opstat-job observable-classes 하위 명령이 나열하는 클래스 중 하나여야 합니다.

domain=objectDomain

선택적 objectDomain을 지정하면 해당 도메인의 관찰 가능한 객체로 출력이 제한됩니다. 객체의 도메인은 객체 이름에서 콜론(“:”) 문자 앞에 있는 문자열입니다.

opstat-job observable-attributes class= objectClass

지정된 objectClass에 있는 모든 관찰 가능한 속성의 목록을 표시합니다. 속성은 이름 및 유형과 함께 표시됩니다. objectClass는 opstat-job observable-classes 하위 명령이 나열하는 클래스 중 하나여야 합니다.

opstat-job list

현재 정의된 모든 작업 상태 모니터링 작업의 목록을 표시합니다. 정의된 작업 상태 작업이 있는 각 객체에 대한 작업이 나열되며 객체는 해당 클래스 이름으로 정렬됩니다. 각 작업에 대해 표시되는 정보는 opstat-job info 하위 명령이 표시하는 정보와 동일합니다.

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 어떠한 작업도 표시되지 않습니다.

opstat-job info jobName

jobName이라는 작업 상태 모니터링 작업에 대한 세부 정보를 표시합니다. jobName은 opstat-job list 하위 명령이 표시하는 이름이어야 합니다. 이 하위 명령은 다음 정보를 표시합니다.

• 작업 상태 모니터링 작업의 이름

• 작업 상태 모니터링 작업의 유형인 "객체별" 또는 "클래스별".객체별 작업은 명명된 객체 인스턴스를 모니터링하고 클래스별 작업은 객체 클래스의 모든 인스턴스를 모니터링합니다. mfwkadm 유틸리티를 사용하여 클래스별 작업을 만들 수 없습니다.

• 작업 상태 모니터링 작업의 상태: 활성 작동, 활성 비작동 또는 일시 중지됨. 활성 작동 작업은 실행하도록 예약되어 있고 데이터를 수집하는 중입니다. 활성 비작동 작업은 현재 시간이 작업 일정을 벗어났기 때문에 실행 중이지만 데이터를 수집하지는 않습니다. 일시 중지된 작업은 실행 중이거나 데이터를 수집하는 중이 아닙니다. opstat-job suspend 및 opstat-job resume 하위 명령을 사용하여 작업 상태 모니터링 작업의 실행 상태를 변경합니다.

• 작업 상태 모니터링 작업의 세부 기간(초). 이 작업의 데이터 수집 간격입니다.

• 작업 상태 모니터링 작업이 이벤트에 의해 보고되고 있는지 여부. 이는 작업 상태 모니터링 작업의 결과가 등록된 클라이언트에게 알림으로 보내진다는 것을 의미합니다.

• 작업 상태 모니터링 작업이 파일로 보고되고 있는지 여부. 이는 작업 상태 모니터링 작업의 보고서가 로컬 파일에 기록되고 파일 이름을 포함하는 알림이 등록된 클라이언트에게 보내진다는 것을 의미합니다.

• 항상 XML인 작업 상태 모니터링 작업의 보고서 형식

• 작업 상태 모니터링 작업의 일정. 일정은 작업이 활성 작동 또는 활성 비작동(각각 데이터를 수집 중이거나 수집하지 않는 중)인 날짜와 시간을 지정합니다.

• 객체별 작업의 경우 이름별로 순서가 지정된 관찰된 객체 목록

• 클래스별 작업의 경우 이름별로 순서가 지정된 관찰된 클래스 목록

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 어떠한 정보도 표시되지 않습니다.

opstat-job create jobName granularity= integerValue object=objectName [object= objectName ...]

하나 이상의 객체에서 새 작업 상태 모니터링 작업을 만듭니다. mfwkadm 명령은 클래스별 작업을 만들 수 없습니다. 성능 모니터링 작업을 만들 경우 다음 매개 변수를 설정할 수 있습니다.

jobName

작업 상태 모니터링 작업을 고유하게 식별하는 문자열. jobName은 다른 작업 상태 모니터링 작업에서 이미 사용 중일 수 없습니다.

granularity=integerValue

작업이 활성 작동인 도중에 두 개의 연속된 측정 데이터 수집이 시작되는 시간 간격(초).

object=objectName [object= objectName ...]

작업 상태 모니터링 작업이 데이터를 수집하고 보고하는 하나 이상의 관찰 가능한 객체. objectName은 opstat-job list 또는 opstat-job observable-objects 하위 명령이 표시하는 이름이어야 합니다. 여러 object= objectName 매개 변수를 지정할 경우 여러 객체를 모니터링하는 단일 작업 상태 작업이 만들어집니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

opstat-job delete jobName

jobName이라는 작업 상태 모니터링 작업을 삭제합니다. jobName은 opstat-job list 하위 명령이 표시하는 이름이어야 합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

opstat-job suspend jobName

jobName이라는 작업 상태 모니터링 작업을 일시 중지합니다. 일시 중지된 작업은 활성 상태가 아니며 일정에 상관 없이 더 이상 데이터를 수집하지 않습니다. 그러나 작업은 정의된 상태로 유지되며 opstat-job resume 하위 명령을 사용하여 다시 활성화할 수 있습니다. jobName은 opstat-job list 하위 명령이 표시하는 이름이어야 합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

opstat-job resume jobName

jobName이라는 작업 상태 모니터링 작업을 다시 시작합니다. 다시 시작된 작업은 데이터 수집을 시작하고 일정에 따라 보고서를 보냅니다. jobName은 opstat-job list 하위 명령이 표시하는 이름이어야 합니다. 이 하위 명령은 opstat-job suspend 하위 명령에 대응합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

임계값 모니터링

thrsh-job observable-classes

임계값 모니터링 작업을 만들 수 있는 객체의 현재 관찰 가능한 모든 클래스의 목록을 표시합니다.

thrsh-job observable-objects [class= objectClass] [domain=objectDomain]

임계값 모니터링 작업을 만들 수 있는 현재 관찰 가능한 모든 객체의 목록을 표시합니다. 기본적으로 관찰 가능한 모든 클래스 및 모든 도메인에 있는 모든 객체가 나열됩니다. 객체 목록은 클래스 이름으로 정렬됩니다.

class=objectClass

선택적 objectClass를 지정하면 해당 특정 클래스의 관찰 가능한 객체로 출력이 제한됩니다. objectClass는 thrsh-job observable-classes 하위 명령이 나열하는 클래스 중 하나여야 합니다.

domain=objectDomain

선택적 objectDomain을 지정하면 해당 도메인의 관찰 가능한 객체로 출력이 제한됩니다. 객체의 도메인은 객체 이름에서 콜론(“:”) 문자 앞에 있는 문자열입니다.

thrsh-job observable-attributes class=objectClass

지정된 objectClass에 있는 모든 관찰 가능한 속성의 목록을 표시합니다. 속성은 이름 및 유형과 함께 표시됩니다. objectClass는 thrsh-job observable-classes 하위 명령이 나열하는 클래스 중 하나여야 합니다.

thrsh-job list

현재 정의된 모든 임계값 모니터링 작업의 목록을 표시합니다. 정의된 임계값 작업이 있는 각 객체에 대한 작업이 나열되며 객체는 해당 클래스 이름으로 정렬됩니다. 각 작업에 대해 표시되는 정보는 thrsh-job info 하위 명령이 표시하는 정보와 동일합니다.

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 어떠한 작업도 표시되지 않습니다.

thrsh-job info jobName

jobName이라는 임계값 모니터링 작업에 대한 세부 정보를 표시합니다. jobName은 thrsh-job list 하위 명령이 표시하는 이름이어야 합니다. 이 하위 명령은 다음 정보를 표시합니다.

• 임계값 모니터링 작업의 이름

• 임계값 모니터링 작업의 다중성. 이 릴리스에서는 하나의 객체에서 하나의 속성을 모니터링하는 간단한 임계값 작업만 가능합니다.

• 임계값 모니터링 작업의 상태: 활성 작동, 활성 비작동 또는 일시 중지됨. 활성 작동 작업은 실행하도록 예약되어 있고 데이터를 수집하는 중입니다. 활성 비작동 작업은 현재 시간이 작업 일정을 벗어났기 때문에 실행 중이지만 데이터를 수집하지는 않습니다. 일시 중지된 작업은 실행 중이거나 데이터를 수집하는 중이 아닙니다. thrsh-job suspend 및 thrsh-job resume 하위 명령을 사용하여 임계값 모니터링 작업의 실행 상태를 변경합니다.

• 임계값 모니터링 작업의 세부 기간(초). 이 작업의 데이터 수집 간격입니다.

• 임계값 모니터링 작업의 일정. 일정은 작업이 활성 작동 또는 활성 비작동(각각 데이터를 수집 중이거나 수집하지 않는 중)인 날짜와 시간을 지정합니다.

• 임계값 모니터링 작업의 경보 구성. 모니터링된 속성의 관찰된 값이 정의된 임계값을 초과할 경우 트리거되는 경보입니다. 경보의 유형과 심각도가 표시됩니다.

• 임계값 모니터링 작업의 관찰된 객체

• 임계값이 적용되는 속성 이름

• 경보를 트리거하는 임계값

• 임계값에서 경보를 트리거하는 값의 진행 방향인 RISING 또는 FALLING

• 임계값의 허용치 오프셋. 방향이 RISING인 경우 관찰된 속성이 thresholdValue-offsetValue보다 작을 때까지 경보가 다시 트리거되지 않습니다. 방향이 FALLING인 경우 관찰된 속성이 thresholdValue+offsetValue보다 클 때까지 경보가 다시 트리거되지 않습니다. 오프셋이 0인 경우에도 이 동작이 적용됩니다.

보안: 공통 에이전트 컨테이너를 시작한 사용자가 아닌 경우 어떠한 정보도 표시되지 않습니다.

thrsh-job create jobName object= objectName granularity=integerValue attributeName= attributeName attributeType=attributeType thresholdValue= thresholdValue thresholdOffset=offsetValue thresholdDirection= [RISING|FALLING]

단일 객체에서 하나의 속성을 모니터링하는 새 임계값 모니터링 작업을 만듭니다. 임계값 작업을 만들 경우 다음 매개 변수를 설정할 수 있습니다.

jobName

임계값 모니터링 작업을 고유하게 식별하는 문자열. jobName은 다른 임계값 모니터링 작업에서 이미 사용 중일 수 없습니다.

object=objectName

임계값 모니터링 작업이 임계값에 대해 비교하기 위해 속성 값을 수집하는 관찰 가능한 객체objectName은 thrsh-job list 또는 thrsh-job observable-objects 하위 명령이 표시하는 이름이어야 합니다.

granularity=integerValue

작업이 활성 작동인 도중에 두 개의 연속된 속성 값 관찰이 시작되는 시간 간격(초).

attributeName=attributeName

임계값 모니터링 작업이 임계값에 비교하기 위해 값을 수집하는 속성의 이름attributeName은 thrsh-job info 또는 thrsh-job observable-attributes 하위 명령에 의해 나열되어야 합니다.

attributeType=attributeType

모니터링할 관찰 가능한 속성의 유형. attributeType은 thrsh-job info 또는 thrsh-job observable-attributes 하위 명령에 의해 나열되어야 합니다.

thresholdValue=thresholdValue

thresholdDirection에 지정된 방향으로 초과할 경우 이 임계값 작업이 경보를 트리거하게 하는 모니터링된 속성의 값

thresholdOffset=offsetValue

offsetValue는 연속된 경보를 트리거하는 임계값 작업의 허용치를 결정합니다. offsetValue는 0 또는 양수 값이어야 합니다. 경보 이벤트가 트리거된 후 모니터링된 속성 값이 offsetValue 및 thresholdDirection에 정의된 범위를 초과할 때까지 새 경보 이벤트가 트리거되지 않습니다.

thresholdDirection=[RISING|FALLING]

방향이 RISING인 경우 관찰된 속성 값이 thresholdValue-offsetValue보다 작을 때까지 경보 이벤트가 다시 트리거되지 않습니다. 방향이 FALLING인 경우 관찰된 속성 값이 thresholdValue+offsetValue보다 클 때까지 경보 이벤트가 다시 트리거되지 않습니다. offsetValue가 0인 경우에도 이 동작이 적용됩니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

thrsh-job delete jobName

jobName이라는 임계값 모니터링 작업을 삭제합니다. jobName은 thrsh-job list 하위 명령이 표시하는 이름이어야 합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

thrsh-job suspend jobName

jobName이라는 임계값 모니터링 작업을 일시 중지합니다. 일시 중지된 작업은 활성 상태가 아니며 일정에 상관 없이 더 이상 데이터를 수집하지 않습니다. 그러나 작업은 정의된 상태로 유지되며 thrsh-job resume 하위 명령을 사용하여 다시 활성화할 수 있습니다. jobName은 thrsh-job list 하위 명령이 표시하는 이름이어야 합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

thrsh-job resume jobName

jobName이라는 임계값 모니터링 작업을 다시 시작합니다. 다시 시작된 작업은 데이터 수집을 시작하고 일정에 따라 보고서를 보냅니다. jobName은 thrsh-job list 하위 명령이 표시하는 이름이어야 합니다. 이 하위 명령은 thrsh-job suspend 하위 명령에 대응합니다.

보안: 이 하위 명령은 공통 에이전트 컨테이너를 시작한 사용자만 실행할 수 있습니다.

예

다음 가상 시나리오는 mfwkadm 유틸리티를 해당 옵션 및 하위 명령과 함께 사용하는 방법을 보여줍니다.

list-modules 하위 명령은 현재 호스트에 있는 Java ES 구성 요소 인스턴스와 공통 에이전트 컨테이너에 있는 해당 모듈을 보여줍니다. 다음 예에서는 설치된 두 개의 구성 요소, 즉 실행 중인 인스턴스가 없는 Directory Server와 실행 중인 하나의 인스턴스가 있는 Web Server를 나열합니다.

$ mfwkadm list-modules

Installed products and their running instances:
==============================================

Instances for installed product: com.sun.cmm.ds:collectionID=/opt/SUNWdsee/ds6,
name=Sun Java(TM) System Directory Server,type=CMM_InstalledProduct
-------------------------------

No instance.

Instances for installed product: com.sun.cmm.ws:collectionID=/var/opt/SUNWwbsvr7,
name=WebServer,type=CMM_InstalledProduct
-------------------------------

/wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,type=CMM_ApplicationSystem

다음 info 하위 명령은 Web Server 인스턴스의 관찰 가능한 객체를 각 작업 유형에 대한 클래스 및 관찰 가능한 속성과 함께 표시합니다.

$ mfwkadm info /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,\\
type=CMM_ApplicationSystem

Information about running instance: /wsPrefix/com.sun.cmm.ws:
name=https-hostname.example.com,type=CMM_ApplicationSystem
==================================

Observable objects for performance jobs:
---------------------------------------

+ Objects of class: com.sun.cmm.settings.CMM_ApplicationSystemSetting

        /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com-setting,
type=CMM_ApplicationSystemSetting

        Observable attributes:

        Caption [STRING]
        ConfigurationDirectory [STRING]
        CreationClassName [STRING]
        Description [STRING]
        DirectoryName [STRING]
        ElementName [STRING]
        InstanceID [STRING]
        Name [STRING]
        URL [STRING]

+ Objects of class: com.sun.cmm.settings.CMM_KeepAliveSetting

        /wsPrefix/com.sun.cmm.ws:name=process-1-keepalive-setting,
type=CMM_KeepAliveSetting

        Observable attributes:

        AllocationUnit [STRING]
        Caption [STRING]
        ConnectionsUpperBound [LONG]
        CreationClassName [STRING]
        Description [STRING]
        ElementName [STRING]
        InputUnit [STRING]
        InstanceID [STRING]
        LowerAllocationLimit [LONG]
        LowerInputLimit [LONG]
        LowerOutputLimit [LONG]
        Name [STRING]
        OtherAllocationUnit [STRING]
        OtherInputUnit [STRING]
        OtherLowerAllocationLimit [LONG]
        OtherLowerInputLimit [LONG]
        OtherLowerOutputLimit [LONG]
        OtherOutputUnit [STRING]
        OtherUpperAllocationLimit [LONG]
        OtherUpperInputLimit [LONG]
        OtherUpperOutputLimit [LONG]
        OutputUnit [STRING]
        QueuedUpperBound [LONG]
        SecondsTimeout [LONG]
        TimeoutUpperBound [LONG]
        UpperAllocationLimit [LONG]
        UpperInputLimit [LONG]
        UpperOutputLimit [LONG]
        ...

다음 명령은 정의된 성능 모니터링 작업의 목록을 보여줍니다. 이 예에는 하나의 객체를 모니터링하는 myPerfJob이라는 하나의 성능 작업이 있습니다.

$ mfwkadm pm-job list

BY_OBJECTS performance jobs:
===========================

Performance job information for: myPerfJob
-------------------------------

Type:                BY_OBJECTS
State:               ACTIVE_ON_DUTY
Granularity period:  30
Reporting period:    1
By event:            EVENT_SINGLE
By file:             EVENT_SINGLE
Report format:       XML
Schedule:           
        Global start time: Immediately
        Global stop time: Forever
        Weekly schedule: Everyday
        Daily schedule: All day
Observed objects:    
                /wsPrefix/com.sun.cmm.ws:name=virtualServer-hostname.example.com-
webApp-/-stats,type=CMM_VirtualServerWebModuleStats
Observed attributes: 
                All available

BY_CLASSES performance jobs:
===========================

No jobs found.

다음 명령은 opstat-job info 또는 opstat-job observable-objects 하위 명령에서 얻은 두 개의 관찰 가능한 객체와 관련된 작업 상태 모니터링 작업을 만듭니다.

$ mfwkadm opstat-job create myOpStatJob granularity=60 \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1,type=CMM_UnixProcess \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1-DNSCache1,type=CMM_DnsCache

다음 명령은 위에서 만든 작업을 일시 중지합니다.

$ mfwkadm opstat-job suspend myOpStatJob

다음 명령은 잠재적 임계값 모니터링 작업에 대한 관찰 가능한 클래스를 보여줍니다.

$ mfwkadm thrsh-job observable-classes

Threshold jobs observable classes:
=================================

com.sun.cmm.cim.CIM_ScopedSettingData
com.sun.cmm.cim.CIM_SettingData
com.sun.cmm.cim.CIM_StatisticalData
com.sun.cmm.cim.statistics.CIM_EthernetPortStatistics
com.sun.cmm.cim.statistics.CIM_NetworkPortStatistics
com.sun.cmm.cim.statistics.j2ee.CIM_J2eeJVMStats
com.sun.cmm.cim.statistics.j2ee.CIM_J2eeStatistic
com.sun.cmm.settings.CMM_ApplicationSystemSetting
com.sun.cmm.settings.CMM_KeepAliveSetting
com.sun.cmm.settings.CMM_QueueTimeoutSetting
com.sun.cmm.settings.CMM_RFC2788ApplicationSystemSetting
com.sun.cmm.settings.CMM_ScopedSettingData
com.sun.cmm.settings.CMM_SoftwareResourceSetting
com.sun.cmm.settings.CMM_SWRBufferSetting
com.sun.cmm.settings.CMM_SWRLimitSetting
com.sun.cmm.settings.CMM_SWRQueueSetting
com.sun.cmm.settings.CMM_VirtualServerSetting
com.sun.cmm.statistics.CMM_ApplicationSystemStats
com.sun.cmm.statistics.CMM_ApplicationSystemWatchdogStats
com.sun.cmm.statistics.CMM_ConnectionQueueStats
com.sun.cmm.statistics.CMM_DnsCacheStats
com.sun.cmm.statistics.CMM_EthernetPortStats
com.sun.cmm.statistics.CMM_FileCacheStats
com.sun.cmm.statistics.CMM_HTTPResponsesStats
com.sun.cmm.statistics.CMM_JVMJSR174ExtStats
com.sun.cmm.statistics.CMM_JVMJSR174Stats
com.sun.cmm.statistics.CMM_JVMStats
com.sun.cmm.statistics.CMM_NetworkPortStats
com.sun.cmm.statistics.CMM_OperatingSystemStats
com.sun.cmm.statistics.CMM_ProcessorStats
com.sun.cmm.statistics.CMM_ProcessStats
com.sun.cmm.statistics.CMM_QueueTimeoutStats
com.sun.cmm.statistics.CMM_RFC2788ApplicationTableStats
com.sun.cmm.statistics.CMM_ServiceStats
com.sun.cmm.statistics.CMM_SoftwareResourceStats
com.sun.cmm.statistics.CMM_SolarisEthernetPortStats
com.sun.cmm.statistics.CMM_SolarisNetworkPortStats
com.sun.cmm.statistics.CMM_SolarisOperatingSystemStats
com.sun.cmm.statistics.CMM_SolarisProcessorStats
com.sun.cmm.statistics.CMM_SolarisProcessorSysinfoStats
com.sun.cmm.statistics.CMM_SolarisProcessorVmStats
com.sun.cmm.statistics.CMM_Statistic
com.sun.cmm.statistics.CMM_SWRBufferStats
com.sun.cmm.statistics.CMM_SWRCacheStats
com.sun.cmm.statistics.CMM_SWRLimitStats
com.sun.cmm.statistics.CMM_SWRQueueStats
com.sun.cmm.statistics.CMM_UnixOperatingSystemStats
com.sun.cmm.statistics.CMM_UnixProcessStats
com.sun.cmm.statistics.CMM_VirtualServerWebModuleStats
com.sun.cmm.statistics.CMM_WebModuleStats

다음 명령은 이전 예에서 발견된 com.sun.cmm.statistics.CMM_SWRQueueStats 클래스의 객체를 모니터링하는 임계값 작업에 대한 관찰 가능한 속성을 보여줍니다.

$ mfwkadm thrsh-job observable-attributes \\
class=com.sun.cmm.statistics.CMM_SWRQueueStats

Threshold jobs observable attributes:
====================================

Class: com.sun.cmm.statistics.CMM_SWRQueueStats

Attributes: 

BufferSize [LONG]
EntriesCount [LONG]
EntriesHighWaterMark [LONG]
EntriesLowWaterMark [LONG]
EntriesTotal [LONG]
ErrorCount [INTEGER]
FailedOperations [LONG]
LowerLimit [LONG]
OperationsCount [LONG]
OtherLowerLimit [LONG]
OtherUpperLimit [LONG]
OverflowsCount [LONG]
QueuedCount [LONG]
QueuedHighWater [LONG]
SampleInterval [LONG]
TotalQueuedCount [LONG]
UpperLimit [LONG]

다음 명령은 작업 작성의 또 다른 예이고 여기서는 임계값 작업이 포함됩니다.

$ mfwkadm thrsh-job create myThreshJob granularity=30 \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-NativePool-stats,\\
type=CMM_SWRQueueStats attributeName=EntriesCount attributeType=LONG \\
thresholdValue=1000 thresholdOffset=10 thresholdDirection=RISING

다음 예는 이전 예에서 만들어진 임계값 모니터링 작업에 대한 thrsh-job info 하위 명령의 출력을 보여줍니다.

$ mfwkadm thrsh-job info myThreshJob

Threshold job information for: myThreshJob
-----------------------------

Type:                SIMPLE
State:               ACTIVE_ON_DUTY
Granularity period:  30
Schedule:           
        Global start time: Immediately
        Global stop time: Forever
        Weekly schedule: Everyday
        Daily schedule: All day
Alarm configuration:
                Type: QualityOfServiceAlarm
                Severity: INDETERMINATE
Threshold definition(s):
                Object: /wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-
NativePool-stats,type=CMM_SWRQueueStats
                        Attribute: EntriesCount [LONG]
                        Value: 1000
                        Direction: RISING
                        Offset: 10

종료 상태

다음 종료 값이 반환됩니다.

0

성공적으로 완료됨

1

오류가 발생함

속성

참조

cacao.5, cacaoadm.1m