우리의 .NET 에이전트는 .NET Framework와 .NET Core를 모두 지원합니다. 여기에서는 .NET Framework 응용 프로그램에 대한 호환성 및 지원에 대해 설명합니다. .NET Core의 경우 .NET Core에 대한 호환성 및 요구 사항을 참조하세요.
에이전트에는 프레임워크, 데이터베이스 및 메시지 대기열 시스템을 포함하여 .NET 에코시스템의 가장 인기 있는 부분에 대한 기본 제공 계측이 포함되어 있습니다. 에이전트를 다운로드하고 설치 하면 모니터링되는 프로세스 내에서 실행됩니다. 에이전트는 별도의 프로세스나 서비스를 생성하지 않습니다.
자동으로 계측되지않는 프레임워크 및 라이브러리의 경우 .NET 사용자 지정 계측으로 에이전트를 확장할 수 있습니다.
New Relic의 .NET 에이전트를 사용해 보고 싶으십니까? 무료 로 New Relic 계정을 만드 십시오! 신용 카드가 필요하지 않습니다.
요구 사항
New Relic의 .NET 에이전트를 설치하기전에 시스템이 다음 요구 사항을 충족하는지 확인하십시오.
EOL 공지
Microsoft는 2022년 4월 26일에 .NET Framework 버전 4.5.1, 4.5.2 및 4.6.1의 수명 종료를 공식 발표했습니다.
Microsoft 블로그 사이트에서 정보 블로그를 찾을 수 있습니다. Microsoft 설명서에서 공식 제품 수명 주기 시작 및 종료 날짜를 찾을 수 있습니다.
이러한 프레임워크 버전에 대한 당사의 .NET 에이전트 지원은 최신 9.x New Relic .NET 에이전트로 끝납니다. New Relic .NET 에이전트 버전 10.0부터 .NET 프레임워크 4.6.2를 대상으로 합니다. 앞으로. 이 전환을 쉽게 준비하는 방법을 포함한 자세한 내용은 지원 포럼 게시물 을 참조하십시오.
.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 프레임워크 버전 | Notes |
---|---|
.NET 프레임워크 2.0 | .NET Framework 4.0 이상 만 설치하지 않은 경우 설치한 다른 .NET Framework 버전 외에도 대상 호스트에 .NET Framework 버전 3.5가 설치되어 있어야 합니다 . |
.NET 프레임워크 3.0 | .NET Framework 4.0 이상 만 설치하지 않은 경우 설치한 다른 .NET Framework 버전 외에도 대상 호스트에 .NET Framework 버전 3.5가 설치되어 있어야 합니다 . |
.NET 프레임워크 3.5 | .NET 에이전트 버전 7.0 이하에서 완전히 지원됩니다. |
.NET 프레임워크 4.0 | .NET 에이전트 버전 7.0 이하에서 완전히 지원됩니다. |
.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 관련 설치 지침은 다음을 참조하세요.
에이전트는 특정 네트워크 및 포트로 나가는 연결을 허용하기 위해 방화벽이 필요합니다.
에이전트에는 다음 운영 체제 중 하나가 필요합니다.
- 윈도우 서버 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 소프트웨어 사용 중 오류를참조하십시오.
자동 계측
애플리케이션이 ASP.NET 또는 완전히 지원되는 다른 프레임워크에서 호스팅되는 경우 .NET 에이전트는 설치 후 애플리케이션을 자동으로 계측합니다. 앱이 자동으로 계측되지 않거나 계측을 추가하려는 경우 사용자 지정 계측을사용합니다.
.NET 에이전트는 데이터 저장소 프로세스를 직접 모니터링하지 않습니다. 또한 기본적으로 쿼리 추적의 .NET SQL 매개 변수 캡처는 매개 변수가 있는 쿼리 또는 저장 프로시저에 대한 매개 변수를 나열하지 않습니다. SQL 쿼리 매개변수 수집은 에이전트 구성에서 활성화할 수 있습니다.
에이전트는 일부 애플리케이션 프레임워크를 자동으로 계측합니다. 우리는 이러한 프레임워크를 완벽하게 지원 된다고 말합니다.
호환성 상태 | .NET 앱 프레임워크 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
완전 지원 | 다음 프레임워크 가 완전히 지원됩니다.
| |||||||||||||||||||||
완전히 지원되지 않음 | 다음 프레임워크는 완전히 지원되지 않습니다.
| |||||||||||||||||||||
지원되지 않음 | 에이전트는 .NET Framework 기반 앱만 계측할 수 있으므로 클래식 ASP는 지원되지 않습니다 . 셰어포인트는 지원되지 않습니다 . |
지원되는 데이터 저장소에 대한 인스턴스 세부 정보를 수집하려면 .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 콘텐츠 관리 시스템을 자동으로 계측합니다.
에이전트는 이러한 외부 호출 라이브러리를 자동으로 계측합니다.
도서관 | 지원되는 방법 |
---|---|
Http클라이언트 | 에이전트는 다음 HttpClient 메서드를 계측합니다.
|
레스트샤프 | 에이전트는 다음과 같은 RestSharp 메서드를 계측합니다.
|
HttpWebRequest | 에이전트는 다음 HttpWebRequest 메서드를 계측합니다.
|
에이전트는 다음 메시지 시스템을 자동으로 계측합니다.
도서관 | 지원되는 방법 |
---|---|
Confluent.Kafka |
|
MSMQ |
|
N서비스버스 |
|
RabbitMQ |
|
MassTransit(에이전트 버전 10.19.0 이상) |
|
나열된 .NET 언어 및 기술은 당사의 즉각적인 관찰 가능성 대시보드와 호환됩니다. 이러한 언어 또는 기술을 사용하는 경우 상자에서 꺼내자마자 New Relic 대시보드에서 데이터를 볼 수 있습니다.
언어/기술 | 추가 구성 |
---|---|
C# 애플리케이션 | New Relic은 C#으로 작성된 서비스를 자동으로 계측할 수 있습니다. C# 대시보드를 설치하려면 C# 빠른 시작 페이지로 이동하세요. |
ADO.net | 애플리케이션에서 ADO.net을 사용하는 경우 ADO.net 대시보드를 생성하는 New Relic 에이전트 조합을 설치할 수 있습니다. 수행해야 할 작업은 다음과 같습니다.
|
블레이저 서버 | New Relic으로 앱을 계측하여 Blazor Server 대시보드에서 가장 중요한 데이터를 추적하세요.
|
에이전트를 다른 New Relic 제품에 연결
APM외에도 에이전트는 다른 New Relic 제품과 통합되어 종단 간 가시성을 제공합니다.
제품 | 완성 |
---|---|
ASP.NET 웹 애플리케이션의 경우 자동 계측을 활성화 하면 .NET 에이전트가 자동으로 브라우저 JavaScript 에이전트를 삽입합니다. 브라우저 삽입을 활성화한 후 APM 요약 페이지 에서 브라우저 데이터를 보고 특정 앱에 대한 APM과 브라우저 데이터 간에 빠르게 전환할 수 있습니다. 구성 옵션 및 수동 계측에 대해서는 브라우저 모니터링 및 .NET 에이전트를 참조하세요. | |
인프라와 APM 에이전트를 동일한 호스트에 설치하면 자동으로 서로를 감지합니다. 그런 다음 APM UI에서 호스트 목록을 보고 인프라 UI에서 APM 앱으로 호스트를 필터링할 수 있습니다. 자세한 내용은 인프라 UI의 APM 데이터를 참조하세요. | |
.NET 에이전트는 NRQL 쿼리에 대한 기본 이벤트 및 속성을 보냅니다. 고급 분석을 위해 사용자 지정 이벤트를 기록 할 수도 있습니다. | |
합성 트랜잭션 추적은 합성 모니터의 요청을 기본 APM 트랜잭션에 연결합니다. |