13 JMX 모니터링

개요

JMX 모니터링은 Java 애플리케이션의 JMX 카운터를 모니터링하는 데 사용할 수 있습니다.

JMX 모니터링은 "Zabbix Java gateway"라고 불리는 Zabbix 데몬 형태로 Zabbix에서 기본적으로 지원됩니다.

호스트의 특정 JMX 카운터 값을 가져오기 위해, Zabbix 서버는 Zabbix Java gateway에 쿼리하며, 이는 다시 JMX management API 를 사용하여 관심 있는 애플리케이션을 원격으로 쿼리합니다.

자세한 내용과 설정에 대해서는 Zabbix Java gateway 섹션을 참조하세요.

Java 애플리케이션에서 원격 JMX 모니터링 활성화하기

Java 애플리케이션은 추가 소프트웨어 설치가 필요하지 않지만, 원격 JMX 모니터링을 지원하려면 아래에 지정된 명령줄 옵션으로 시작해야 합니다.

최소한의 설정으로, 보안이 적용되지 않은 로컬 호스트에서 간단한 Java 애플리케이션을 모니터링하기 시작하려면, 다음 옵션으로 시작하세요:

java \
-Dcom.sun.management.jmxremote \
-Dcom.sun.management.jmxremote.port=12345 \
-Dcom.sun.management.jmxremote.authenticate=false \
-Dcom.sun.management.jmxremote.ssl=false \
-Dcom.sun.management.jmxremote.registry.ssl=false \
-jar /path/to/your/application.jar

이렇게 하면 Java가 12345 포트에서 로컬 호스트로부터의 JMX 연결을 수신하고, 인증이나 SSL을 요구하지 않도록 설정됩니다.

다른 인터페이스에서의 연결을 허용하려면, -Djava.rmi.server.hostname 매개변수를 해당 인터페이스의 IP로 설정하세요.

보안에 대해 더 엄격하게 적용하려면, 사용할 수 있는 많은 다른 Java 옵션들이 있습니다. 예를 들어, 다음 예제는 더 다양한 옵션 세트로 애플리케이션을 시작하고 로컬 호스트뿐만 아니라 더 넓은 네트워크에 열어줍니다.

java \
-Djava.rmi.server.hostname=192.168.3.14 \
-Dcom.sun.management.jmxremote \
-Dcom.sun.management.jmxremote.port=12345 \
-Dcom.sun.management.jmxremote.authenticate=true \
-Dcom.sun.management.jmxremote.password.file=/etc/java-6-openjdk/management/jmxremote.password \
-Dcom.sun.management.jmxremote.access.file=/etc/java-6-openjdk/management/jmxremote.access \
-Dcom.sun.management.jmxremote.ssl=true \
-Dcom.sun.management.jmxremote.registry.ssl=true \
-Djavax.net.ssl.keyStore=$YOUR_KEY_STORE \
-Djavax.net.ssl.keyStorePassword=$YOUR_KEY_STORE_PASSWORD \
-Djavax.net.ssl.trustStore=$YOUR_TRUST_STORE \
-Djavax.net.ssl.trustStorePassword=$YOUR_TRUST_STORE_PASSWORD \
-Dcom.sun.management.jmxremote.ssl.need.client.auth=true \
-jar /path/to/your/application.jar

이러한 설정들의 대부분(전부는 아니더라도)은 $JRE/lib/management/management.properties 파일(또는 시스템에서 해당 파일이 위치한 곳)에서 지정할 수 있습니다.

SSL을 사용하려면, startup.sh 스크립트에 -Djavax.net.ssl.* 옵션을 Java 게이트웨이에 추가하여 수정해야 하며, 이렇게 해야 키 스토어와 트러스트 스토어를 어디서 찾을지 알 수 있습니다.

자세한 설명은 JMX를 사용한 모니터링 및 관리를 참조하세요.

Zabbix 프론트엔드에서 JMX 인터페이스 및 아이템 구성

