.NET 에이전트: .NET Core의 호환성 및 요구 사항

.NET 코어 2.0

8.19.353.0 - 9.9.0

.NET 코어 2.1

8.19.353.0 - 9.9.0

.NET 코어 2.2

8.19.353.0 - 9.9.0

.NET 코어 3.0

8.21.34.0 - 9.9.0

.NET 코어 3.1

8.21.34.0 이상

.NET 5.0

8.35.0 이상

.NET 6.0

9.2.0 이상

.NET 7.0

10.0.0 이상

Windows(32비트 및 64비트 Intel 호환 아키텍처)

• 윈도우 서버 2008 R2 SP1
• 윈도우 서버 2012
• 윈도우 서버 2012 R2
• 윈도우 서버 2016
• 윈도우 서버 2019
• 윈도우 서버 2022
• 윈도우 10
• 윈도우 11
• Server 2016에서 실행되는 Windows 컨테이너(NanoServer 기반 이미지는 지원되지 않음)

Linux(64비트 Intel 호환만 해당)

.NET Core 2.0+/.NET 5+ 런타임에서 지원하는 모든 x64 Linux 배포는 .NET 에이전트에서 지원됩니다. 전체 목록은 사용 중인 런타임 버전에 대한 Microsoft 설명서를 참조하십시오.

Linux(ARM64/aarch64 아키텍처)

.NET 5+ 런타임에서 지원하는 모든 ARM64 Linux 배포는 .NET 에이전트에서 지원됩니다. 전체 목록은 Microsoft 설명서를 참조하십시오.

에이전트 설치

에이전트를 설치하는 프로세스 또는 사용자는 환경 변수를 설정하고 에이전트가 설치된 디렉토리에 대한 쓰기 액세스 권한이 있어야 합니다.

에이전트 실행

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

역방향 프록시를 통해 IIS를 사용하는 애플리케이션의 경우 IIS_IUSRS 그룹이 자주 사용됩니다.

코스모스DB

.NET 에이전트 v9.2.0 이상은 Microsoft.Azure.Cosmos 라이브러리를 자동으로 계측합니다.

• 지원되는 최소 버전: 3.17.0
• 검증된 호환 버전: 3.17.0, 3.23.0

마이크로소프트 SQL 서버

System.Data.SqlClient NuGet 패키지 또는 Microsoft.Data.SqlClient NuGet 패키지에서 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

PostgreSQL

Npgsql 사용

• 지원되는 최소 버전: 4.0.0

• 검증된 호환 버전: 4.0.13

  이전 버전의 Npgsql도 계측될 수 있지만 중복 및/또는 누락된 메트릭이 가능합니다.

MongoDB(최신 드라이버)

지원되는 최소 버전: 2.3.0

검증된 호환 버전: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.19.2

알려진 호환되지 않는 버전: 2.7 이상에 추가된 새 메서드는 현재 계측되지 않습니다.

MySQL

MySql.Data 또는 MySQL 커넥터 사용

MySql.Data

• 지원되는 최소 버전: 6.10.7

• 검증된 호환 버전: 6.10.7, 8.0.15, 8.0.30, 8.0.31

  MySqlConnector

• 지원되는 최소 버전: 1.0.1

• 검증된 호환 버전: 1.0.1, 1.3.13, 2.1.2

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

엘라스틱서치

Elastic.Clients.Elasticsearch, NEST또는 Elasticsearch.Net 을사용하십시오.

Elastic.클라이언트.Elasticsearch

• 최소 지원 버전: 8.0.0

• 검증된 호환 버전: 8.0.0, 8.1.0

  둥지

• 최소 지원 버전: 7.0.0

• 검증된 호환 버전: 7.17.5

  Elasticsearch.Net

• 최소 지원 버전: 7.0.0

• 검증된 호환 버전: 7.17.5

Http클라이언트

에이전트는 다음 HttpClient 메서드를 계측합니다.

• SendAsync
• GetAsync
• PostAsync
• PutAsync
• DeleteAsync
• GetStringAsync
• GetStreamAsync
• GetByteArrayAsync

N서비스버스

• 메시지를 주고받습니다.
• 지원되는 최소 버전: 5.0

RabbitMQ

• 메시지 및 대기열 제거를 처리합니다.

• IBasicConsumer 을 사용하여 메시지를 수신할 때 EventingBasicConsumer 은 .NET 에이전트에 의해 계측되는 유일한 구현입니다.

• BasicGet 계측되지만 에이전트는 BasicGet 에 대한 분산 추적 을 지원하지 않습니다.

• 다음 방법이 계측됩니다.

  • IModel.BasicGet
  • IModel.BasicPublish
  • IModel.BasicComsume
  • IModel.QueuePurge
  • EventingBasicConsumer.HandleBasicDeliver

• 지원되는 최소 버전: 3.5.2

• 검증된 호환 버전: 3.5.2, 5.1.0, 6.2.1, 3.6.9, 4.1.3, 5.2.0, 6.0.0, 6.2.1, 6.4.0

Log4Net

2.0.6

2.0.10, 2.0.12, 2.0.13, 2.0.14

세릴로그

2.0.0

2.8.0, 2.10.0, 2.11.0, 2.12.0

Microsoft.Extensions.Logging

2.0.0

3.0.0, 3.1.22, 6.0.0

NLog

4.0.0

4.5.9, 4.7.15, 5.0.4