[java] Java Jolokia를 사용하여 자바 애플리케이션의 로그 정보를 수집하는 방법은?

23 Nov 2023

java

Java 애플리케이션에서 로그 정보를 수집하고 모니터링하는 것은 중요한 작업입니다. Java Jolokia를 사용하면 애플리케이션의 로그 정보를 손쉽게 수집할 수 있습니다. Java Jolokia는 JMX (Java Management Extensions)를 사용하여 애플리케이션의 데이터를 JSON 형식으로 제공합니다.

이번 가이드에서는 Java Jolokia를 사용하여 로그 정보를 수집하는 방법에 대해 알아보겠습니다.

1. Jolokia 라이브러리 추가하기

Java 프로젝트에서 Jolokia를 사용하기 위해서는 먼저 Jolokia 라이브러리를 프로젝트에 추가해야 합니다. Maven을 사용한다면 pom.xml 파일에 다음 의존성을 추가합니다.

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

Gradle을 사용한다면 build.gradle 파일에 다음 의존성을 추가합니다.

implementation 'org.jolokia:jolokia-core:1.6.2'

의존성을 추가한 후 프로젝트를 다시 빌드해야 합니다.

2. Jolokia Agent 시작하기

Java 애플리케이션에 Jolokia Agent를 연결하려면 JVM 옵션에 Jolokia 에이전트를 추가해야 합니다. 이를 위해 다음과 같은 JVM 옵션을 추가하세요.

-javaagent:/path/to/jolokia-jvm.jar=port=8778

/path/to/jolokia-jvm.jar를 Jolokia JAR 파일의 경로로 변경하세요. port=8778은 Jolokia 에이전트가 사용할 포트 번호로, 필요에 따라 다른 포트 번호로 변경할 수 있습니다.

3. 로그 정보 수집하기

Jolokia 에이전트를 등록한 후에는 Jolokia API를 사용하여 로그 정보를 수집할 수 있습니다. Jolokia API를 사용하기 위해 HTTP 요청을 보내고 JSON 응답을 받아 처리하는 방법은 다음과 같습니다.

3.1. HTTP 요청 보내기

다음은 Jolokia 에이전트로부터 로그 정보를 얻기 위해 HTTP GET 요청을 보내는 방법입니다.

import org.apache.http.client.fluent.Request;

public class LogCollector {
    
    public String collectLogs() throws IOException {
        String url = "http://localhost:8778/jolokia/read/java.util.logging:type=Logging/Logger/*";

        return Request.Get(url)
                .execute()
                .returnContent()
                .asString();
    }
}

3.2. JSON 응답 처리하기

받은 JSON 응답을 파싱하여 로그 정보를 처리할 수 있습니다.

import com.google.gson.Gson;

public class LogProcessor {

    public void processLogs(String json) {
        Gson gson = new Gson();
        LogResponse logResponse = gson.fromJson(json, LogResponse.class);

        // 로그 정보 처리
        for (LoggerInfo loggerInfo : logResponse.getLoggerInfo()) {
            String loggerName = loggerInfo.getName();
            List<LogRecord> logRecords = loggerInfo.getLogRecords();

            // 로그 정보 출력 또는 다른 처리 작업 수행
            System.out.println("Logger: " + loggerName);
            for (LogRecord logRecord : logRecords) {
                System.out.println("Log: " + logRecord.getMessage());
            }
        }
    }
}

3.3. LogResponse 및 필요한 클래스 정의하기

위의 LogProcessor 클래스에서 사용된 LogResponse, LoggerInfo, LogRecord 클래스는 다음과 같이 정의되어야 합니다.

import java.util.List;

public class LogResponse {

    private List<LoggerInfo> loggerInfo;

    public List<LoggerInfo> getLoggerInfo() {
        return loggerInfo;
    }

    public void setLoggerInfo(List<LoggerInfo> loggerInfo) {
        this.loggerInfo = loggerInfo;
    }
}

public class LoggerInfo {

    private String name;
    private List<LogRecord> logRecords;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public List<LogRecord> getLogRecords() {
        return logRecords;
    }

    public void setLogRecords(List<LogRecord> logRecords) {
        this.logRecords = logRecords;
    }
}

public class LogRecord {

    private String message;
    // 필요한 다른 속성

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    // 필요한 다른 Getter/Setter 메서드
}

4. 로그 정보 수집 실행하기

로그 정보를 수집하고 처리하기 위해 다음과 같이 LogCollector 및 LogProcessor 클래스를 실행할 수 있습니다.

import java.io.IOException;

public class Main {

    public static void main(String[] args) {
        LogCollector logCollector = new LogCollector();
        LogProcessor logProcessor = new LogProcessor();

        try {
            String json = logCollector.collectLogs();
            logProcessor.processLogs(json);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위의 LogCollector 클래스에서는 Jolokia에 정의된 MBean에 따라 로그 정보를 수집합니다. 필요에 따라 MBean의 경로나 추가적인 정보를 변경하여 로그 정보를 수집할 수 있습니다.

참고 자료

Jolokia Documentation