Java 게이트웨이가 실행되고, 서버가 게이트웨이의 위치를 알고 있으며, 원격 JMX 모니터링을 지원하도록 Java 애플리케이션이 시작되었다면, 이제 Zabbix GUI에서 인터페이스와 아이템을 구성할 차례입니다.

JMX 인터페이스 구성

관심 있는 호스트에서 JMX 타입 인터페이스를 생성하는 것부터 시작합니다.

모든 필수 입력 필드는 빨간 별표로 표시됩니다.

JMX agent 항목 추가

관심 있는 각 JMX 카운터에 대해 해당 인터페이스에 연결된 JMX agent 항목을 추가합니다.

아래 스크린샷의 키는 jmx["java.lang:type=Memory","HeapMemoryUsage.used"]입니다.

모든 필수 입력 필드는 빨간색 별표로 표시됩니다.

JMX 항목에 대한 특정 정보가 필요한 필드는 다음과 같습니다:

"true" 또는 "false" 중 하나인 Boolean 카운터를 모니터링하려는 경우, 정보 유형을 "Numeric (unsigned)"로 지정하고 전처리 탭에서 "Boolean to decimal" 전처리 단계를 선택합니다. 서버는 Boolean 값을 각각 1 또는 0으로 저장합니다.

JMX 아이템 키에 대한 자세한 설명

단순 속성

MBean 객체 이름은 Java 애플리케이션에서 정의하는 단순한 문자열에 불과합니다. 반면에 속성 이름은 더 복잡할 수 있습니다. 속성이 원시 데이터 타입(정수, 문자열 등)을 반환하는 경우에는 걱정할 것이 없으며, 키는 다음과 같은 형태가 됩니다:

jmx[com.example:Type=Hello,weight]

이 예시에서 객체 이름은 "com.example:Type=Hello"이고, 속성 이름은 "weight"이며, 반환되는 값 타입은 아마도 "Numeric (float)"이어야 합니다.

복합 데이터를 반환하는 속성

속성이 복합 데이터를 반환할 때는 더 복잡해집니다. 예를 들어: 속성 이름이 "apple"이고 "weight", "color" 등과 같은 매개변수를 나타내는 해시를 반환한다고 가정합니다. 키는 다음과 같이 보일 수 있습니다:

jmx[com.example:Type=Hello,apple.weight]

이는 속성 이름과 해시 키가 점 기호를 사용하여 분리되는 방식입니다. 마찬가지로, 속성이 중첩된 복합 데이터를 반환하는 경우 부분들이 점으로 분리됩니다:

jmx[com.example:Type=Hello,fruits.apple.weight]

테이블 형태 데이터를 반환하는 속성

테이블 형태 데이터 속성은 하나 또는 여러 개의 복합 속성으로 구성됩니다. 이러한 속성이 속성 이름 매개변수에 지정되면, 이 항목 값은 속성의 완전한 구조를 JSON 형식으로 반환합니다. 테이블 형태 데이터 속성 내부의 개별 요소 값은 전처리를 사용하여 검색할 수 있습니다.

테이블 형태 데이터 속성 예제:

 jmx[com.example:type=Hello,foodinfo]

항목 값:

[
  {
    "a": "apple",
    "b": "banana",
    "c": "cherry"
  },
  {
    "a": "potato",
    "b": "lettuce",
    "c": "onion"
  }
]

점과 관련된 문제

지금까지는 문제없습니다. 하지만 속성 이름이나 해시 키에 점 기호가 포함되어 있다면 어떨까요? 다음은 예시입니다:

jmx[com.example:Type=Hello,all.fruits.apple.weight]

이것은 문제입니다. 속성 이름이 "all.fruits"인지, 아니면 단순히 "all"인지 Zabbix에게 어떻게 알려줄까요? 이름의 일부인 점과 속성 이름 및 해시 키를 구분하는 점을 어떻게 구별할까요?

이것은 가능합니다. 이름의 일부인 점을 백슬래시로 이스케이프하기만 하면 됩니다:

jmx[com.example:Type=Hello,all\.fruits.apple.weight]

마찬가지로, 해시 키에 점이 포함되어 있다면 이를 이스케이프합니다:

