New Relic 속성 은 이벤트 또는 트랜잭션의 속성을 결정하는 정보를 포함하는 키-값 쌍입니다. 이러한 키-값 쌍을 사용하면 애플리케이션에 대한 통찰력을 높이고 쿼리할 때 데이터에 주석을 추가할 수 있습니다. 사용자 정보를 New Relic에 자동으로 전달할 수도 있습니다.
기본 및 사용자 지정 속성은 모두 APM 트랜잭션 추적, 분산 추적 및 오류 분석에서 볼 수 있습니다.대시보드 의 APM 이벤트 및 브라우저 이벤트 . 이러한 각 대상으로 보낼 속성을 정확히 사용자 지정할 수 있습니다.
이 문서에서는 Java 에이전트 속성을 설명하고 속성을 활성화 또는 비활성화하는 방법을 자세히 설명하며 에이전트가 대상 에 대해 포함하거나 제외할 속성을 결정하기 위해 따르는 규칙을 설명합니다.
팁
이러한 속성 설정은 Java 에이전트 버전 3.7.0 이상에 적용됩니다. 이전 버전의 에이전트를 사용하는 경우 레거시 속성 구성 업데이트 를 참조하세요.
Java 에이전트 API의 NoticeError() 호출에 추가된 속성입니다. 이 속성의 키 이름은 메서드를 호출할 때 지정하는 항목에 따라 다릅니다.
각 대상에 대한 기본 설정은 다음과 같습니다.
거래 추적: 사용할 수 없음
오류 분석: 사용
APM 이벤트: 사용할 수 없음
브라우저 이벤트: 사용할 수 없음
Java 에이전트는 응답 및 요청 헤더를 특성으로 캡처할 수 있습니다.
캡처된 HTTP 요청 헤더:
request.headers.referer
request.headers.accept
request.headers.contentLength
request.headers.host
request.headers.userAgent
캡처된 응답 헤더: response.headers.contentType
에이전트는 기본적으로 다른 요청 헤더를 캡처하지 않습니다. 또한 newrelic.yml 의 attributes.include 스탠자 내에 추가 요청 헤더를 포함하여 속성으로 캡처할 추가 요청 헤더를 지정할 수 없습니다.
사용자 지정이든 표준이든 추가 요청 헤더를 캡처하려면 Java 에이전트 API 의 addCustomParameter() 메서드를 사용하세요.
각 대상에 대한 기본 설정은 다음과 같습니다.
트랜잭션 추적: 사용
오류 분석: 사용
APM 이벤트: 사용
브라우저 이벤트: 비활성화됨
자바 에이전트는 기본적으로 request.method 속성의 일부로 요청 메서드 GET, POST 및 PUT을 캡처합니다.
트랜잭션의 요청 매개변수는 기본적으로 캡처되지 않습니다. addCustomParameter() 자바 에이전트 API를 사용하여 요청 매개변수를 캡처합니다.
이러한 속성의 키는 request.parameters.* 입니다. 민감한 정보 캡처가 우려되는 경우 다음 옵션을 사용할 수 있습니다.
attributes.include 에서 와일드 카드를 사용하지 마십시오. 대신 캡처할 각 필드를 명시적으로 지정하십시오.
attributes.include 에서 와일드 카드를 사용하려면 attributes.exclude 을 사용하여 민감한 필드를 명시적으로 제외하십시오.
사용자 속성 수집
APM의 Java 에이전트를 사용하면 구성 파일을 편집하여 에서 사용자 정보를 자동으로 수집할 수 있습니다. 그런 다음 사용자 지정 특성을 수동으로 만들 필요 없이 사용자 정보에 대해 NRQL 쿼리 를 실행할 수 있습니다. 이 기능은 New Relic의 Java 에이전트 3.10.0 이상에서 사용할 수 있습니다.
SELECT uniqueCount(user) FROM Transaction SINCE 1 day ago
속성 구성: 활성화, 포함 및 제외
Java 에이전트가 New Relic에 보고하는 속성 유형 또는 특정 속성을 구성할 수 있습니다. 이것은 종종 보안상의 이유로 New Relic에 보고하고 싶지 않은 특정 민감한 속성이 있을 때 수행됩니다. 어떤 설정이 다른 설정보다 우선하는지 알아보려면 속성 구성 규칙 을 참조하십시오.