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

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

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

문제 신고

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

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

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

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

요구 사항

.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이 계측하지 않는 비동기 메서드 추적

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

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

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

원하는 경우...

이게 ...

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

InsertDistributedTraceHeaders() 사용하여 발신 요청에 분산 추적 페이로드를 추가합니다.

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

AcceptDistributedTraceHeaders() 사용하여 들어오는 요청에서 페이로드를 받습니다.

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

오류 수집 또는 무시

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

원하는 경우...

이게 ...

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

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

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

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

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

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

원하는 경우...

이게 ...

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

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

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

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

맞춤 실적 데이터 보고

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

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

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

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

Copyright © 2024 New Relic Inc.

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