• 로그인지금 시작하세요

사용자의 편의를 위해 제공되는 기계 번역입니다.

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

문제 신고

.NET 에이전트 API 사용 가이드

New Relic의 .NET 에이전트에는 에이전트의 표준 기능을 확장할 수 있는 API 가 포함되어 있습니다. 예를 들어 다음을 위해 .NET 에이전트 API를 사용할 수 있습니다.

  • 앱 이름 사용자 지정
  • 사용자 정의 트랜잭션 매개변수 생성
  • 맞춤 오류 및 측정항목 보고

구성 설정 을 조정하거나 사용자 지정 계측 을 사용하여 .NET 에이전트의 일부 기본 동작을 사용자 지정할 수도 있습니다.

요구 사항

중요

2021년 9월부터 .NET용 API, 구성 옵션 및 설치 옵션의 일부가 새로운 방법으로 대체됩니다. 이 전환을 쉽게 준비하는 방법을 비롯한 자세한 내용은 Explorers Hub 게시물 을 참조하세요.

.NET 에이전트 API를 사용하려면:

  1. 최신 .NET 에이전트 릴리스 가 있는지 확인하십시오.

  2. 프로젝트의 에이전트에 대한 참조를 추가합니다.

    • 프로젝트에 NewRelic.Api.Agent.dll 에 대한 참조를 추가합니다.

      또는

    • NuGet 패키지 라이브러리 에서 API 패키지를 보고 다운로드합니다.

트랜잭션으로 코드의 누락된 섹션 계측

앱을 계측하기 위해 New Relic은 코드를 통한 각 경로를 자체 트랜잭션 으로 분리합니다. 새 유물 시간(또는 "계측기")은 이러한 트랜잭션의 상위 메서드로 앱의 전체 성능을 측정하고 추가 세부 정보를 위해 장기 실행 트랜잭션에서 트랜잭션 추적 을 수집합니다.

New Relic이 코드의 특정 부분을 전혀 계측하지 않을 때 다음 방법을 사용하십시오.

원하는 경우...

이게 ...

트랜잭션이 New Relic에 보고되는 것을 방지

트랜잭션을 무시하려면 IgnoreTransaction() 또는 XML 파일 을 사용하세요.

존재하지 않는 트랜잭션 생성

속성 또는 XML 파일 을 사용하여 새 트랜잭션을 만듭니다.

세그먼트를 사용한 시간별 방법

New Relic UI에 트랜잭션이 이미 표시되어 있지만 해당 트랜잭션 중에 호출된 특정 메서드에 대한 데이터가 충분하지 않은 경우 세그먼트를 생성하여 개별 메서드의 시간을 더 자세히 확인할 수 있습니다. 예를 들어 복잡한 논리로 특히 중요한 방법의 시간을 정하고 싶을 수 있습니다.

기존 트랜잭션 내에서 메서드를 계측하려면 속성을 통한 사용자 지정 계측 또는 XML을 통해 트랜잭션에 세부 정보 추가 를 참조하세요.

트랜잭션의 메타데이터 향상

때때로 대상으로 하는 코드가 New Relic UI에 표시되지만 메서드의 일부 세부 정보는 유용하지 않습니다. 예를 들어:

New Relic이 New Relic UI에 이미 표시된 트랜잭션을 계측하는 방법을 변경하려면 다음 방법을 사용하십시오.

원하는 경우...

이게 ...

트랜잭션 이름 변경

SetTransactionName() 또는 XML 파일을 사용합니다.

거래가 Apdex 점수에 영향을 미치지 않도록 방지

IgnoreApdex() 을(를) 사용합니다.

거래에 메타데이터(예: 고객의 계정 이름 또는 구독 수준)를 추가합니다.

사용자 정의 속성 을 사용하십시오.AddCustomAttribute() 을(를) 참조하세요.

관련 로그 보기

애플리케이션의 오류 및 추적 컨텍스트 내에서 직접 로그를 보려면 다음 API 호출을 사용하여 로그에 주석을 추가하십시오.

