.NET 전해질 성능 및 요구 사항

.NET Framework 4.6.2 또는 더 높은

.NET Framework 4.6.2 이상에서 실행하려면 뉴렐릭 .NET agent 10.0 이상을 실행해야 합니다. .NET 프레임워크 버전 4.0 이하에서 실행하려면 뉴렐릭 .NET 에이전트 7.0 이하 버전을 실행해야 합니다. 자세한 내용과 다운로드 절차는 .NET Framework 4.0 이하에 대한 기술 지원을 참조하세요.

The .NET agent doesn't support .NET Framework versions 4.5.1, 4.5.2, and 4.6.1

.NET 에이전트는 각 수집 주기가 끝날 때(분당 한 번) 데이터를 업로드합니다. .NET 앱이 그렇게 오래 실행되지 않는 경우 newrelic.config 파일에서 service element 의 sendDataOnExit 속성을 true 로 설정할 수 있습니다.

다음 앱/웹 서버 중 하나를 사용해야 합니다.

• IIS

• 자체 호스팅 OWIN

• 자체 호스팅 WCF

• 황조롱이

• AspNetCoreModule을 통한 IIS 역방향 프록시가 있는 Kestrel

• AspNetCoreModuleV2를 통한 IIS 역방향 프록시가 있는 Kestrel

  에이전트는 IIS에서 호스팅되는 앱에 대한 트랜잭션을 자동으로 생성합니다. WCF 및 OWIN 버전 3 이상을 사용하여 자체 호스팅하는 경우 에이전트도 자동으로 트랜잭션을 생성합니다. 다른 자체 호스팅 서비스의 경우 사용자 정의 계측을 통해 트랜잭션을 생성해야 합니다.

AWS Elastic Beanstalk는 지원되는 .NET 환경이 아닙니다.

에이전트에는 CLR 버전 4.0이 필요합니다. CLR 2.0에서 실행되는 레거시 응용 프로그램은 7.0보다 낮은 에이전트 버전으로 계측할 수 있습니다.

코드 액세스 보안 사용은 완전 신뢰가 제공되는 경우에만 .NET 에이전트와 호환됩니다. 에이전트는 더 제한적인 신뢰 수준과 호환되지 않습니다.

Azure 관련 설치 지침은 .NET 설치 가이드를 참조하세요.

에이전트는 특정 네트워크 및 포트로 나가는 연결을 허용하기 위해 방화벽이 필요합니다.

에이전트에는 다음 운영 체제 중 하나가 필요합니다.

• 윈도우 서버 2008
• 윈도우 서버 2008 R2
• 윈도우 서버 2012
• 윈도우 서버 2012 R2
• 윈도우 서버 2016
• 윈도우 서버 2019
• 윈도우 서버 2022
• 윈도우 10
• 윈도우 11
• Windows Azure(OS 제품군 1, 2, 3)
• Windows 2016에서 실행되는 Windows 컨테이너(NanoServer 기반 이미지는 지원되지 않음)

설치에는 높은 권한(관리자)이 필요합니다. 예를 들어 다음을 수행할 수 있습니다.

• 관리자 사용자로 로그인합니다.

• 관리자 그룹의 구성원이 되십시오.

• 최신 운영 체제에서는 메시지가 표시되면 권한 상승 자격 증명을 제공합니다.

  모니터링되는 프로세스에는 에이전트가 설치된 디렉터리에 대한 읽기/쓰기 액세스 권한이 있어야 합니다. 에이전트는 모니터링되는 프로세스의 일부로 실행되며 해당 권한에 따라 작동합니다.

  Recommendation:

• newrelic.config 파일에 대한 권한을 제한하고 모니터링되는 프로세스의 소유자에게만 읽기/쓰기 액세스 권한을 부여합니다.

• 에이전트가 생성한 로그에 대한 권한을 검토하여 액세스 권한이 있는 사용자 수와 권한을 최소화합니다.

에이전트는 32비트 및 64비트 버전 모두에서 사용할 수 있습니다. 64비트 시스템에서 64비트 에이전트는 32비트 및 64비트 애플리케이션을 모두 계측할 수 있습니다.

데이터 수집을 위한 표준 보안 수단으로 앱 서버가 SHA-2(256비트)를 지원해야 합니다. SHA-1은 지원되지 않습니다.

