이전 항목: 기본 TIBCO EMS 경고 보기다음 항목: webMethods Broker 모니터링


에이전트 구성 속성 요약

EMSMonitor 에이전트는 TibcoEMSMonitor.properties 파일에 있는 여러 구성 속성을 사용하여 연결할 EMS 서버 인스턴스와 모니터링할 구성 요소를 정의합니다. 다음 목록에서는 유효한 값을 설정하기 위해 빠르게 참조할 수 있도록 이러한 속성의 요약을 제공하고 각 속성에 허용되는 값의 유형을 설명합니다.

여러 구성 속성에서 패턴 일치를 위해 정규식을 지정할 수 있습니다. 정규식 구문 및 유효한 구조에 대한 요약을 보려면 Java 설명서에서 패턴 일치 관련 정보를 참조하십시오.

ems.server.list

모니터링하고자 하는 EMS 서버 인스턴스 이름의 쉼표로 구분된 목록입니다.

지정한 이름이 모니터링하려는 서버 인스턴스의 실제 이름과 일치할 필요는 없습니다. 예를 들어 이름이 같지만 포트가 다른 두 서버 인스턴스가 있는 경우 ems.server.list 속성에서 별칭을 사용하여 두 인스턴스를 구분할 수 있습니다.

예:

ems.server.list=mercury01,mercury02,jupiter03
<ServerInstance>.host

지정된 서버 인스턴스를 호스팅하는 EMS 서버의 호스트 이름 또는 IP 주소입니다. 기본값은 localhost입니다.

예:

mercury01.host=winsrvT400
<ServerInstance>.port

지정된 서버 인스턴스를 호스팅하는 EMS 서버의 포트 번호입니다. 기본값은 7222입니다.

예:

mercury01.port=7200
<ServerInstance>.username

관리자 권한이 있으며 EMS 서버에 연결하는 데 사용할 사용자 이름입니다. 이 속성은 대개 emsPwdEncryptor 유틸리티를 사용하여 계정의 암호를 암호화할 때 설정됩니다.

기본값은 admin입니다.

예:

mercury01.username=jgarcia
<ServerInstance>.password

<ServerInstance>.username 속성에 지정된 사용자 계정의 암호입니다. 이 속성은 대개 emsPwdEncryptor 유틸리티를 사용하여 계정의 암호를 암호화할 때 설정됩니다.

기본값은 빈 문자열(암호 없음)입니다.

예:

mercury01.password=YCLhqcwQfpc=
<ServerInstance>.delaytime

모니터링 중인 EMS 서버 구성 요소의 메트릭을 새로 고치기 위해 EMS 서버에 대한 쿼리를 수행하는 시간 간격(초)입니다.

이 간격마다 EMSMonitor 에이전트가 서버 인스턴스 및 해당 구성 요소의 상태 관련 메트릭을 수집합니다.

기본값은 60초입니다.

예:

mercury01.delaytime=90
<ServerInstance>.report.static.freq

정적 메트릭에 대한 쿼리 사이에 수행할 EMS 서버 상태 쿼리의 수입니다. 예를 들어 이 속성이 20으로 설정되어 있으면 EMSMonitor 에이전트가 메트릭을 20번 수집할 때마다 정적 구성 관련 메트릭이 새로 고쳐집니다.

기본값은 20입니다.

예:

mercury01.report.static.freq=50
<ServerInstance>.queue.filter.includeonly.regex

정규식을 지정하여 이 표현식과 이름이 일치하는 큐를 모니터링합니다. 유효한 모든 정규식을 사용할 수 있습니다. 일부 특수 문자는 이스케이프 처리해야 합니다.

이 속성을 사용하여 필터를 지정하지 않으면 기본적으로 EMSMonitor 에이전트는 모든 큐의 메트릭을 수집합니다.

예:

mercury01.queue.filter.includeonly.regex=[A-H]
<ServerInstance>.topic.filter.includeonly.regex

정규식을 지정하여 이 표현식과 이름이 일치하는 항목을 모니터링합니다. 유효한 모든 정규식을 사용할 수 있습니다. 일부 특수 문자는 이스케이프 처리해야 합니다.