로그 데이터와 다른 원격 측정 데이터의 상관 관계에 대한 자세한 내용은 컨텍스트 문서의 로그를 참조하세요.

계기 비동기 작업

지원되는 프레임워크의 경우 .NET 에이전트는 일반적으로 비동기 작업을 감지하고 올바르게 계측합니다. 그러나 앱이 다른 프레임워크를 사용하거나 기본 비동기 계측 이 정확하지 않은 경우 비동기 작업을 명시적으로 연결할 수 있습니다.

원하는 경우...

이게 ...

New Relic이 이미 계측하고 있는 비동기 메서드 추적

XML 파일을 사용하여 IIS 앱에서 비동기 메서드를 계측합니다. 또한 누락된 비동기 측정항목 에 대한 New Relic의 문제 해결 팁을 참조하세요.

New Relic이 계측하지 않는 비동기 메서드 추적

XML 파일을 사용하여 IIS 앱에서 비동기 메서드를 계측합니다. 또한 누락된 비동기 측정항목 에 대한 New Relic의 문제 해결 팁을 참조하세요.

외부 서비스에 대한 호출 보기

.NET 에이전트 버전 8.9 이상의 경우 다음 분산 추적 페이로드 API 를 사용하여 분산 추적에서 서로 자동으로 연결되지 않는 New Relic 모니터링 서비스 간에 분산 추적 컨텍스트를 수동으로 전달할 수 있습니다 .

원하는 경우...

이게 ...

외부 애플리케이션 또는 데이터베이스에 대한 발신 요청 계측

CreateDistributedTracePayload() 을 사용하여 발신 요청에 연결할 분산 추적 페이로드를 만듭니다.

들어오는 요청을 요청의 발신자와 연결하여 추적 범위 를 완료합니다.

AcceptDistributedTracePayload() 을 사용하여 수신 요청에 대한 페이로드를 수신합니다.

.NET 에이전트 버전 8.9 미만의 경우 애플리케이션 간 추적 을 사용하십시오.

오류 수집 또는 무시

일반적으로 .NET 에이전트는 오류를 자동으로 감지합니다. 그러나 에이전트를 사용하여 수동으로 오류를 표시할 수 있습니다. 오류를 무시할 수도 있습니다.

원하는 경우...

이게 ...

.NET 에이전트가 자동으로 보고하지 않는 오류 보고

NoticeError() 을(를) 사용합니다.

오류를 캡처하거나 .NET 에이전트가 오류를 보고하지 못하도록 방지

.NET 에이전트 구성 파일 을 사용합니다.

앱에서 맞춤 이벤트 및 측정항목 데이터 보내기

APM에는 임의의 사용자 지정 데이터를 기록하는 여러 방법이 포함되어 있습니다. New Relic 데이터 유형에 대한 설명은 데이터 수집 을 참조하십시오.

원하는 경우...

이게 ...

대시보드에서 분석할 수 있도록 이벤트에 대한 데이터 보내기

맞춤 이벤트 를 만듭니다. RecordCustomEvent() 을(를) 참조하세요.

대시보드 또는 오류 분석에서 이벤트를 필터링하고 패싯하기 위해 메타데이터로 이벤트에 태그 지정

사용자 정의 속성 을 추가합니다. .NET 에이전트 속성 및 속성 활성화 및 비활성화 를 참조하십시오.

맞춤 실적 데이터 보고

RecordMetric() 을 사용하여 맞춤 측정항목 을 만듭니다. 데이터를 보려면 쿼리 작성기 를 사용하세요.

브라우저 모니터링 에이전트 제어

일반적으로 브라우저 에이전트는 페이지에 자동으로 추가되거나 JavaScript 스니펫을 복사/붙여넣기하여 배포됩니다. 이러한 권장 방법에 대한 자세한 내용은 브라우저 모니터링에 앱 추가 를 참조하십시오.

그러나 APM 에이전트 API 호출을 통해 브라우저 에이전트를 제어할 수도 있습니다. 자세한 내용은 브라우저 모니터링 및 .NET 에이전트 를 참조하십시오.

Copyright © 2022 New Relic Inc.

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