Java 에이전트 API 사용 안내

New Relic이 자동으로 생성하지 않을 때 Transaction 생성

보고할 작업을 포함하는 메서드에 대한 @Trace(dispatcher = true) . 이 주석이 기존 트랜잭션 컨텍스트 내의 메소드에 사용되면 새 트랜잭션이 시작되지 않고 기존 트랜잭션에 메소드가 포함됩니다.

New Relic이 자동으로 추적하지 않는 메서드의 기간을 캡처합니다.

시간을 측정하려는 방법에 대한 @Trace() .

현재의 이름을 설정 Transaction

NewRelic.setTransactionName(...)

현재 Transaction 의 응답 시간에 대한 타이머를 시작하고 생성한 Transaction 이(가) Other 트랜잭션이 아닌 Web 트랜잭션으로 보고되도록 합니다.

NewRelic.setRequestAndReponse(...)

Transactions 에 사용자 정의 속성 을 추가하고 TransactionEvents

NewRelic.addCustomParameter(...)

enduser.id 에이전트 속성을 설정하여 Transactions 에 사용자 추적을 추가합니다.

NewRelic.setUserId()

Transaction 이(가) New Relic에 보고되는 것을 방지

NewRelic.ignoreTransaction()

앱의 Apdex 점수를 계산할 때 Transaction 제외

NewRelic.ignoreApdex()

기존 Transaction 에 연결된 경우 비동기 메서드를 추적합니다...

@Trace(async = true)

현재 스레드의 Token 과 연결된 Transaction 을(를) 연결합니다...

Token.link() 또는 Token.linkAndExpire()

현재 Transaction 과(와) 연결된 Token 만료 ...

Token.expire()

Segment 타이밍을 중지하고 상위 항목의 일부로 보고하도록 합니다. Transaction

Segment.end()

Segment 타이밍을 중지하고 상위 항목의 일부로 보고 하지 않도록 합니다. Transaction

Segment.ignore()

수신 또는 발신 메시지의 유형별 헤더에 대해 알아봅니다.

Headers

제공된 Headers 구현의 경우 ConcurrentHashMapHeaders 을 사용합니다.

Kafka를 사용한 DT API 사용 에서 W3C 추적 컨텍스트 헤더 구현의 예를 참조하십시오.

분산 추적 헤더를 만들고 Headers 데이터 구조에 삽입합니다. 이 API는 에이전트가 newrelic 헤더를 제외하도록 명시적으로 구성 되지 않는 한 newrelic 및 W3C 추적 컨텍스트 헤더( traceparent 및 tracestate )를 모두 삽입합니다.

Transaction.insertDistributedTraceHeaders(Headers)

현재 트랜잭션 및 기타 API 클래스에 대한 참조 가져오기에 대한 자세한 내용은 참조 가져오기 를 참조 하십시오.

호출 서비스에서 보낸 분산 추적 헤더를 수락하고 분산 추적에서 이러한 서비스를 함께 연결합니다.

Transaction.acceptDistributedTraceHeaders(TransportType, Headers)

현재 트랜잭션 및 기타 API 클래스에 대한 참조 가져오기에 대한 자세한 내용은 참조 가져오기 를 참조 하십시오.

분산 추적 헤더를 수락할 때 전송 유형을 정의하기 위한 열거형 상수를 제공하는 유틸리티 클래스를 이해합니다.

분산 추적에서 SpanEvents 에 맞춤 속성 추가

NewRelic.getAgent().getTracedMethod().addCustomAttribute(...)

호출된 서비스에 보낼 페이로드를 만듭니다.

Transaction.createDistributedTracePayload()

현재 트랜잭션 및 기타 API 클래스에 대한 참조 가져오기에 대한 자세한 내용은 참조 가져오기 를 참조 하십시오.

첫 번째 서비스에서 보낸 페이로드를 수락합니다. 이것은 추적에서 이러한 서비스를 함께 연결합니다.

Transaction.acceptDistributedTracePayload(...)

현재 트랜잭션 및 기타 API 클래스에 대한 참조 가져오기에 대한 자세한 내용은 참조 가져오기 를 참조 하십시오.

서비스를 연결하는 데 사용되는 페이로드입니다. text() 호출은 페이로드의 JSON 문자열 표현을 반환합니다.

DistributedTracePayload.text()

서비스를 연결하는 데 사용되는 페이로드입니다. httpSafe() 호출은 페이로드의 base64로 인코딩된 JSON 문자열 표현을 반환합니다.

DistributedTracePayload.httpSafe()

독점 RPC 전송과 같이 New Relic이 기본적으로 지원하지 않는 사용자 지정 전송 채널을 통한 추적

Transaction.getRequestMetadata(), .processRequestMetadata(...), .getResponseMetadata(), .processResponseMetadata(...)

또한 Transaction 을 사용하여 New Relic API 클래스에 대한 참조를 얻는 방법에 대한 이 문서의 정보를 참조하세요.

메트릭 이름 또는 롤업 메트릭 이름을 보거나 변경합니다. TracedMethod

( OtherTransaction/all 과 같은 롤업 측정항목 이름은 특정 트랜잭션으로 범위가 지정되지 않습니다. 모든 백그라운드 트랜잭션을 나타냅니다.)

TracedMethod.getMetricName(), .setMetricName(...), .setRollupMetricName(...)

또한 TracedMethod 을 사용하여 New Relic API 클래스에 대한 참조를 얻는 방법에 대한 이 문서의 정보를 참조하세요.

