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

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

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

문제 신고

사용자 정의 계측 편집기: UI의 계측

New Relic의 사용자 지정 계측 편집기를 사용하면 Java 앱 사용자가 New Relic 사용자 인터페이스를 통해 사용자 지정 계측을 구현할 수 있습니다. 편집기는 애플리케이션 코드를 수정할 수 없고 계측할 메서드가 많지 않은 경우 선호되는 선택입니다. 다른 계측 옵션과 각각을 사용하는 이유는 Java 사용자 지정 계측 을 참조하세요.

사용자 정의 계측 편집기를 사용하려면 one.newrelic.com > All capabilities > APM & services > (Java 앱 선택) > Settings > Instrumentation 이동합니다. 사용자 지정 계측 편집기를 사용하여 다음을 수행합니다.

요구 사항

사용자 정의 계측 편집기를 사용하려면 다음 요구 사항을 충족해야 합니다.

요구 사항

코멘트

에이전트

자바 에이전트 버전 3.17.0 이상

보안

높은 보안 모드 의 사용자는 계측을 내보내고 수동으로 앱 서버로 가져와야 합니다.

사용자 정의 계측 정의

New Relic 사용자 인터페이스에서 사용자 정의 계측을 정의하려면 스레드 프로파일링 세션을 사용하여 애플리케이션의 각 스레드에 대한 자세한 스택 추적을 수집하십시오. 가능하면 프로덕션 앱에서 계측 규칙을 변경하기 전에 사전 프로덕션 환경에서 사용자 지정 계측을 테스트하십시오.

두 환경 모두에서 사용자 정의 계측 편집기를 사용하여 계측할 메서드를 정의하고 변경 사항을 적용합니다.

  1. 스레드 프로파일러 세션 을 만듭니다. 충분한 데이터를 수집하려면 세션 길이를 2분 이상으로 설정하십시오.

  2. one.newrelic.com > All capabilities > APM & services > (앱 선택) > Settings > Instrumentation 으로 이동합니다. 최근 수집된 스레드 프로필 목록이 표시될 때까지 페이지 하단으로 스크롤한 다음 가장 최근 스레드 프로필을 선택합니다.

  3. 계측되지 않은 위치를 찾기 위해 개별 방법을 확장합니다. 행동 양식.

  4. 특정 노드에 대한 계측 규칙을 정의하려면 계측 또는 무시 를 선택 하고 필요한 경우 규칙 을 사용자 지정합니다.

  5. 설정을 저장하려면 계측 변경 확인 을 선택합니다.

  6. 계측 페이지 에서 변경 사항을 배포합니다.

    • 변경 사항을 자동으로 배포하려면 계측 변경 사항 배포 를 선택합니다.
    • 변경 사항을 수동으로 배포하려면 XML 내보내기 를 선택하고 계측 내보내기 를 참조하십시오.

주의

가능하면 과도한 계측을 피하십시오. 계측된 각 추가 방법으로 에이전트는 더 많은 리소스를 사용하고 애플리케이션은 더 많은 오버헤드를 발생시킵니다. 또한 계측을 배포하면 잠시 동안 더 높은 오버헤드가 발생합니다. 이로 인해 몇 초 동안 애플리케이션 요청이 눈에 띄게 느려질 수 있습니다.

UI에서 변경 사항을 적용한 경우 에이전트는 몇 가지 수집 주기 (일반적으로 몇 분) 내에 메서드 계측을 시작합니다.

편집기를 사용한 수동 계측

스레드 프로필을 사용하지 않고 편집기에서 직접 계측 지점을 생성할 수도 있습니다.

  1. 사용자 정의 계측 편집기에서 수동 계측 추가 를 선택하여 계측하거나 무시할 클래스와 메서드를 수동으로 입력합니다.
  2. 계측 지점을 정의할 때 XML 규칙에 따른 사용자 지정 계측을 따르십시오.
  3. 계측 편집기에서 변경 사항을 배포합니다.

이 방법을 사용하여 계측을 추가하면 스레드 프로필에서 사용할 수 있는 것 이상의 추가 기능이 노출됩니다. 서명으로 메서드를 일치시키는 것 외에도 반환 유형, 인터페이스의 메서드 및 Java 주석별로 메서드를 계측할 수도 있습니다.

이러한 더 복잡한 계측 유형은 편집기에서 생성 및 삭제할 수 있지만 편집할 수는 없습니다.

중요

메서드가 Instrumentation not allowed 으로 표시된 경우 맞춤 계측에 대한 New Relic의 문제 해결 절차를 따르세요.

수동으로 변경 사항 배포

또한 사용자 정의 계측 편집기를 사용하여 사용자 정의 계측 세트를 구축한 다음 계측 파일을 내보내고 수동으로 앱 서버로 가져올 수도 있습니다. 이는 높은 보안 모드 사용자에게 필요합니다.

