.NET 에이전트: .NET Framework에 대한 호환성 및 요구 사항

.NET 프레임워크 4.6.2 이상

.NET Framework 4.6.2 이상에는 New Relic .NET 에이전트 버전 7.0 이상이 필요합니다.

.NET 프레임워크 4.5.1, 4.5.2 및 4.6.1

.NET Framework 4.5.1, 4.5.2 또는 4.6.1에서 실행되는 애플리케이션을 계측하려면 10.0 이하 7.0 이하의 New Relic .NET 에이전트 버전을 실행해야 합니다.

.NET 프레임워크 4.0 이하

.NET Framework 버전 4.0 이하에서 실행되는 애플리케이션을 계측하려면 7.0 이하 버전의 New Relic .NET 에이전트를 실행해야 합니다. 자세한 정보 및 다운로드 절차는 .NET 프레임워크 4.0 이하에 대한 기술 지원을참조하십시오.

다음은 .NET Framework 버전 4.0 이하에 대한 추가 세부 정보입니다.

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

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

• IIS

• 자체 호스팅 OWIN

• 자체 호스팅 WCF

• 황조롱이

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

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

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

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

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

Azure 관련 설치 지침은 다음을 참조하세요.

• Azure 클라우드 서비스에 설치
• Azure Service Fabric에 설치
• Azure Web Apps에 설치

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

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

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

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

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

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

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

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

  추천:

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

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

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

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

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

에이전트는 일부 애플리케이션 프레임워크를 자동으로 계측합니다. 우리는 이러한 프레임워크를 완벽하게 지원 된다고 말합니다.

지원되는 데이터 저장소에 대한 인스턴스 세부 정보를 수집하려면 .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.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.4.0, 4.6.1, 4.7.0, 4.8.4 Microsoft.Data.SqlClient 지원되는 최소 버전: 1.0.19239.1 검증된 호환 버전: 1.0.19239.1, 2.1.5, 3.1.1, 4.1.1, 5.0.1, 5.1.1 시스템.데이터 지원되는 최소 버전: .NET Framework 4.6.2 확인된 호환 버전: .NET Framework 4.6.2, 4.7.1, 4.8
  MongoDB(레거시 드라이버)		지원되는 최소 버전: 1.10.0 확인된 호환 버전: 1.10.0 알려진 비호환 버전: 하위 버전 2에서는 인스턴스 세부 정보를 사용할 수 없습니다.
  MongoDB(최신 드라이버)		지원되는 최소 버전: 2.3.0 검증된 호환 버전: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.20.0, 2.21.0, 2.22.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 검증된 호환 버전: 6.10.7, 8.0.15, 8.0.30, 8.0.33, 8.1.0, 8.2.0 MySqlConnector 지원되는 최소 버전: 1.0.1 검증된 호환 버전: 1.0.1, 1.3.13, 2.1.2, 2.3.1
  신탁
  PostgreSQL		Npgsql 사용 지원되는 최소 버전: 4.0.0 검증된 호환 버전: 4.0.5 이전 버전의 Npgsql도 계측될 수 있지만 중복 및/또는 누락된 메트릭이 가능합니다.
  서비스스택.레디스
  StackExchange.Redis		지원되는 최소 버전: 1.0.488 검증된 호환 버전: 1.0.488, 1.1.608, 1.2.6, 2.0.601, 2.1.58, 2.2.88, 2.6.66, 2.6.116, 2.7.4
  엘라스틱서치		Elastic.Clients.Elasticsearch, NEST또는 Elasticsearch.Net 을사용하십시오. Elastic.클라이언트.Elasticsearch 최소 지원 버전: 8.0.0 검증된 호환 버전: 8.0.0, 8.1.0, 8.1.1, 8.9.1, 8.9.2 둥지 최소 지원 버전: 7.0.0 검증된 호환 버전: 7.0.0, 7.17.5 Elasticsearch.Net 최소 지원 버전: 7.0.0 검증된 호환 버전: 7.0.0, 7.17.5

에이전트는 EPiServer 콘텐츠 관리 시스템을 자동으로 계측합니다.

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

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

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

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