자바 에이전트 속성

웹 요청에 대한 응답 상태 코드입니다. 이 속성의 키는 http.statusCode 입니다. 참고: 8.0.0 미만의 에이전트 버전에서는 httpResponseCode 속성을 사용했습니다.

각 대상에 대한 기본 설정은 다음과 같습니다.

• 트랜잭션 추적: 사용
• 오류 분석: 사용
• APM 이벤트: 사용
• 브라우저 이벤트: 비활성화됨

웹 요청에 대해 존재하는 경우 응답 상태 메시지입니다. 이 속성의 키는 http.statusText 입니다. 참고: 8.0.0 미만의 에이전트 버전에서는 httpResponseMessage 속성을 사용했습니다.

각 대상에 대한 기본 설정은 다음과 같습니다.

• 트랜잭션 추적: 사용
• 오류 분석: 사용
• APM 이벤트: 사용
• 브라우저 이벤트: 비활성화됨

스레드의 이름입니다. 이 속성의 키는 jvm.thread_name 입니다.

각 대상에 대한 기본 설정은 다음과 같습니다.

• 트랜잭션 추적: 사용
• 오류 분석: 사용
• APM 이벤트: 비활성화됨
• 브라우저 이벤트: 사용할 수 없음

잠긴 스레드의 이름입니다. 이 속성의 키는 jvm.lock_thread_name 입니다.

각 대상에 대한 기본 설정은 다음과 같습니다.

• 거래 추적: 사용할 수 없음
• 오류 분석: 사용
• APM 이벤트: 사용할 수 없음
• 브라우저 이벤트: 사용할 수 없음

NewRelic.addCustomParameter(...) Java 에이전트 API 호출에 의해 추가된 속성입니다. 이 속성의 키 이름은 메서드를 호출할 때 지정하는 항목에 따라 다릅니다.

각 대상에 대한 기본 설정은 다음과 같습니다.

• 트랜잭션 추적: 사용

• 오류 분석: 사용

• APM 이벤트: 비활성화됨

• 브라우저 이벤트: 비활성화됨

  중요

  사용자 정의 속성을 생성하기 전에 NRQL에서 사용하는 New Relic의 예약 용어 목록을 검토하십시오. 그렇지 않으면 예상치 못한 결과를 얻을 수 있습니다.

NewRelic.getAgent().getTracedMethod().addCustomAttribute(...) Java 에이전트 API에 대한 호출로 추가된 속성입니다. 이 속성의 키 이름은 메서드를 호출할 때 지정하는 항목에 따라 다릅니다.

이러한 속성은 분산 추적 UI 에서 찾거나 쿼리 빌더 에서 직접 쿼리할 수 있는 스팬 이벤트에 추가됩니다.

Java 에이전트 API의 NoticeError() 호출에 추가된 속성입니다. 이 속성의 키 이름은 메서드를 호출할 때 지정하는 항목에 따라 다릅니다.

각 대상에 대한 기본 설정은 다음과 같습니다.

• 거래 추적: 사용할 수 없음
• 오류 분석: 사용
• APM 이벤트: 사용할 수 없음
• 브라우저 이벤트: 사용할 수 없음

Java 에이전트는 다음 응답 및 요청 헤더를 특성으로 캡처할 수 있습니다.

캡처된 HTTP 요청 헤더:

• request.headers.referer

• request.headers.accept

• request.headers.contentLength

• request.headers.host

• request.headers.userAgent

  캡처된 응답 헤더: response.headers.contentType

  에이전트는 다른 요청 헤더를 캡처하지 않습니다.

  속성 시스템은 위에 나열된 헤더 값 이외의 헤더 값에는 적용되지 않습니다. 여기에 나열되지 않은 추가 요청 헤더를 캡처하려면 custom_request_headers 구성 옵션을 사용하여 에이전트가 캡처할 헤더를 지정해야 합니다. 또는 Java 에이전트 API 의 addCustomParameter() 메소드를 사용하여 헤더를 직접 기록할 수 있습니다.

  각 대상에 대한 기본 설정은 다음과 같습니다.

• 트랜잭션 추적: 사용

• 오류 분석: 사용

• APM 이벤트: 사용

• 브라우저 이벤트: 비활성화됨

