Java 에이전트 API로 브라우저 모니터링 계측

그만큼 기능을 사용하면 JavaScript 스니펫(또는 "에이전트")을 사용하여 앱의 웹페이지를 계측함으로써 사용자가 Java 애플리케이션과 상호 작용하는 방식에 대한 가시성을 얻을 수 있습니다. UI를 통해 브라우저 에이전트를 설치하려면 브라우저 에이전트 설치 절차를 따르세요. 예를 들어 다음을 수행할 수 있습니다.

APM 모니터링 앱을 활성화합니다.
복사/붙여넣기 방식으로 활성화합니다.
REST API를 사용하여 활성화합니다.

이 문서에 설명된 대로 Java 에이전트 API를 사용하여 웹 페이지를 수동으로 계측 할 수도 있습니다.

자바 에이전트 API 사용

프레임워크에서 복사/붙여넣기 방법을 사용하거나 REST API를 사용하여 UI에서 브라우저 모니터링을 활성화할 수 없는 경우 웹 페이지에 대한 모니터링을 수동으로 계측할 수 있습니다. 이렇게 하려면 Java 에이전트 API 를 사용하십시오.

최신 Java 에이전트 버전 을 사용하고 있는지 확인하십시오.
자동 계측을 비활성화합니다.
newrelic.yml에서 browser_monitoring 아래의 auto_instrument 플래그를 false 로 설정합니다.
browser_monitoring: auto_instrument: false
응용 프로그램을 다시 시작하십시오.
앱 서버의 작업 캐시를 플러시합니다.
작업 캐시를 플러시하면 자동 계측이 발생하는 경우 앱 서버가 JSP를 다시 컴파일해야 합니다.
browser_monitoring 섹션 아래의 disabled_auto_pages 플래그를 사용합니다. 예를 들어, testpage_1.jsp 및 testpage_2.jsp 에서 자동 계측을 비활성화하려면 다음을 사용합니다.
browser_monitoring: disabled_auto_pages: /WEB-INF/jsp/testpage_1.jsp, /WEB-INF/jsp/testpage_2.jsp
애플리케이션 클래스 경로에 newrelic-api.jar 을 추가 하여 Java 에이전트 API 클래스에 액세스합니다 .
시간 추적을 활성화하려면 com.newrelic.api.agent.NewRelic.getBrowserTimingHeader() 메서드를 추가하세요. 특정 프레임워크에 대한 절차는 아래를 참조하세요.
중요
Java 에이전트 8.9.0 부터 getBrowserTimingFooter() API 메서드 호출은 더 이상 사용되지 않습니다. 이제 getBrowserTimingHeader() 호출 시 전체 브라우저 스크립트가 포함됩니다.
사용 중인 프레임워크에 따라 적절한 방법을 찾으십시오.
헤더를 가능한 한 <head> 태그 상단에 가깝게 삽입하되 메타 태그 뒤에 삽입하세요.
<!DOCTYPE html> <html> <head> <title>EXAMPLE</title> <meta charset="utf-8" /> <meta name="description" content="Example header and footer call" /> ; <%= com.newrelic.api.agent.NewRelic.getBrowserTimingHeader() %> </head> <body></body> </html>
<head> ... <div th:remove="tag" th:utext="${T(com.newrelic.api.agent.NewRelic).getBrowserTimingHeader()}" ></div> </head> <body> ... </body>
<cfobject type="Java" class="com.newrelic.api.agent.NewRelic" name="newRelic" /> <cfset header="newRelic.getBrowserTimingHeader()" /> <cfoutput>#header#</cfoutput> ... <cfoutput>#footer#</cfoutput>
${com.newrelic.api.agent.NewRelic.getBrowserTimingHeader().raw()} ...
8.xx를 최신 에이전트 버전 으로 대체하여 build.sbt 에 다음을 추가합니다.
libraryDependencies += "com.newrelic.agent.java" % "newrelic-api" % "8.x.x"
main.scala.html 에서 다음을 추가합니다.
@Html(com.newrelic.api.agent.NewRelic.getBrowserTimingHeader()) ...
8.xx를 최신 에이전트 버전 으로 대체하여 Build.scala 에 다음을 추가합니다.
appDependencies += "com.newrelic.agent.java" % "newrelic-api" % "8.x.x"
main.scala.html 에서 다음을 추가합니다.
@Html(com.newrelic.api.agent.NewRelic.getBrowserTimingHeader()) ...
Velocity 도구를 사용하는 경우 toolbox.xml 에서 NewRelic 도구를 정의합니다.
<toolbox> <tool> <key>NewRelic</key> <scope>application</scope> <class>com.newrelic.api.agent.NewRelic</class> </tool> </toolbox>
속도 템플릿에서 NewRelic API를 호출합니다.
$NewRelic.getBrowserTimingHeader() ...
모든 브라우저 페이지 보기가 단일 /velocity 트랜잭션 아래에 그룹화되지 않도록 하고 측정항목 그룹화 문제를방지하려면 newrelic.yml 파일에서 enable_auto_transaction_naming 설정을 비활성화하십시오.
enable_auto_transaction_naming: false
일반적으로 .../tomcat/bin/setenv.sh 에서 Tomcat의 클래스 경로에 newrelic-api.jar 을 추가합니다.
bash
$CLASSPATH=$CLASSPATH:/opt/newrelic/newrelic-api.jar
또는
이 jar 파일에 대한 참조를 해당 파일 내의 기존 CLASSPATH=... 줄 끝에 추가합니다.
각 앱에서 WEB-INF/tools.xml 을 찾아 다음 태그를 추가합니다.
<toolbox scope="application"> <tool class="com.newrelic.api.agent.NewRelic" key="NewRelic" /> </toolbox>
<toolbox scope="application"> 태그가 이미 있는 경우 태그 내에 <tool ... /> 를 넣으십시오.
각 앱에서 애플리케이션의 다른 페이지에서 사용하는 Velocity 템플릿을 편집합니다. <link> 및 <script> 선언 앞과 메타 태그 뒤의 <head> 섹션 내에서 이 태그를 추가합니다.
$NewRelic.getBrowserTimingHeader()
Tomcat 서버를 다시 시작합니다.
Linux/Unix 을 사용하는 경우 Users/Tomcat/bin 디렉토리에 다음 명령줄을 추가합니다.
./shutdown.sh ./startup.sh
Windows 을 사용하는 경우 Users/Tomcat/bin 디렉토리로 이동하여 다음 명령줄을 추가합니다.
% shutdown.bat % startup.bat

