[java] Java Jolokia를 사용하여 원격으로 JMX MBean의 메서드 호출하기

23 Nov 2023

java

Java 애플리케이션에서 JMX (Java Management Extensions)를 사용하여 MBean에 정의된 메서드를 호출하는 것은 강력한 도구입니다. 그러나 때로는 애플리케이션의 JMX MBean에 원격으로 접근하여 메서드를 호출해야 할 수도 있습니다. 이때 Java Jolokia 라이브러리를 사용하면 편리하게 이 작업을 수행할 수 있습니다.

Jolokia란?

Jolokia는 JVM에 설치된 애플리케이션에 대한 원격 JMX 접속을 쉽게 지원하는 라이브러리입니다. Jolokia는 HTTP JSON API를 통해 애플리케이션의 MBean에 접근할 수 있도록 해주며, 이를 통해 메서드 호출이 가능합니다.

Jolokia 설정

Jolokia를 사용하기 위해서는 우선 애플리케이션에 Jolokia 라이브러리를 추가해야 합니다. Maven을 사용하는 경우 pom.xml에 다음 종속성을 추가해주세요.

<dependency>
    <groupId>org.jolokia</groupId>
    <artifactId>jolokia-core</artifactId>
    <version>1.7.0</version>
</dependency>

Jolokia를 사용하여 원격 MBean 메서드 호출하기

Jolokia를 사용하여 원격으로 MBean의 메서드를 호출하는 방법을 알아보겠습니다. 먼저 Jolokia 클라이언트를 초기화해야 합니다.

import org.jolokia.client.J4pClient;
import org.jolokia.client.exception.J4pException;
import org.jolokia.client.request.J4pExecRequest;
import org.jolokia.client.request.J4pExecResponse;

public class JolokiaExample {
    private static final String JMX_URL = "http://localhost:8080/jolokia";
    
    public static void main(String[] args) throws J4pException {
        J4pClient j4pClient = new J4pClient(JMX_URL);
    }
}

JMX_URL은 Jolokia 서버의 URL입니다.

이제 MBean의 메서드를 호출해보겠습니다.

J4pExecRequest request = new J4pExecRequest("javax.management:type=Memory", "gc");
J4pExecResponse response = j4pClient.execute(request);

위의 코드는 javax.management:type=Memory MBean의 gc 메서드를 호출하는 예제입니다. J4pExecRequest 객체를 생성하고, 해당 MBean의 이름과 호출할 메서드의 이름을 전달합니다.

응답을 확인하려면 J4pExecResponse 객체를 사용할 수 있습니다.

if (response.getError() != null) {
    System.out.println("Error: " + response.getError().getMessage());
} else {
    System.out.println("Success");
}

위의 코드는 호출 결과가 성공인지 실패인지를 확인하여 적절한 메시지를 출력합니다.

마치며

이제 Java Jolokia를 사용하여 원격으로 JMX MBean의 메서드를 호출하는 방법에 대해 알아보았습니다. Jolokia는 원격 JMX 작업을 쉽게 처리할 수 있는 강력한 도구이며, Java 애플리케이션의 모니터링과 관리에 유용하게 사용될 수 있습니다.

Jolokia란?

Jolokia 설정

Jolokia를 사용하여 원격 MBean 메서드 호출하기

마치며

참고자료