• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

JVM 인수와 Java 에이전트 포함시키는 방법

이 문서에서는 프레임워크의 JVM에 -javaagent 인수를 전달하는 방법을 설명합니다. 이 설치 단계는에이전트가 앱에 포함되도록 합니다. 모든 앱 서버에 대해 newrelic.jar 파일의 전체 경로를 전달해야 합니다.

이 문서는 인수를 전달하는 방법에 대한 참조용일 뿐입니다. 보다 자세한 설치 절차는 Java 에이전트 설치를 참조하세요.

ColdFusion

ColdFusion에서 -javaagent 인수를 전달하려면:

  1. ColdFusion 서버를 시작하고 ColdFusion 관리 콘솔로 이동합니다.

  2. 왼쪽 메뉴에서 SERVER SETTINGS > Java and JVM을 선택합니다.

  3. 에이전트 API를 사용하는 경우: ColdFusion Class Path 필드에서 newrelic-api.jar로의 경로를 지정합니다.

  4. JVM Arguments 필드에 -javaagent 인수를 추가합니다.

    -javaagent:/full/path/to/newrelic.jar
  5. Submit Changes를 선택한 다음 ColdFusion 서버를 다시 시작합니다.

Geronimo

Geronimo에서 -javaagent 인수를 전달하려면 시작 명령을 실행할 때 JAVA_OPTS 환경 변수에서 뉴렐릭 에이전트 jar를 참조하세요.

bash
$
export JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar" && geronimo run

Glassfish

Glassfish에서 -javaagent 인수를 전달하려면:

  1. Glassfish 콘솔에서 Application Server > JVM Settings > JVM options를 선택합니다.

  2. JVM 옵션 페이지에서 Add JVM option을 선택합니다.

  3. -javaagent 인수에 대한 항목을 추가합니다.

    -javaagent:/full/path/to/newrelic.jar
  4. Glassfish를 저장하고 다시 시작합니다.

Glassfish가 시작되지 않으면 -javaagent 인수가 올바르게 설정되지 않았을 수 있습니다. domain.xml 파일을 수정하여 서버 JVM 인수를 변경할 수 있습니다.

중요

Glassfish 2.1의 버그로 인해 부트스트랩 클래스 로더(뉴렐릭 에이전트)의 클래스는 Java 로깅 API를 사용하지 못합니다. 이는 2.1.1 이상 릴리스에서 수정된 것으로 보입니다.

Grails

Grails에서 -javaagent 인수를 전달하려면:

JBoss

JBoss에서 -javaagent 인수를 전달하려면:

Jetty

Jetty에서 -javaagent 인수를 전달하려면:

Play

Play에서 -javaagent 인수를 전달하려면:

Resin

Java 8

  • 옵션 1: 서버의 resin.properties 파일에 있는 jvmargs 속성을 사용해 javaagent 인수를 추가합니다.
    jvm_args : -javaagent:/full/path/to/newrelic.jar
  • 옵션 2: conf/resin.conf 또는 conf/resin.xml 파일의 <jvm-args> 섹션에 추가함으로써 -javaagent 인수를 지정합니다.
    <jvm-arg>-javaagent:/full/path/to/newrelic.jar</jvm-arg>

Java 9 이상

Java 9에 도입된 모듈 시스템은 -javaagent 속성이 conf/resin.conf 또는 conf/resin.xml 파일에 추가되면 예외 NoClassDefFoundError: java/sql/SQLException이 발생할 수 있습니다. Java 9 이상을 사용하는 경우 -javaagent 속성이 해당 파일에 포함되어 있지 않은지 확인하세요.

Resin은 다음 옵션 중 하나를 사용하는 Java 에이전트와 함께 Java 9 이상에서 실행할 수 있습니다.

  • 옵션 1: 서버의 resin.properties 파일에 있는 jvmargs 속성을 사용해 javaagent 인수를 추가합니다.

    jvm_args : -javaagent:/full/path/to/newrelic.jar

    그러면 Resin 서버가 ./bin/resin.sh start로 실행될 수 있습니다.

  • 옵션 2: 명령줄에서 -javaagent 속성을 사용하여 Resin Jar를 실행합니다.

    bash
    $
    java -javaagent:/path/to/newrelic.jar -jar lib/resin.jar start

중요

Java 9 이상을 사용하는 경우 에이전트가 Windows에서 Resin과 함께 작동하지 않습니다.

Solr

Solr-javaagent 인수를 전달하려면:

Spring Boot

Spring Boot에서 -javaagent 인수를 전달하려면 이를 앱을 시작하는 명령줄에 추가합니다. -jar 인수 앞에 추가해야 합니다.

bash
$
java -javaagent:/full/path/to/newrelic.jar -jar app.jar

Tanuki Wrapper

Tanuki Wrapper에서 -javaagent 인수를 전달하려면 래퍼 옵션 wrapper.conf을 추가합니다. 아래 줄에서 이 파일에서 사용하지 않는 번호를 XXX로 대체합니다.

wrapper.java.additional.XXX=-javaagent:/full/path/to/newrelic.jar

Linux 시스템에서는 이 값을 설정할 때 따옴표가 필요하지 않습니다. 이는 운영 체제마다 다를 수 있습니다.

Tomcat

Tomcat에서 -javaagent 인수를 전달하려면:

WebLogic

WebLogic에서 -javaagent 인수를 전달하려면:

WebSphere

WebSphere에서 -javaagent 인수를 전달하려면:

  1. 관리 콘솔에서 Servers > Application servers > (select a server) > Configuration > Service Infrastructure > Java and Process Management를 선택합니다.

  2. Process Definition > Additional Properties를 선택한 다음 Java Virtual Machine를 클릭합니다.

  3. Generic JVM arguments 필드에서 newrelic.jar 파일에 대한 -javaagent 인수를 추가합니다.

    -javaagent:/full/path/to/newrelic.jar
  4. Apply를 선택한 다음 Save를 클릭합니다.

  5. 서버를 다시 시작합니다.

보다 자세한 정보는 WebSphere PMI 메트릭 수집에 대한 문서를 참조하십시오.

WebSphere Community

WebSphere Community Edition에서 -javaagent 인수를 전달하려면 시작 명령을 실행할 때 JAVA_OPTS 환경 변수에서 뉴렐릭 에이전트 jar를 참조합니다.

bash
$
export JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar" && startup

WebSphere Liberty Profile

WebSphere Liberty Profile에서 -javaagent 인수를 전달하려면:

  1. ${server.config.dir}/jvm.options를 수정합니다.

  2. newrelic.jar 파일을 가리키도록 -javaagent 인수를 추가합니다.

    -javaagent:/full/path/to/newrelic.jar
  3. 서버를 다시 시작합니다.

Wildfly

Wildfly에서 -javaagent 인수를 전달하려면(Wildfly 11 이상을 사용하는 경우 추가 설치 지침 참조):

기타 애플리케이션 서버

뉴렐릭 Java 에이전트는 지원되는 모든 앱 서버에서 작동합니다. 이 문서에 포함되지 않은 앱 서버의 경우 앱 서버에 대한 표준 절차에 따라 앱 jar 전에 이 인수를 JVM으로 전달하세요.

-javaagent:/full/path/to/newrelic.jar
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.