에이전트가 올바르게 계측되고 있는지 확인하려면 로그 파일을 확인하십시오. newrelic.yml 의 log_level 설정을 log_level: finer 로 설정하고 다음 메시지를 확인합니다.

May 17, 2011 9:33:18 AM NewRelic FINE: Compiling JSP: /jsp/header.jsp
May 17, 2011 9:33:18 AM NewRelic FINE: Injecting browser timing header into: /jsp/header.jsp

May 17, 2011 9:33:36 AM NewRelic FINE: Compiling JSP: /jsp/footer.jsp
May 17, 2011 9:33:36 AM NewRelic FINE: Injecting browser timing footer into: /jsp/footer.jsp

JavaScript 스니펫은 에이전트가 서버에 연결될 때까지 HTML 응답에 삽입되지 않습니다.

May 17, 2011 9:43:21 AM NewRelic INFO: Real user monitoring is enabled with auto instrumentation

May 17, 2011 9:43:23 AM NewRelic FINER: Injecting browser timing header in a JSP.  Content type is text/html
May 17, 2011 9:43:23 AM NewRelic FINER: Injecting browser timing footer in a JSP.  Content type is text/html

May 17, 2011 9:43:23 AM NewRelic FINEST: Got browser timing header in NewRelic API: <script>var    NREUMQ=[];NREUMQ.push(["mark","firstbyte",new Date().getTime()]);(function(){var d=document;var e=d.createElement("script");e.type="text/javascript";e.async=true;e.src="https://d7p9czrvs14ne.cloudfront.net/11/eum/rum.js";var s=d.getElementsByTagName("script")[0];s.parentNode.insertBefore(e,s);})();</script>

May 17, 2011 9:43:23 AM NewRelic FINEST: Got browser timing footer in NewRelic API: <script type="text/javascript" charset="utf-8">NREUMQ.push(["nrf2","staging-beacon-1.newrelic.com","8512b4d93f",7449,"M1RTYksFDEYDUxdcDgoeZERQSwhGEmQGRhVL",0,413])</script>

사용자의 편의를 위해 제공되는 기계 번역입니다.

Java 에이전트 API로 브라우저 모니터링 계측

자바 에이전트 API 사용

모든 페이지에서 자동 계측 비활성화

특정 페이지에서만 자동 계측 비활성화

중요

JSP 수동 계측

원시 HTML 수동 계측

Thymeleaf 2.1 이상 수동 계측

ColdFusion CFML 페이지 수동 계측

JSF(Java Server Faces) 프레임워크

Groovy 템플릿 수동 계측 재생

2.2 이상 Scala 템플릿 수동 계측 재생

Play 2.1 Scala 템플릿 수동 계측

Apache Velocity Tools 수동 계측

Apache Velocity 수동 계측

JSP 엔진이 JSP를 컴파일할 때

에이전트가 서버에 연결한 후

New Relic이 JSP를 호출할 때

에이전트가 헤더 및 바닥글 API를 호출할 때

사용자의 편의를 위해 제공되는 기계 번역입니다.

Java 에이전트 API로 브라우저 모니터링 계측

자바 에이전트 API 사용 .css-21sua1{background:none;border:none;width:0;padding:0;}

특정 페이지에서만 자동 계측 비활성화

중요

JSP 수동 계측

원시 HTML 수동 계측

Thymeleaf 2.1 이상 수동 계측

ColdFusion CFML 페이지 수동 계측

JSF(Java Server Faces) 프레임워크

Groovy 템플릿 수동 계측 재생

2.2 이상 Scala 템플릿 수동 계측 재생

Play 2.1 Scala 템플릿 수동 계측

Apache Velocity Tools 수동 계측

Apache Velocity 수동 계측

JSP 엔진이 JSP를 컴파일할 때

에이전트가 서버에 연결한 후

New Relic이 JSP를 호출할 때

에이전트가 헤더 및 바닥글 API를 호출할 때

자바 에이전트 API 사용