New Relic이 모니터링하는 Java 애플리케이션의 경우 한 가지 사용자 정의 계측 방법은 XML 파일을 사용하여 계측해야 하는 앱 메서드를 지정하는 것입니다. Java 에이전트는 시작 시 XML 파일을 읽고 관련 클래스를 계측합니다. 시작 후 extensions 디렉토리 에 추가된 XML 파일은 감지하기 위해 JVM을 다시 시작할 필요가 없습니다.
사용자 지정 계측 옵션 및 사용 이유에 대한 설명은 Java 에이전트 사용자 지정 계측 을 참조하십시오.
XML 파일 액세스
one.newrelic.com > All capabilities > APM & services > (select an app) > 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: reasonXML 파일 위치
Java 에이전트는 프로세스 시작 시 extensions 디렉터리에 있는 모든 XML 파일을 읽습니다. extensions 디렉토리도 수집 주기 마다 읽습니다. 런타임 중에 이 디렉토리에 추가된 XML 파일은 몇 분 안에 읽을 수 있으므로 JVM을 다시 시작할 필요가 없습니다.
XML 파일 위치를 지정하는 방법에는 두 가지가 있습니다.
XML file location options | Procedure |
|---|---|
확장 디렉토리 생성 |
|
기존 확장 디렉토리 지정 |
|
파일을 읽었는지 확인
에이전트가 XML 파일을 읽었는지 확인하려면 먼저 로그 관리를 finer 으로 설정합니다 .
newrelic.yml구성 파일을 편집하고log_level속성을 변경합니다.log_level: finer응용 프로그램을 시작하거나 다시 시작합니다.
읽기에 성공하면 logs/newrelic_agent.log 는 다음과 유사한 명령문으로 이를 나타냅니다.
Reading custom extension file /path/to/file.xmllogs/newrelic_agent.log 에 문이 없으면 XML 파일을 찾을 수 없습니다. XML 파일의 위치를 확인하고 New Relic 프로세스에 파일에 대한 읽기 액세스 권한이 있는지 확인하십시오.
여러 XML 파일
단일 XML 파일을 사용하는 것이 선호되지만 여러 사용자 정의 XML 파일을 사용할 수 있습니다. 이러한 파일은 파일의 확장 이름이 고유한 한 모두 계측됩니다.
- 두 개의 사용자 정의 XML 파일에 동일한 확장 이름이 포함된 경우 가장 높은 버전의 파일이 구현되고 다른 파일은 무시됩니다.
- 두 파일의 이름과 버전이 같으면 에이전트가 읽은 첫 번째 파일이 구현되고 다른 파일은 무시됩니다.
XML 및 YAML
2.10.0 이전에는 YAML 파일을 사용자 정의 계측에 사용할 수 있었습니다. 이러한 레거시 YAML 파일은 계속 지원됩니다. 그러나 새로운 사용자는 사용자 정의 계측을 위해 XML 파일을 사용해야 합니다.
Legacy users: 동일한 확장명을 가진 YAML 파일과 XML 파일이 모두 존재하는 경우 XML 파일만 리소스가 됩니다. YAML 파일은 무시됩니다. YAML 파일과 XML 파일을 모두 리소스로 사용하려면 각 파일에 다른 확장자 이름을 지정하세요.
예제 XML 파일
사용자 정의 계측 XML 파일의 예는 Java XML 예제 를 참조하십시오.