.NET CLR(공용 언어 런타임)은 하나의 프로파일러만 지정된 시간에 프로세스의 프로파일링 API에 액세스할 수 있도록 허용합니다. 다른 모니터링 소프트웨어와 함께 .NET 에이전트를 실행하면 프로파일러 충돌이발생합니다. 자세한 내용은 다른 APM 소프트웨어 사용 중 오류를참조하십시오.

에이전트는 자동으로 일부 프레임워크를 제공합니다. 우리는 이러한 프레임워크를 아래에 나열된 fully supported 이라고 부릅니다.

• ASP.NET MVC 2
• ASP.NET MVC 3
• ASP.NET MVC 4
• ASP.NET MVC 5
• ASP.NET 웹 API v2
• ASP.NET 코어 MVC 2.0
• ASP.NET 코어 2.1
• ASP.NET 코어 2.2
• ASP.NET 웹 양식
• Castle MonoRail v2(.NET 에이전트 버전 10.0 이상에서 더 이상 지원되지 않음)
• 다음을 사용하는 .NET 프레임워크의 OWIN 호스팅 웹 API 애플리케이션:
• Microsoft.Owin.Host.HttpListener v2.x
• Microsoft.Owin.Host.HttpListener v3.x
• Microsoft.Owin.Host.HttpListener v4.x
• SOAP 기반 웹 서비스
• WCF

WCFsys는 다음과 같은 일반적인바인딩 유형 (클라이언트와 서비스 모두)에 대해 테스트되었습니다. DT(독일적 추적) 및 CAT(십자인대 추적)에 대해 다양한 수준의 지원을 사용할 수 있습니다.

* 분산 추적은 이러한 분산 추적 API 방법을 사용하여 수동으로 구현할 수 있습니다.

지원되는 데이터 저장소에 대한 인스턴스 세부 정보를 수집하려면 .NET 에이전트 버전 6.5.29.0 이상이 필요하며 기본적으로 활성화되어 있습니다. 현재 나열되지 않은 데이터 저장소에서 인스턴스 수준 정보를 요청하려면 New Relic 지원 센터에서 지원을 받으십시오.

이러한 데이터 저장소에 대한 .NET Framework 애플리케이션 호출의 성능을 자동으로 계측하려면 .NET 에이전트 버전 8.14 이상이있는지 확인하십시오.

• 최근 검증된 호환 버전: 4.0.40

• 알려진 비호환 버전: 4.0.44 이상

  데이터 저장소	인스턴스 세부정보	기타 참고 사항
  코스모스DB		.NET 에이전트 v9.2.0 이상은 Microsoft.Azure.Cosmos 라이브러리를 자동으로 계측합니다. 지원되는 최소 버전: 3.17.0 최근 검증된 호환 버전: 3.23.0
  Couchbase		CouchbaseNetClient 를 사용하십시오. 지원되는 최소 버전: 2.0.0 최근 검증된 호환 버전: 2.3.8 알려진 호환되지 않는 버전: 2.4.0+ Couchbase에서 다음은 기본적으로 다중 문서 대응을 위해 계측되지 않습니다. Get(string key) GetDocument(string key) Remove(string key) Remove(string key, ulong cas) Upsert<T>(string key, T value)
  IBM DB2
  마이크로소프트 SQL 서버		System.Data.SqlClient NuGet 패키지 또는 Microsoft.Data.SqlClient NuGet 패키지 또는 Framework 기본 제공 System.Data 어셈블리의 SqlClient를 사용합니다. System.Data.SqlClient 지원되는 최소 버전: 4.4.0 최근 검증된 호환 버전: 4.8.6 Microsoft.Data.SqlClient 지원되는 최소 버전: 1.0.19239.1 최근 검증된 호환 버전: 5.2.1 System.Data 지원되는 최소 버전: .NET Framework 4.6.2 최근 검증된 호환 버전: 4.8
  MongoDB(레거시 드라이버)		지원되는 최소 버전: 1.10.0 최근 검증된 호환 버전: 1.10.0 알려진 비호환 버전: 하위 버전 2에서는 인스턴스 세부 정보를 사용할 수 없습니다.
  MongoDB(최신 드라이버)		지원되는 최소 버전: 2.3.0 최근 검증된 호환 버전: 2.26.0 에이전트 버전 10.12.0부터 드라이버 버전 2.7 이후에 추가된 다음 메서드가 계측됩니다. IMongoCollection.CountDocuments[Async] IMongoCollection.EstimatedDocumentCount[Async] IMongoCollection.AggregateToCollection[Async] IMongoDatabase.ListCollectionNames[Async] IMongoDatabase.Aggregate[Async] IMongoDatabase.AggregateToCollection[Async] IMongoDatabase.Watch[Async]
  MySQL		MySql.Data 또는 MySQL 커넥터 사용 MySql.Data 지원되는 최소 버전: 6.10.7 최근 검증된 호환 버전: 8.4.0 MySqlConnector 지원되는 최소 버전: 1.0.1 최근 검증된 호환 버전: 2.3.6
  신탁		Oracle.ManagedDataAccess를사용하세요 최소 지원 버전: 12.1.2400 최신 검증된 호환 버전: 23.5.1
  PostgreSQL		Npgsql 사용 지원되는 최소 버전: 4.0.0 최근 검증된 호환 버전: 4.0.5 이전 버전의 Npgsql도 계측될 수 있지만 중복 및/또는 누락된 메트릭이 가능합니다.
  서비스스택.레디스
  StackExchange.Redis		지원되는 최소 버전: 1.0.488 최근 검증된 호환 버전: 2.7.33
  엘라스틱서치		Elastic.Clients.Elasticsearch, NEST또는 Elasticsearch.Net 을사용하십시오. Elastic.Clients.Elasticsearch 최소 지원 버전: 8.0.0 최근 검증된 호환 버전: 8.14.6 .NET 에이전트 v10.20.1부터 버전 8.10.0 이상이 지원됩니다. 버전 8.12.1 이상은 .NET 에이전트 v10.23.0부터 지원됩니다. NEST 최소 지원 버전: 7.0.0 최근 검증된 호환 버전: 7.17.5 Elasticsearch.Net 최소 지원 버전: 7.0.0 최근 검증된 호환 버전: 7.17.5