Java 에이전트 API의 @Trace 주석 을 사용하여 추적 중인 외부 HTTP 서비스, 데이터베이스 서버, 메시지 대기열 또는 기타 외부 리소스에 대한 호출을 보고합니다.

TracedMethod.reportAsExternal(...) ExternalParameters 빌더를 사용하여 생성된 인수를 전달합니다.

또한 TracedMethod 을 사용하여 New Relic API 클래스에 대한 참조를 얻는 방법에 대한 이 문서의 정보를 참조하세요.

New Relic에 의해 계측되는 외부 HTTP 또는 JMS 서비스와 통신할 때 교차 애플리케이션 추적 을 활성화하고 추가합니다.

TracedMethod.addOutboundRequestHeaders(...) 와 함께 TracedMethod.reportAsExternal(...)

또한 TracedMethod 을 사용하여 New Relic API 클래스에 대한 참조를 얻는 방법에 대한 이 문서의 정보를 참조하세요.

자동으로 지원되지 않는 애플리케이션 서버 또는 디스패처에 대한 타이밍 추가

Transaction.setRequest(...), Transaction.setResponse(...), 또는 NewRelic.setRequestAndResponse(...) Transaction.markResponseSent()

또한 Transaction 을 사용하여 New Relic API 클래스에 대한 참조를 얻는 방법에 대한 이 문서의 정보를 참조하세요.

현재에 대한 참조 가져오기 Transaction

NewRelic.getAgent().getTransaction()

비동기 작업을 연결하려면 Token 가져오기

시작하고 참조를 얻으십시오. Segment

현재 추적 중인 메서드에 대한 참조 가져오기

NewRelic.getAgent().getTracedMethod()

Agent 로거에 대한 참조 가져오기

NewRelic.getAgent().getLogger()

Agent 구성 에 대한 참조 가져오기

NewRelic.getAgent().getConfig()

사용자 지정 측정항목 에 대한 집계에 대한 참조 가져오기

NewRelic.getAgent().getAggregator()

맞춤 이벤트 를 기록하려면 Insights (맞춤 이벤트를 관리하는 기능의 원래 이름)에 대한 참조를 가져옵니다.

NewRelic.getAgent().getInsights()

애플리케이션 서버 또는 디스패처에 대한 포트, 이름 및 버전 정보를 명시적으로 설정하고 JVM에 대한 인스턴스 이름을 명시적으로 설정합니다.

New Relic이 자동으로 보고하지 않는 오류 보고

NewRelic.noticeError(...)

트랜잭션 내부에서 noticeError 에 대한 마지막 호출이 승리합니다. 트랜잭션당 1개의 오류만 보고됩니다.

사용자 정의된 지문으로 오류를 그룹화하고 New Relic으로 전송될 오류에 대한 그룹화 키를 생성하는 데 사용되는 ErrorGroupCallback 인터페이스를 구현합니다. 지문은 오류 받은 편지함 UI에서 오류 메시지를 그룹화하는 데 사용됩니다.

public interface ErrorGroupCallback { String generateGroupingString(ErrorData errorData); }

콜백 함수를 통해 자신만의 오류 지문을 설정하세요. 제공된 오류에 대한 그룹화 키를 생성하는 데 사용되는 ErrorGroupCallback 를 등록합니다.

NewRelic.setErrorGroupCallback(errorGroupCallback)

New Relic이 헤더에 자동으로 추가하지 않는 Transactions 에 대한 브라우저 페이지 로드 타이밍 추가

맞춤 측정항목 생성 및 누적

NewRelic.recordMetric(...), .recordResponseTimeMetric(...) 또는 .incrementCounter(...)

맞춤 이벤트 기록

Insights.recordCustomEvent(...)

또는 NewRelic.addCustomParameter(...) 를 사용하여 New Relic에서 정의한 TransactionEvent 유형에 맞춤 속성을 추가합니다.

또한 Insights 을 사용하여 New Relic API 클래스에 대한 참조를 얻는 방법에 대한 이 문서의 정보를 참조하세요.

에이전트에게 일반 클라우드 공급자 계정 정보를 제공합니다.

NewRelic.getAgent().getCloud().setAccountInfo(CloudAccountInfo.AWS_ACCOUNT_ID, "...");

이 방법을 사용하면 계정 정보 유형과 해당 금액을 제공할 수 있습니다. 에이전트는 이 정보를 사용하여 선택한 클라우드 서비스 범위에서 속성 cloud.resource_id 을 채웁니다.

AWS DynamoDB와 Kinesis는 cloud.resource_id 속성을 채우려면 이 값이 필요한 서비스입니다. 마찬가지로, AWS Lambda는 계정 ID가 함수 이름에 포함되지 않은 경우 이 값을 요구합니다.

이 메서드를 호출하면 해당 클라우드 설정이 재정의됩니다. 위에 표시된 호출은 cloud.aws.account_id 재정의합니다.

에이전트에 SDK 클라이언트별 클라우드 공급자 계정 정보를 제공합니다.

NewRelic.getAgent().getCloud().setAccountInfo(sdkClient, CloudAccountInfo.AWS_ACCOUNT_ID, "...");

이 호출은 이전 메서드와 동일한 정보를 제공하지만, 제공된 SDK 클라이언트에만 국한됩니다. 지정된 SDK 클라이언트를 사용하면 일반 데이터 대신 이 데이터가 사용됩니다.