[java] Java Jolokia와 Graylog 연동하는 방법은?

23 Nov 2023

java

Java Jolokia는 원격 JMX(Monitoring and Management Extensions) 접근을 가능하게 해주는 오픈 소스 라이브러리이며, Graylog는 로그 관리 플랫폼입니다. 이들을 함께 사용하면 Java 애플리케이션의 JMX 속성을 Graylog로 전송하여 중앙에서 모니터링할 수 있습니다.

이번 가이드에서는 Java Jolokia를 사용하여 Graylog와 연동하는 방법을 소개하겠습니다.

1. Jolokia 설치 및 구성

먼저, Jolokia를 설치하고 구성해야 합니다. 다음 단계를 따라 진행해주세요.

Jolokia 웹 사이트에서 최신 버전의 Jolokia 에이전트 다운로드합니다.
Java 애플리케이션의 클래스패스에 Jolokia 에이전트 JAR 파일을 추가합니다.
Jolokia 구성 파일을 생성합니다. (예: jolokia.properties)
Jolokia 구성 파일에 Graylog 서버의 주소와 포트를 설정합니다.

# jolokia.properties

# Graylog 서버 주소와 포트
jolokia.ctx.connector = server
jolokia.ctx.serverUrl = http://graylog-server:9000/api/jolokia

2. Graylog 구성

Jolokia가 Java 애플리케이션과 통신할 수 있도록 Graylog를 구성해야 합니다.

Graylog 웹 인터페이스에 로그인합니다.
시스템 메뉴에서 “Inputs”을 선택합니다.
“Manage inputs” 버튼을 클릭합니다.
“Launch new input” 드롭다운 메뉴에서 “GELF HTTP”를 선택합니다.
“Global” 탭에서 “Port number”를 Java 애플리케이션이 연결할 포트로 설정합니다. (예: 8080)
“Save” 버튼을 클릭하여 구성을 저장합니다.

3. Java 애플리케이션에 Jolokia 추가

이제 Java 애플리케이션에 Jolokia를 추가하여 Graylog와 연동할 준비가 거의 끝났습니다.

Java 애플리케이션의 pom.xml 파일에 Jolokia 의존성을 추가합니다.

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

애플리케이션 코드에서 Jolokia를 초기화하고 Graylog로 데이터를 전송하는 코드를 추가합니다.

// Jolokia 클라이언트 초기화
J4pClient j4pClient = new J4pClient("http://graylog-server:9000/api/jolokia");

// Jolokia 요청 생성
J4pExecRequest request = new J4pExecRequest("java.lang:type=Memory", "gc");

// Jolokia 요청 실행 및 Graylog로 전송
J4pResponse<J4pExecRequest> response = j4pClient.execute(request);

위 코드는 Java 애플리케이션의 java.lang:type=Memory MBean에서 gc 메소드를 실행하여 가비지 컬렉션을 수행한 후 Graylog로 결과를 전송하는 예시입니다. 필요에 따라 Jolokia 클라이언트 코드를 수정하여 다른 JMX 속성을 모니터링하고 Graylog로 전송할 수 있습니다.

결론

Java 애플리케이션의 JMX 속성을 Graylog로 전송하여 중앙에서 모니터링하기 위해 Java Jolokia와 Graylog를 연동하는 방법에 대해 알아보았습니다. Jolokia를 설치 및 구성하고 Graylog를 구성한 후 Java 애플리케이션에서 Jolokia를 사용하여 Graylog로 데이터를 전송할 수 있습니다.

이 외에도 Jolokia는 다양한 기능과 설정을 제공하므로 공식 문서를 참고하여 더 자세한 내용을 확인할 수 있습니다.