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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

XML에 의한 자바 계측

New Relic이 모니터링하는 Java 애플리케이션의 경우 한 가지 사용자 정의 계측 방법은 XML 파일을 사용하여 계측해야 하는 앱 메서드를 지정하는 것입니다. Java 에이전트는 시작 시 XML 파일을 읽고 관련 클래스를 계측합니다. 시작 후 extensions 디렉토리 에 추가된 XML 파일은 감지하기 위해 JVM을 다시 시작할 필요가 없습니다.

사용자 지정 계측 옵션 및 사용 이유에 대한 설명은 Java 에이전트 사용자 지정 계측 을 참조하십시오.

XML 파일 액세스

one.newrelic.com > All capabilities > APM & services > (앱 선택) > Settings > Instrumentation 으로 이동합니다. 여기에서 다음을 수행할 수 있습니다.

  • 샘플 XML 파일을 다운로드합니다. ( Import an XML file 을 클릭할 때 표시되는 팝업에서 이 작업을 수행할 수 있습니다.)
  • 기존 XML 파일 편집을 선택합니다.
  • 계측 기록을 검색합니다.

XML 파일 구조

New Relic 에이전트 다운로드 패키지( newrelic_agent.zip )에는 XML 계측을 사용하기 위한 두 개의 템플릿이 포함되어 있습니다.

  • extension.xsd 템플릿은 모든 사용자 정의 확장이 따라야 하는 XML 스키마 정의입니다.
  • extension-example.xml 템플릿은 예시입니다. 이 파일은 몇 가지 기본 JDK 방법을 계측합니다. 이 파일을 편집하고 이름을 바꾸는 경우 새 파일 이름과 일치하도록 name="extension-example" 속성을 수정해야 합니다.

extension.xsd 템플릿의 속성에 대한 자세한 내용은 XML 파일 형식 개요 를 참조하세요.

XML 파일 유효성 검사

애플리케이션을 시작하기 전에 New Relic의 명령줄 도구를 사용하여 XML 파일의 유효성을 검사하십시오. 명령줄 도구는 클래스가 jar에 있는 경우에만 사용할 수 있습니다. XML 계측을 검증하는 두 가지 방법이 있습니다.

애플리케이션은 newrelic.jar 으로 실행됩니다. 호출에는 instrument 키워드와 XML 파일 경로가 있는 -file 플래그가 포함되어야 합니다. -debug 속성은 선택 사항이며 유효성 검사 중에 추가 정보를 제공하기 위해 true 로 설정할 수 있습니다.

도구는 다음을 수행합니다.

  • XML 구문을 확인합니다.
  • 계측할 각 클래스가 클래스 경로에 있는지 확인하십시오.
  • 각 메소드가 적절한 클래스에 포함되어 있는지 확인하십시오.

XML 파일이 유효한 경우 터미널에 인쇄된 통과 문이 표시됩니다.

PASS: The extension at file.txt was successfully validated.

XML이 유효성 검사에 실패하면 터미널에 인쇄된 실패 메시지가 표시됩니다.

FAIL: reason

XML 파일 위치

Java 에이전트는 프로세스 시작 시 extensions 디렉터리에 있는 모든 XML 파일을 읽습니다. extensions 디렉토리도 수집 주기 마다 읽습니다. 런타임 중에 이 디렉토리에 추가된 XML 파일은 몇 분 안에 읽을 수 있으므로 JVM을 다시 시작할 필요가 없습니다.

XML 파일 위치를 지정하는 방법에는 두 가지가 있습니다.

XML 파일 위치 옵션

절차

확장 디렉토리 생성

  1. newrelic.jar 및 newrelic.yml이 있는 디렉토리에서 extensions 이라는 디렉토리를 작성하십시오.
  2. 확장자가 .xml 인 XML 파일을 이 디렉토리에 넣습니다.
  3. newrelic.yml 에서 extensions.dir 속성이 설정되지 않았는지 확인합니다.

기존 확장 디렉토리 지정

  1. 공통 섹션 아래의 newrelic.yml 구성 파일에서 extensions.dir 속성을 사용하여 XML 파일이 있는 디렉토리를 지정합니다.
  2. 파일이 지정된 디렉토리에 있고 파일 확장자가 .xml 인지 확인하십시오.

파일을 읽었는지 확인

에이전트가 XML 파일을 읽었는지 확인하려면 먼저 로그 관리를 finer 으로 설정합니다 .

  1. newrelic.yml 구성 파일을 편집하고 log_level 속성을 변경합니다.

    log_level: finer
  2. 응용 프로그램을 시작하거나 다시 시작합니다.

읽기에 성공하면 logs/newrelic_agent.log 는 다음과 유사한 명령문으로 이를 나타냅니다.

Reading custom extension file /path/to/file.xml

logs/newrelic_agent.log 에 문이 없으면 XML 파일을 찾을 수 없습니다. XML 파일의 위치를 확인하고 New Relic 프로세스에 파일에 대한 읽기 액세스 권한이 있는지 확인하십시오.

여러 XML 파일

단일 XML 파일을 사용하는 것이 선호되지만 여러 사용자 정의 XML 파일을 사용할 수 있습니다. 이러한 파일은 파일의 확장 이름이 고유한 한 모두 계측됩니다.

  • 두 개의 사용자 정의 XML 파일에 동일한 확장 이름이 포함된 경우 가장 높은 버전의 파일이 구현되고 다른 파일은 무시됩니다.
  • 두 파일의 이름과 버전이 같으면 에이전트가 읽은 첫 번째 파일이 구현되고 다른 파일은 무시됩니다.

XML 및 YAML

2.10.0 이전에는 YAML 파일을 사용자 정의 계측에 사용할 수 있었습니다. 이러한 레거시 YAML 파일은 계속 지원됩니다. 그러나 새로운 사용자는 사용자 정의 계측을 위해 XML 파일을 사용해야 합니다.

레거시 사용자: 동일한 확장 이름을 가진 YAML 및 XML 파일이 모두 있는 경우 XML 파일만 계측됩니다. YAML 파일은 무시됩니다. YAML 및 XML 파일을 모두 계측하려면 각 파일에 다른 확장명을 지정하십시오.

예제 XML 파일

사용자 정의 계측 XML 파일의 예는 Java XML 예제 를 참조하십시오.

Copyright © 2024 New Relic Inc.

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