이 속성을 사용하여 필터를 지정하지 않으면 기본적으로 EMSMonitor 에이전트는 모든 항목의 메트릭을 수집합니다.

예:

mercury01.topic.filter.includeonly.regex=[a-hA-H]
<ServerInstance>.queue.filter.include.dynamic

이 EMS 서버 인스턴스의 동적 큐를 모니터링할지 여부를 지정합니다. 동적 큐의 메트릭을 포함하려면 이 속성을 true로 설정합니다.

기본적으로 EMSMonitor 에이전트는 정적 큐만 모니터링합니다.

예:

mercury01.queue.filter.include.dynamic=true
<ServerInstance>.topic.filter.include.dynamic

이 EMS 서버 인스턴스의 동적 항목을 모니터링할지 여부를 지정합니다. 동적 항목의 메트릭을 포함하려면 이 속성을 true로 설정합니다.

기본적으로 EMSMonitor 에이전트는 정적 항목만 모니터링합니다.

예:

mercury01.topic.filter.include.dynamic=true
<ServerInstance>.monitor.bridges

이 EMS 서버 인스턴스의 브리지를 모니터링할지 여부를 지정합니다. 브리지의 메트릭을 포함하려면 이 속성을 true로 설정합니다.

기본적으로 EMSMonitor 에이전트는 브리지를 모니터링하지 않습니다.

예:

mercury01.monitor.bridges=true
<ServerInstance>.monitor.channels

이 EMS 서버 인스턴스의 멀티캐스트 채널을 모니터링할지 여부를 지정합니다. 채널의 메트릭을 포함하려면 이 속성을 true로 설정합니다.

기본적으로 EMSMonitor 에이전트는 채널을 모니터링하지 않습니다.

예:

mercury01.monitor.channels=true
<ServerInstance>.monitor.routes

이 EMS 서버 인스턴스의 라우트를 모니터링할지 여부를 지정합니다. 라우트의 메트릭을 포함하려면 이 속성을 true로 설정합니다.

기본적으로 EMSMonitor 에이전트는 라우트를 모니터링하지 않습니다.

예:

mercury01.monitor.routes=true
<ServerInstance>.bridge.filter.includeonly.regex

정규식을 지정하여 이 표현식과 이름이 일치하는 브리지를 모니터링합니다. 유효한 모든 정규식을 사용할 수 있습니다. 일부 특수 문자는 이스케이프 처리해야 합니다.

<ServerInstance>.monitor.bridges 속성이 true로 설정되어 있고 이 속성을 사용하여 필터를 지정하지 않은 경우 기본적으로 EMSMonitor 에이전트는 모든 브리지에 대한 메트릭을 수집합니다.

예:

mercury01.bridge.filter.includeonly.regex=test.*
<ServerInstance>.channel.filter.includeonly.regex

정규식을 지정하여 이 표현식과 이름이 일치하는 채널을 모니터링합니다. 유효한 모든 정규식을 사용할 수 있습니다. 일부 특수 문자는 이스케이프 처리해야 합니다.

<ServerInstance>.monitor.channels 속성이 true로 설정되어 있고 이 속성을 사용하여 필터를 지정하지 않은 경우 기본적으로 EMSMonitor 에이전트는 모든 채널에 대한 메트릭을 수집합니다.

예:

mercury01.channel.filter.includeonly.regex=test.*
<ServerInstance>.route.filter.includeonly.regex

정규식을 지정하여 이 표현식과 이름이 일치하는 라우트를 모니터링합니다. 유효한 모든 정규식을 사용할 수 있습니다. 일부 특수 문자는 이스케이프 처리해야 합니다.

<ServerInstance>.monitor.routes 속성이 true로 설정되어 있고 이 속성을 사용하여 필터를 지정하지 않은 경우 기본적으로 EMSMonitor 에이전트는 모든 라우트에 대한 메트릭을 수집합니다.

예:

mercury01.route.filter.includeonly.regex=test.*
<ServerInstance>.monitoring.level

EMS 서버 인스턴스에 대한 모니터링 수준을 정의합니다. 이 속성의 유효한 설정은 minimum, recommendedfull입니다.

