이 문서에서는 프레임워크의 JVM에 -javaagent
인수를 전달하는 방법을 설명합니다. 이 설치 단계는에이전트가 앱에 포함되도록 합니다. 모든 앱 서버에 대해 newrelic.jar
파일의 전체 경로를 전달해야 합니다.
이 문서는 인수를 전달하는 방법에 대한 참조용일 뿐입니다. 보다 자세한 설치 절차는 Java 에이전트 설치 를 참조하세요.
ColdFusion ColdFusion에서 -javaagent
인수를 전달하려면:
ColdFusion 서버를 시작하고 ColdFusion 관리 콘솔로 이동합니다.
왼쪽 메뉴에서 SERVER SETTINGS > Java and JVM 을 선택합니다.
에이전트 API를 사용하는 경우: ColdFusion Class Path 필드에서 newrelic-api.jar
로의 경로를 지정합니다.
JVM Arguments 필드에 -javaagent
인수를 추가합니다.
-javaagent:/full/path/to/newrelic.jar
Submit Changes 를 선택한 다음 ColdFusion 서버를 다시 시작합니다.
Geronimo Geronimo에서 -javaagent
인수를 전달하려면 시작 명령을 실행할 때 JAVA_OPTS
환경 변수에서 뉴렐릭 에이전트 jar를 참조하세요.
$ export JAVA_OPTS = " $JAVA_OPTS -javaagent:/full/path/to/newrelic.jar" && geronimo run
Glassfish Glassfish에서 -javaagent
인수를 전달하려면:
Glassfish 콘솔에서 Application Server > JVM Settings > JVM options 를 선택합니다.
JVM 옵션 페이지에서 Add JVM option 을 선택합니다.
-javaagent
인수에 대한 항목을 추가합니다.
-javaagent:/full/path/to/newrelic.jar
Glassfish를 저장하고 다시 시작합니다.
Glassfish가 시작되지 않으면 -javaagent
인수가 올바르게 설정되지 않았을 수 있습니다. domain.xml
파일을 수정하여 서버 JVM 인수를 변경할 수 있습니다.
중요 Glassfish 2.1의 버그로 인해 부트스트랩 클래스 로더(뉴렐릭 에이전트)의 클래스는 Java 로깅 API를 사용하지 못합니다. 이는 2.1.1 이상 릴리스에서 수정된 것으로 보입니다.
Grails Grails에서 -javaagent
인수를 전달하려면:
run-app으로 패스 압축을 푼 Grails 버전으로 시작합니다.
다음 명령을 실행합니다.
$ grails -noreloading -javaagent:/full/path/to/newrelic.jar run-app
run-war 패스 Grails 앱에서 텍스트 편집기로 이 파일을 엽니다.
grails-app/conf/BuildConfig.groovy
JVM 인수 행을 추가하거나 편집합니다.
grails.tomcat.jvmArgs = ["-javaagent:/full/path/to/newrelic.jar"]
JBoss JBoss에서 -javaagent
인수를 전달하려면:
도메인 모드로 설정(6.x EAP 및 7.0 AS) JBoss 버전 6.x EAP 및 7.0 AS 이상에 대해 도메인 모드를 사용합니다.
다음 위치에 있는 서버 그룹의 JVM 속성을 수정합니다.
domain/configuration/domain.xml
-javaagent
인수를 포함하도록 속성을 수정합니다.
< server-group name = " main-server-group " profile = " full " >
< option value = " -javaagent:/full/path/to/newrelic.jar " />
독립 실행형 모드로 설정(기타 버전) 다른 플랫폼 및 버전에는 독립 실행형 모드를 사용합니다.
Platform
Directions
Unix 또는 macOS(6.x EAP 또는 7.0.x AS 이상 설치)
bin/standalone.conf
하단에 다음을 추가합니다.
JAVA_OPTS = " $JAVA_OPTS -javaagent:/full/path/to/newrelic.jar "
Windows(6.x EAP 또는 7.0.x 포함)AS 이상
bin/standalone.bat
에서 줄 앞:
set JBOSS_ENDORSED_DIRS = %JBOSS_HOME% \lib\endorsed
추가:
set "JAVA_OPTS=-javaagent:C:/full/path/to/newrelic.jar %JAVA_OPTS%"
Unix 또는 macOS(6.x 또는 이전 버전 설치)
bin/run.conf
맨 아래에 다음을 추가합니다.
JAVA_OPTS = " $JAVA_OPTS -javaagent:/full/path/to/newrelic.jar "
Windows(6.x 또는 이전 버전 포함)
bin/run.bat
에서 줄 앞:
set JBOSS_CLASSPATH = %RUN_CLASSPATH%
추가:
set "JAVA_OPTS=-javaagent:C:/full/path/to/newrelic.jar %JAVA_OPTS%"
Jetty Jetty에서 -javaagent
인수를 전달하려면:
exec를 설정하면 jetty.sh
jetty.sh
스크립트에서 JAVA_OPTIONS
를 수정합니다.
$ export JAVA_OPTIONS = " ${JAVA_OPTIONS} -javaagent:/full/path/to/newrelic.jar"
exec를 설정하면 start.ini
start.ini
구성 파일에 에이전트 경로를 추가합니다.
-javaagent:/full/path/to/newrelic.jar
Play Play에서 -javaagent
인수를 전달하려면:
Play 1.2.4 Play 애플리케이션을 실행할 때 -javaagent
인수를 추가합니다.
$ play run your_app_name -javaagent:/full/path/to/newrelic.jar
Play 2.0 start
스크립트가 포함된 unzipped 배포로 시작합니다.
$ play clean dist && unzip dist/*.zip
Play 앱을 시작할 때 -javaagent
인수를 추가합니다.
$ cd unzipped/folder ; chmod a+x start ; ./start -javaagent:/full/path/to/newrelic.jar
Play 2.2 start
스크립트가 포함된 unzipped 배포로 시작합니다.
$ play clean dist && unzip target/directory/universal/*.zip
Play 앱을 시작할 때 -J-javaagent
인수를 추가합니다.
$ cd unzipped/folder ; ./bin/scriptname -J-javaagent:/full/path/to/newrelic.jar
Play 2.3, 2.4, 2.5 start
스크립트가 포함된 unzipped 배포로 시작합니다.
$ activator clean dist && unzip target/directory/universal/*.zip
Play 앱을 시작할 때 -J-javaagent
인수를 추가합니다.
$ cd unzipped/folder ; ./bin/scriptname -J-javaagent:/full/path/to/newrelic.jar
Play 2.4에서 Typesafe Activator를 사용하는 경우 다음 줄을 build.sbt
에 추가합니다.
javaOptions ++ = Seq ( "-javaagent:/full/path/to/newrelic.jar" )
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를 실행합니다.
$ java -javaagent:/path/to/newrelic.jar -jar lib/resin.jar start
중요 Java 9 이상을 사용하는 경우 에이전트가 Windows에서 Resin과 함께 작동하지 않습니다.
Solr Solr에 -javaagent
인수를 전달하려면:
독립 실행형 Solr 5.x 이상 -javaagent
속성을 bin/solr.in.sh
에 추가합니다.
$ SOLR_OPTS = " $SOLR_OPTS -javaagent:/full/path/to/newrelic.jar"
독립 실행형 Solr 4.x 이하 start.jar
앞에 -javaagent
추가:
$ java -javaagent:/full/path/to/newrelic.jar -jar start.jar
앱 서버 Solr application server 에서 Solr를 실행할 때 해당 애플리케이션 서버의 지침에 따라 -javaagent
플래그를 추가합니다. 또한 애플리케이션 서버에 대해 JMX가 활성화되어 있는지 확인합니다. APM UI의 Solr 페이지에 데이터가 표시되지 않으면 Solr 데이터 문제 해결 절차 를 따르십시오.
Spring Boot Spring Boot에서 -javaagent
인수를 전달하려면 이를 앱을 시작하는 명령줄에 추가합니다. -jar
인수 앞에 추가해야 합니다.
$ 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
인수를 전달하려면:
setenv.sh 사용 아직 존재하지 않는 경우 CATALINA_BASE/bin/setenv.sh
스크립트를 만듭니다. CATALINA_OPTS
환경 변수를 사용하여 뉴렐릭 에이전트를 사용하도록 setenv.sh
스크립트를 구성합니다.
$ export CATALINA_OPTS = " $CATALINA_OPTS -javaagent:/full/path/to/newrelic.jar"
setenv.bat 사용 아직 존재하지 않는 경우 CATALINA_BASE/bin/setenv.bat
스크립트를 만듭니다. CATALINA_OPTS
환경 변수를 사용하여 뉴렐릭 에이전트를 사용하도록 setenv.bat
스크립트를 구성합니다.
SET "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:/full/path/to/newrelic.jar"
catalina.sh 사용(권장하지 않음) 팁 이 스크립트에서는 변수를 설정하지 않는 것이 좋습니다. 대신 CATALINA_BASE/bin
의 스크립트 setenv.sh
에 넣어 맞춤화된 설정을 별도로 유지합니다.
JAVA_OPTS
환경 변수를 사용하여 뉴렐릭 에이전트를 사용하도록 catalina.sh
파일을 구성합니다.
$ export JAVA_OPTS = " $JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"
catalina.bat 사용(권장하지 않음) 팁 이 스크립트에서는 변수를 설정하지 않는 것이 좋습니다. 대신 CATALINA_BASE/bin
의 스크립트 setenv.bat
에 넣어 맞춤화된 설정을 별도로 유지합니다.
catalina.bat
를 사용하여 Tomcat을 시작하는 경우 파일 상단 근처에 JAVA_OPTS
변수를 설정합니다.
SET JAVA_OPTS = %JAVA_OPTS% - javaagent: / full / path / to / newrelic.jar
Windows 사용 Start > Apache Tomcat X.Y.Z. > Configure Tomcat > Java 을 선택합니다.
Java Options 텍스트 상자에 인수를 입력합니다. 경로 구분 기호로 슬래시(/
)를 사용합니다. Tomcat 6의 경우 -javaagent
인수 뒤에 줄 바꿈을 추가합니다.
-javaagent:/full/path/to/newrelic.jar
Apply 를 선택한 다음 Tomcat을 다시 시작합니다.
Apache Commons 데몬 사용 Tomcat 6에 포함된 Apache Commons Daemon(jsvc) 버전은 뉴렐릭에서 사용하는 -javaagent
인수를 지원하지 않습니다. 그러나 트렁크 소스의 jsvc 데몬 빌드는 -X
접두사를 통해 -javaagent
인수를 지원합니다. 문제를 추적하는 Apache 버그 를 참조하십시오.
Apache Commons 소스 리포지토리에 수정 방법이 있습니다. 보다 자세한 내용은:
WebLogic WebLogic에서 -javaagent
인수를 전달하려면:
Linux 또는 macOS의 관리 서버 도메인의 bin
디렉터리에 있는 startWebLogic.sh
파일을 수정합니다.
파일 시작 부분에 다음을 추가합니다.
$ export JAVA_OPTIONS = " $JAVA_OPTIONS -javaagent:/full/path/to/newrelic.jar"
Windows의 관리 서버 도메인의 bin
디렉터리에 있는 startWebLogic.bat
파일을 수정합니다.
파일 시작 부분에 다음을 추가합니다.
set JAVA_OPTIONS = %JAVA_OPTIONS% - javaagent: "C:\full\path\to\newrelic.jar"
매니지드 서버 인스턴스 관리 서버 인스턴스의 경우 Linux/macOS 또는 Windows 지침을 따르십시오. 관리 콘솔을 사용해서 관리 서버 인스턴스를 설치할 수는 없습니다.
매니지드 서버 인스턴스의 경우 관리 콘솔을 사용합니다.
관리 콘솔에서 Environments > Servers > (select a server) > Server Start > Arguments 로 이동합니다.
Arguments 에서 다음을 추가합니다.
-javaagent:/full/path/to/newrelic.jar
페이지를 저장한 다음 서버 인스턴스를 다시 시작합니다.
WebSphere WebSphere에서 -javaagent
인수를 전달하려면:
관리 콘솔에서 Servers > Application servers > (select a server) > Configuration > Service Infrastructure > Java and Process Management 를 선택합니다.
Process Definition > Additional Properties 를 선택한 다음 Java Virtual Machine 를 클릭합니다.
Generic JVM arguments 필드에서 newrelic.jar
파일에 대한 -javaagent
인수를 추가합니다.
-javaagent:/full/path/to/newrelic.jar
Apply 를 선택한 다음 Save 를 클릭합니다.
서버를 다시 시작합니다.
보다 자세한 정보는 WebSphere PMI 메트릭 수집 에 대한 문서를 참조하십시오.
WebSphere Community Edition에서 -javaagent
인수를 전달하려면 시작 명령을 실행할 때 JAVA_OPTS
환경 변수에서 뉴렐릭 에이전트 jar를 참조합니다.
$ export JAVA_OPTS = " $JAVA_OPTS -javaagent:/full/path/to/newrelic.jar" && startup
WebSphere Liberty Profile WebSphere Liberty Profile에서 -javaagent
인수를 전달하려면:
${server.config.dir}/jvm.options
를 수정합니다.
newrelic.jar
파일을 가리키도록 -javaagent
인수를 추가합니다.
-javaagent:/full/path/to/newrelic.jar
서버를 다시 시작합니다.
Wildfly Wildfly에서 -javaagent
인수를 전달하려면(Wildfly 11 이상을 사용하는 경우 추가 설치 지침 참조 ):
도메인 모드로 설정 다음 위치에 있는 서버 그룹의 JVM 속성을 수정합니다.
domain/configuration/domain.xml
-javaagent
인수를 포함하도록 속성을 수정합니다.
< server-group name = " main-server-group " profile = " full " >
< option value = " -javaagent:/full/path/to/newrelic.jar " />
독립 실행형 모드로 설정 Platform
Directions
Unix 또는 macOS
bin/standalone.conf
하단에 다음을 추가합니다.
JAVA_OPTS = " $JAVA_OPTS -javaagent:/full/path/to/newrelic.jar "
Windows
bin/standalone.bat
에서 다음 줄을 찾습니다.
그런 다음 다음을 추가합니다.
set "JAVA_OPTS=-javaagent:C:/full/path/to/newrelic.jar %JAVA_OPTS%"
기타 애플리케이션 서버 뉴렐릭 Java 에이전트는 지원되는 모든 앱 서버 에서 작동합니다. 이 문서에 포함되지 않은 앱 서버의 경우 앱 서버에 대한 표준 절차에 따라 앱 jar 전에 이 인수를 JVM으로 전달하세요.
-javaagent:/full/path/to/newrelic.jar