에이전트가 EPiServer 콘텐츠 관리 시스템을 자동으로 업로드했습니다.

에이전트는 이러한 외부 호출 라이브러리를 자동으로 계측합니다.

다음 호스팅 모델은 완벽히 지원됩니다.

• IIS 호스팅(ASP 호환성 포함 및 제외)
• 자체 호스팅

다음 호출 방법(클라이언트와 서비스 모두)이 지원됩니다.

• 동기
• 비동기 처리 모델(APM) 시작/종료
• 태스크 비동기 처리(TAP)
• 이벤트 기반 비동기 처리(EAP, 클라이언트 지원만 해당)

.NET 에이전트는 다음 LLM 프레임워크를 자동으로 사용하도록 구성할 수 있습니다 .

.NET 에이전트는 에이전트 전달 및 로컬 로그 장식을사용하여 자동 로그인 컨텍스트를 위해 이러한 로깅 프레임워크를 자동으로 계측하도록 구성할 수 있습니다 .

에이전트는 다음 메시지 시스템을 자동으로 계측합니다.

나열된 .NET 언어 및 기술은 당사의 즉각적인 관찰 가능성 대시보드와 호환됩니다. 이러한 언어 또는 기술을 사용하는 경우 상자에서 꺼내자마자 New Relic 대시보드에서 데이터를 볼 수 있습니다.

다음 프레임워크는 완전히 지원되지 않습니다.

• ASP.NET Web API v1: .NET 프레임워크 4.0을 대상으로 하는 앱에 대해 뉴렐릭의 .NET 에이전트 5.0 이상과 함께 ASP.NET Web API v1을 사용하는 방법에 대한 문제 해결, 문제 해결 정보를 참조하세요. (.NET 프레임워크 4.5 이상에는 영향을 미치지 않습니다.)
• Mono: 뉴렐릭은 Linux에서 실행되는 오픈 소스 .NET 프레임워크인 Mono 를 지원하지 않습니다. 이는 Mono 기반 .NET 애플리케이션에 대한 약력러로 .NET 에이전트에 삽입할 프로파일러 API가 없기 때문입니다. 약력러 API는 COM(구성 요소 개체 모델) 기반 인터페이스이며 Linux에서는 지원되지 않습니다.
• 클래식 ASP는 not supported 입니다. 왜냐하면 에이전트는 .NET 프레임워크 기반 앱만 사용할 수 있기 때문입니다.
• 셰어포인트는 not supported 입니다.