기본 서버 모니터링 수준은 recommended입니다.

예:

mercury01.monitoring.level=minimum
<ServerInstance>.queue.monitoring.level

EMS 서버 인스턴스의 큐에 대한 모니터링 수준을 정의합니다. 이 속성의 유효한 설정은 minimum, recommendedfull입니다.

기본 큐 모니터링 수준은 recommended입니다.

예:

mercury01.queue.monitoring.level=recommended
<ServerInstance>.topic.monitoring.level

EMS 서버 인스턴스의 항목에 대한 모니터링 수준을 정의합니다. 이 속성의 유효한 설정은 minimum, recommendedfull입니다.

기본 항목 모니터링 수준은 recommended입니다.

예:

mercury01.topic.monitoring.level=full
client.identity

EMS 서버가 EMSMonitor 에이전트의 ID를 검증하는 데 사용할 수 있는 인증서의 경로를 지정합니다. 대부분의 경우 이 속성은 emsPwdEncryptor 프로그램을 실행할 때 설정됩니다.

예:

client.identity=C:/TibcoEMSMonitor/certs/client.p12
ssl.password

클라이언트 보안 인증서의 암호화된 암호를 지정합니다.

대부분의 경우 이 속성은 emsPwdEncryptor 프로그램을 실행할 때 설정됩니다.

<ServerInstance>.ssl.connection

SSL(Secure Socket Layer) 프로토콜을 사용하여 서버 인스턴스에 연결할지 여부를 지정합니다.

SSL을 사용하여 서버 인스턴스에 연결하려면 이 속성을 enable로 설정합니다. 비보안 연결을 허용하려면 이 속성을 disable로 설정합니다.

보안 관련 속성에는 기본값이 없습니다.

<ServerInstance>.verify.host

EMSMonitor 에이전트가 EMS 서버의 인증서를 확인할지 여부를 지정합니다. 에이전트가 trusted.certificates 속성에 정의된 목록을 사용하여 EMS 서버의 보안 인증서를 확인해야 한다면 이 속성을 true로 설정합니다.

보안 관련 속성에는 기본값이 없습니다.

예를 들어 에이전트가 EMS 서버 인스턴스 mercury01에 연결할 때 검증을 요구하도록 하려면 다음과 같이 합니다.

mercury01.verify.host=true
trusted.certificates

EMSMonitor 에이전트가 서버의 인증서를 검증하는 데 사용할 신뢰할 수 있는 인증서의 쉼표로 구분된 목록을 지정합니다. verify.host 속성이 true로 설정되어 있으면 이 속성이 필요하며, 이 속성은 SSL을 사용하는 모든 EMS 서버 인스턴스에 적용할 수 있습니다.

보안 관련 속성에는 기본값이 없습니다.

<ServerInstance>.verify.hostname

에이전트가 서버 인증서의 CN(Common Name) 필드를 확인할지 여부를 지정합니다.

에이전트가 연결된 호스트의 이름이나 <ServerInstance>.expected.name 속성에 지정된 이름을 서버 인증서의 CN(Common Name) 필드와 비교하게 하려면 이 속성을 true로 설정합니다. 이 속성이 true로 설정되어 있고 이름이 일치하지 않으면 에이전트가 연결을 거부합니다.

보안 관련 속성에는 기본값이 없습니다.

<ServerInstance>.expected.hostname

EMSMonitor 에이전트가 서버 인증서의 CN(Common Name) 필드에서 찾아야 하는 이름을 지정합니다.

보안 관련 속성에는 기본값이 없습니다.

cipher.suites

EMSMonitor 에이전트가 SSL 기반 EMS 서버와의 통신을 암호화하는 데 사용할 수 있는 암호 그룹의 쉼표로 구분된 목록을 지정합니다. EMSMonitor 에이전트는 모니터링 중인 EMS 서버에서 지원하는 모든 암호화 패키지를 사용할 수 있습니다. 이 속성을 설정하면 모든 SSL 기반 EMS 서버 인스턴스에 설정이 적용됩니다.

보안 관련 속성에는 기본값이 없습니다.