[java] Java Jolokia를 사용하여 애플리케이션의 GC 로그 모니터링하기

23 Nov 2023

java

애플리케이션의 성능을 모니터링하고 문제를 해결하기 위해서는 GC(Garbage Collection) 로그를 살펴보는 것이 중요합니다. GC 로그는 Java 애플리케이션이 메모리를 관리하는 방식을 보여주고, 메모리 누수나 성능 문제를 파악하는 데 도움이 됩니다.

이번 블로그에서는 Java Jolokia를 사용하여 애플리케이션의 GC 로그를 모니터링하는 방법에 대해 알아보겠습니다.

Jolokia란?

Jolokia는 Java 애플리케이션에 대한 원격 관리 및 모니터링을 제공하는 오픈 소스 프로젝트입니다. Jolokia를 사용하면 애플리케이션의 내부 상태를 JSON 형태로 노출하고, RESTful API를 통해 액세스할 수 있습니다.

Jolokia를 사용하여 GC 로그 모니터링하기

다음은 Jolokia를 사용하여 애플리케이션의 GC 로그를 모니터링하는 단계입니다.

단계 1: Jolokia 라이브러리 추가

먼저, Maven이나 Gradle과 같은 빌드 도구를 사용하여 Jolokia 라이브러리를 프로젝트에 추가해야 합니다. 다음은 Maven을 사용하는 예시입니다.

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

단계 2: Jolokia 에이전트 설정

Jolokia 에이전트는 애플리케이션 JVM에 로드되어 애플리케이션의 상태를 모니터링할 수 있도록 합니다. 애플리케이션의 시작 스크립트에 다음과 같은 JVM 옵션을 추가하여 Jolokia 에이전트를 설정해야 합니다.

-javaagent:/path/to/jolokia-jvm-{version}.jar=port=8080

여기서 /path/to/jolokia-jvm-{version}.jar는 Jolokia 라이브러리의 경로 및 버전에 해당합니다. port는 Jolokia 에이전트가 바인딩할 포트 번호입니다.

단계 3: Jolokia API를 사용하여 GC 로그 모니터링

Jolokia의 API를 사용하여 GC 로그를 모니터링할 수 있습니다. 다음은 Java 코드에서 Jolokia를 사용하는 예시입니다.

import org.jolokia.client.J4pClient;
import org.jolokia.client.request.*;
import org.jolokia.client.exception.J4pException;

public class GcLogMonitor {

    public static void main(String[] args) {
        try {
            // Jolokia 클라이언트 생성
            J4pClient j4pClient = new J4pClient("http://localhost:8080/jolokia");

            // JMX 요청 생성
            J4pRequest request = new J4pRequestBuilder("java.lang:type=GarbageCollector,name=*", "gcInfo")
                    .build();

            // JMX 요청 전송
            J4pResponse<J4pReadResponse> response = j4pClient.execute(request);

            // 응답 처리
            if (response.getError() != null) {
                System.out.println("Error: " + response.getError().getMessage());
            } else {
                System.out.println("GC Info: " + response.getValue().toString());
            }
        } catch (J4pException e) {
            System.out.println("Exception: " + e.getMessage());
        }
    }
}

위의 예시 코드에서는 Jolokia 클라이언트를 생성하고, java.lang:type=GarbageCollector,name=* JMX 정보를 요청하여 GC 정보를 가져옵니다. Jolokia 클라이언트를 통해 GC 정보를 출력하게 됩니다.

단계 4: 애플리케이션 실행 및 모니터링

이제 애플리케이션을 실행하고 Jolokia 에이전트가 바인딩한 포트로 접근하여 GC 로그를 모니터링할 수 있습니다. 예를 들어, http://localhost:8080/jolokia에 접속하면 JSON 형식으로 모니터링 정보를 얻을 수 있습니다.

마무리

Java Jolokia를 사용하여 애플리케이션의 GC 로그를 모니터링하는 방법에 대해 알아보았습니다. Jolokia를 통해 애플리케이션의 상태를 쉽게 확인하고, 성능 문제를 식별하고 해결할 수 있습니다. 부가적으로 Jolokia를 사용하여 애플리케이션의 다른 상태도 모니터링할 수 있으니, 필요에 따라 활용해 보시기 바랍니다.