jmx[com.example:Type=Hello,all\.fruits.apple.total\.weight]

기타 이슈

속성명에 있는 백슬래시 문자는 이스케이프 처리해야 합니다:

jmx[com.example:type=Hello,c:\\documents]

JMX 아이템 키의 다른 특수 문자 처리에 대해서는 아이템 키 형식 섹션을 참조하세요.

실제로 이것이 전부입니다. 즐거운 JMX 모니터링 되세요!

비원시 데이터 타입

toString() 메서드를 오버라이드하는 비원시 데이터 타입을 반환하는 사용자 정의 MBean과 함께 작업하는 것이 가능합니다.

JBoss EAP 6.4에서 사용자 정의 엔드포인트 사용하기

사용자 정의 엔드포인트를 사용하면 기본 RMI가 아닌 다른 전송 프로토콜과 함께 작업할 수 있습니다.

이 기능을 설명하기 위해 예제로 JBoss EAP 6.4 모니터링을 구성해 보겠습니다. 먼저 몇 가지 가정을 해보겠습니다:

• Zabbix Java gateway가 이미 설치되어 있습니다. 설치되지 않았다면 문서에 따라 설치할 수 있습니다.
• Zabbix 서버와 Java gateway가 /usr/local/ 접두사로 설치되어 있습니다
• JBoss가 이미 /opt/jboss-eap-6.4/에 설치되어 있고 독립 실행 모드로 실행 중입니다
• 이 모든 구성 요소가 동일한 호스트에서 작동한다고 가정하겠습니다
• 방화벽과 SELinux가 비활성화되어 있습니다 (또는 적절히 구성되어 있습니다)

zabbix_server.conf에서 몇 가지 간단한 설정을 해보겠습니다:

JavaGateway=127.0.0.1
StartJavaPollers=5

그리고 zabbix_java/settings.sh 구성 파일(또는 zabbix_java_gateway.conf)에서:

START_POLLERS=5

JBoss가 표준 관리 포트에서 수신 대기하고 있는지 확인하세요:

$ netstat -natp | grep 9999
tcp        0      0 127.0.0.1:9999          0.0.0.0:*               LISTEN      10148/java

이제 Zabbix에서 JMX 인터페이스 127.0.0.1:9999를 가진 호스트를 생성해보겠습니다.

이 버전의 JBoss가 RMI 대신 JBoss Remoting 프로토콜을 사용한다는 것을 알고 있으므로, JMX 템플릿의 항목들에 대해 JMX 엔드포인트 매개변수를 일괄 업데이트할 수 있습니다:

service:jmx:remoting-jmx://{HOST.CONN}:{HOST.PORT}

구성 캐시를 업데이트해보겠습니다:

/usr/local/sbin/zabbix_server -R config_cache_reload

처음에는 오류가 발생할 수 있습니다.

"Unsupported protocol: remoting-jmx"는 Java gateway가 지정된 프로토콜로 작업하는 방법을 모른다는 의미입니다. 이는 다음 내용으로 ~/needed_modules.txt 파일을 생성하여 해결할 수 있습니다:

jboss-as-remoting
jboss-logging
jboss-logmanager
jboss-marshalling
jboss-remoting
jboss-sasl
jcl-over-slf4j
jul-to-slf4j-stub
log4j-jboss-logmanager
remoting-jmx
slf4j-api
xnio-api
xnio-nio

그런 다음 다음 명령을 실행합니다:

for i in $(cat ~/needed_modules.txt); do find /opt/jboss-eap-6.4 -iname "${i}*.jar" -exec cp '{}' /usr/local/sbin/zabbix_java/lib/ \; ; done

이제 Java gateway가 jmx-remoting과 함께 작업하는 데 필요한 모든 모듈을 갖게 됩니다. 남은 것은 Java gateway를 다시 시작하고 잠시 기다린 후, 모든 것을 올바르게 수행했다면 JMX 모니터링 데이터가 Zabbix에 도착하기 시작하는 것을 확인하는 것입니다 (참조: 최신 데이터).