자바 에이전트는 기본적으로 request.method 속성의 일부로 요청 메서드 GET, POST 및 PUT을 캡처합니다.

트랜잭션의 요청 매개변수는 기본적으로 캡처되지 않습니다. addCustomParameter() 자바 에이전트 API를 사용하여 요청 매개변수를 캡처합니다.

이러한 속성의 키는 request.parameters.* 입니다. 민감한 정보 캡처가 우려되는 경우 다음 옵션을 사용할 수 있습니다.

• attributes.include 에서 와일드 카드를 사용하지 마십시오. 대신 캡처할 각 필드를 명시적으로 지정하십시오.
• attributes.include 에서 와일드 카드를 사용하려면 attributes.exclude 을 사용하여 민감한 필드를 명시적으로 제외하십시오.

Java 에이전트 8.1.0을 사용하여 공개 API를 통해 enduser.id 사용자 속성을 수집하려면 이상, 전화:

NewRelic.setUserId(String userId);

다음은 사용자 ID를 설정하는 예제 코드 스니펫입니다.

@Trace(dispatcher = true)
public void run() {
    NewRelic.setUserId("example-user-id");
}

Java 에이전트 3.10.0을 사용하여 서블릿 계측을 통해 사용자 속성을 수집하려면 또는 더 높게:

1. 일반적으로 newrelic.jar 과 같은 디렉토리에 있는 newrelic.yml 을(를) 엽니다.

2. class_transformer 섹션에서 com.newrelic.instrumentation.servlet-user 편집하여 enabled true 으로 설정합니다.

   class_transformer:
     # This instrumentation reports the name of the user principal returned from 
     # HttpServletRequest.getUserPrincipal() when servlets and filters are invoked.
     com.newrelic.instrumentation.servlet-user:
       enabled: true

   카피

3. 웹 서버를 다시 시작하십시오.

8.1.0 을 사용하는 경우 Java 에이전트 이상의 릴리스에서는 com.newrelic.instrumentation.servlet-user 활성화하거나 공개 API를 사용하고 몇 분 정도 기다리면 enduser.id 속성을 쿼리할 수 있습니다. 예를 들어 다음 NRQL 쿼리를 사용하여 모든 사용자의 고유한 수를 얻을 수 있습니다.

SELECT uniqueCount(enduser.id) FROM Transaction SINCE 1 day ago

또는 3.10.0 을 사용하는 경우 Java 에이전트 이상 릴리스 및 com.newrelic.instrumentation.servlet-user활성화, 몇 분 내에 user 속성을 쿼리할 수 있습니다.

SELECT uniqueCount(user) FROM Transaction SINCE 1 day ago

두 경우 모두 오류가 보고되면 사용자 속성을 사용하여 지정된 오류 그룹에서 영향을 받는 사용자 수를확인할 수 있습니다.

기타 리소스:

• Java 에이전트 구성 파일 템플릿 을 참조하십시오.
• 어떤 설정이 다른 설정보다 우선하는지를 포함하여 속성 구성을 관리하는 규칙을 참조하십시오.

기타 리소스:

• Java 에이전트 구성 파일 템플릿 을 참조하십시오.
• 어떤 설정이 다른 설정보다 우선하는지를 포함하여 속성 구성을 관리하는 규칙을 참조하십시오.

기타 리소스:

• Java 에이전트 구성 파일 템플릿 을 참조하십시오.
• 어떤 설정이 다른 설정보다 우선하는지를 포함하여 속성 구성을 관리하는 규칙을 참조하십시오.

기본 attributes.enabled 속성을 false 로 설정하면 에이전트는 속성을 전혀 보고하지 않습니다.

대상에 대해 사용 을 false 으로 설정하면 에이전트가 포함/제외 설정을 무시하고 해당 대상에 대한 속성을 보고하지 않습니다.

.exclude 속성은 .include 속성을 재정의합니다.

여러 포함 또는 제외 속성이 동일한 키에 영향을 미치는 경우 가장 구체적인 설정이 우선합니다.

.include 및 .exclude 속성에 지정된 키는 대소문자를 구분합니다.

키 끝에 별표 * 를 와일드카드로 사용할 수 있습니다. 이것은 동일한 접두사를 가진 속성 집합과 일치합니다.