계측을 내보내려면 UI를 통해 사용자 지정 계측을 정의하십시오 . 그런 다음 Instrumentation 페이지에서 Export xml 을 선택하고 앱 서버에서 파일을 가져옵니다 .

페이지 기능

계측 페이지는 다음 기능을 지원합니다.

원하는 경우...

이게 ...

사용자 지정 계측 일시 중지 또는 비활성화

  • 선택하다

    모든 UI 정의 사용자 지정 계측을 일시적으로 비활성화하려면 계측을 비활성화합니다 .

  • 계측 설정을 다시 활성화하려면 계측 활성화 를 선택합니다.

기존 계측 가져오기

계측 지점 편집 또는 삭제

수동 계측 은 편집할 수 없으며 삭제만 할 수 있습니다.

  • 특정 방법의 계측을 중지하려면 제거 를 선택합니다.
  • 계측 규칙을 변경하려면 편집 을 선택합니다.

계측 기록 보기

  • 누가 언제 변경 사항을 배포했는지를 포함하여 계측 기록 탭에서 사용자 지정 계측의 각 이전 반복을 볼 수 있습니다.
  • 내보내기 를 선택하여 사용자 정의 계측 파일의 사본을 다운로드한 다음 계측 편집기로 가져와서 이전 버전을 복원할 수 있습니다.

인스트루먼테이션 옵션

사용자 정의 계측 편집기를 사용하여 다음 옵션을 정의할 수 있습니다.

인스트루먼테이션 옵션

코멘트

기기 방법

선택한 방법의 계측을 시작합니다. 계측 방법은 New Relic UI에서 볼 수 있습니다. 계측기 는 다음 하위 옵션을 지원합니다.

  • 트랜잭션 이름(트랜잭션 이름) : 자동 이름 지정 규칙 에 의해 정의된 표준 트랜잭션 이름을 재정의합니다. UI는 대신 나열된 이름을 사용합니다.
  • 이 메서드가 실행될 때 트랜잭션 시작 : 부모 트랜잭션 내부에 이 메트릭의 메트릭을 포함하는 대신 이 메서드에 대한 새 트랜잭션을 만듭니다. 이 옵션을 사용하는 에이전트 동작 은 스레드에 기존 트랜잭션이 있는지 여부에 따라 다릅니다.

맞춤 속성 보고

메소드 매개변수는 트랜잭션의 속성으로 캡처할 수 있습니다. New Relic은 이러한 속성을 트랜잭션 추적, 추적된 오류 및 Transaction 이벤트에 보고합니다.

보안상의 이유로 Custom Instrumentation Editor를 사용한 사용자 정의 속성 캡처는 기본적으로 비활성화되어 있으며 높은 보안 모드를 사용하는 동안에는 활성화할 수 없습니다. 사용자 정의 계측 편집기를 사용하여 사용자 정의 속성을 보고하고 Java 에이전트가 높은 보안 모드에 있는 것을 원하지 않는 경우 높은 보안 모드를 비활성화한 후 newrelic.ymlcommon: 블록에 다음 텍스트를 추가합니다. :

reinstrument:
attributes_enabled: true

거래 무시

이 방법을 완전히 무시하십시오 . 에이전트는 이 방법의 메트릭을 보고하지 않으며 이 방법은 Apdex 계산에 기여하지 않습니다.

"시작" 옵션이 있는 결과

Instrument methods > Start the transaction when this method executes 을 선택하는 경우 에이전트 동작은 스레드에 기존 트랜잭션이 있는지 여부에 따라 다릅니다.

클래스 또는 메서드가 계측될 때:

" 거래 시작 " 플래그가 선택되어 있습니까 ?

아니요

기존 트랜잭션 해당 스레드에 있고 트랜잭션 시작 플래그 확인된 경우:

  1. 에이전트는 트랜잭션 시작 플래그를 무시합니다.
  2. 에이전트는 기존 트랜잭션에 클래스/메서드를 포함합니다.

기존 트랜잭션 해당 스레드에 있고 트랜잭션 시작 플래그가 확인 되지 않은 경우 에이전트는 클래스/메서드를 기존 트랜잭션에 포함합니다.

트랜잭션이 해당 스레드에 없고 트랜잭션 시작 플래그 확인된 경우:

  1. 에이전트는 현재 트랜잭션이 없음을 발견합니다.
  2. 에이전트는 계측한 클래스/메서드로 시작하는 새 트랜잭션을 생성합니다.

트랜잭션이 해당 스레드에 없고 트랜잭션 시작 플래그가 확인 되지 않은 경우 :

  1. 에이전트는 해당 스레드에서 트랜잭션을 찾고 찾지 못합니다.
  2. 메트릭이 삭제됩니다.
Copyright © 2024 New Relic Inc.

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