웹 애플리케이션 서버

Wildfly

설치

Wildfly는 다음의 공식 문서를 참고하여 설치합니다.

https://www.wildfly.org/

HyperFrame 21은 Wildfly 22 버전 이상만 지원합니다.

Java Agent 설정

Wildfly가 설치된 경로에서 bin 디렉터리 하위의 standalone.conf에 javaagent를 설정합니다.

다음은 설정 예시입니다.

JAVA_OPTS="$JAVA_OPTS -javaagent:/agent-home/opentelemetry-javaagent.jar -Dotel.resource.attributes=service.name=myService,service.instance.id=myInstance,provider.type=wildfly -Dotel.javaagent.debug=true -Dotel.exporter.otlp.endpoint=http://localhost:4317 -Dotel.exporter.otlp.metrics.temporality.preference=DELTA -Dotel.metric.export.interval=10000 -Dio.opentelemetry.javaagent.slf4j.simpleLogger.logFile=/agent-home/agent.log"

웹 서버 연동

모니터링 대상인 Wildfly와 웹 서버를 연결하여 하나의 트레이스로 볼 수 있습니다.

  1. Wildfly가 설치된 경로에서 standalone/configuration/standalone.xml 파일에 ajp-listener를 추가합니다.

    <subsystem xmlns="urn:jboss:domain:undertow:14.0" ... >
    <byte-buffer-pool name="default"/>
    <buffer-cache name="default"/>
    <server name="default-server">
    <!--추가-->
    <ajp-listener name="ajp" scheme="http" socket-binding="ajp" />

  2. Wildfly를 재기동합니다.

Tomcat

설치

Tomcat은 다음의 공식 문서를 참고하여 설치합니다.

https://tomcat.apache.org/

HyperFrame 21은 Tomcat 9 버전 이상만 지원합니다.

Java Agent 설정

Tomcat이 설치된 경로에서 bin 디렉터리 하위의 setenv.sh 또는 catalina.sh에 javaagent를 설정합니다.

다음은 설정 예시입니다.

export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/agent-home/opentelemetry-javaagent.jar -Dotel.resource.attributes=service.name=myService,service.instance.id=myInstance,provider.type=tomcat -Dotel.javaagent.debug=true -Dotel.exporter.otlp.endpoint=http://localhost:4317 -Dotel.exporter.otlp.metrics.temporality.preference=DELTA -Dotel.metric.export.interval=10000 -Dio.opentelemetry.javaagent.slf4j.simpleLogger.logFile=/agent-home/agent.log"

웹 서버 연동

모니터링 대상인 Tomcat과 웹 서버를 연결하여 하나의 트레이스로 볼 수 있습니다.

  1. Tomcat이 설치된 경로에서 server.xml 파일에 AJP Connector 부분을 수정합니다.

    <Connector protocol="AJP/1.3"
    address="0.0.0.0"
    port="8009"
    redirectPort="8443"
    maxParameterCount="1000"
    secretRequired="false"
    />

  2. Tomcat을 재기동합니다.