.NET Framework 호환성 요구사항 (.NET Framework Compatibility Requirements)
Datadog .NET Tracer가 지원하는 .NET Framework 런타임, 운영체제, 자동 계측 라이브러리 목록이에요.
출처: 문서
본문
Datadog .NET Tracer는 모든 .NET 기반 언어(예: C#, F#, Visual Basic)를 지원해요.
.NET Tracer는 오픈소스예요. 자세한 내용은 .NET Tracer 저장소를 참고하세요.
지원되는 .NET Framework 런타임
.NET Tracer는 다음 .NET Framework 버전에서 자동·커스텀 계측을 지원해요. 또한 .NET Core와 .NET 5+를 지원해요. .NET Tracer는 부분 신뢰(partial trust) 환경에서 실행되는 코드를 지원하지 않아요.
| .NET Framework 버전 | Microsoft 수명 종료 | 지원 수준 | 패키지 버전 | Datadog 수명 종료 |
|---|---|---|---|---|
| 4.8.1 | GA | latest | ||
| 4.8 | GA | latest | ||
| 4.7.2 | GA | latest | ||
| 4.7.1 | GA | latest | ||
| 4.7 | GA | latest | ||
| 4.6.2 | GA | latest | ||
| 4.6.1 | 2022년 4월 26일 | GA | latest | |
| 4.6 | 2022년 4월 26일 | EOL | < 2.0.0 (예: 1.31.2) | 2022년 4월 26일 |
| 4.5.2 | 2022년 4월 26일 | EOL | < 2.0.0 (예: 1.31.2) | 2022년 4월 26일 |
| 4.5.1 | 2016년 1월 12일 | EOL | < 2.0.0 (예: 1.31.2) | 2022년 4월 26일 |
| 4.5 | 2016년 1월 12일 | EOL | < 2.0.0 (예: 1.31.2) | 2022년 4월 26일 |
추가 정보는 Microsoft의 .NET Framework 수명 주기 정책과 .NET 런타임 지원 정책에서 확인할 수 있어요.
자동 계측에 사용할 Datadog SDK 버전을 결정할 때는 애플리케이션 서버에 설치된 .NET Framework 버전을 사용하세요. 예를 들어 .NET Framework 4.5.1을 대상으로 애플리케이션을 컴파일했지만 .NET Framework 4.8이 설치된 서버에서 실행한다면 최신 SDK 버전을 사용하세요. 머신에 설치된 .NET Framework 버전을 확인하려면 Microsoft가 제공하는 지침을 따르세요.
지원되는 운영 체제 (Supported operating systems)
.NET Tracer는 Windows 운영체제에서 .NET Framework 애플리케이션의 자동 계측을 지원해요. .NET Framework가 지원하는 운영체제에 대한 추가 정보는 .NET Framework 시스템 요구사항에서 확인할 수 있어요.
Windows
| 운영체제 | 버전 | 지원 수준 | 패키지 버전 |
|---|---|---|---|
| Windows Server | 2012+ | GA | latest |
| Windows Client | 8.1+ | GA | latest |
| Windows Server (x86) | 모든 버전 | EOL | < 3.0.0 (예: 2.48.0) |
| Windows Server | < 2012 | EOL | < 3.0.0 (예: 2.48.0) |
참고: "Windows Server"는 모든 에디션과 설치 옵션을 포함해요.
- 에디션: Datacenter, Standard, Essentials 등.
- 설치 옵션: Server Core, Server with Desktop Experience, Nano Server(컨테이너 이미지 전용).
32비트(x86) 애플리케이션의 계측은 64비트(x64) Windows에서 지원돼요. Windows on ARM64는 지원되지 않아요.
통합 (Integrations)
최신 .NET Tracer 버전은 다음 라이브러리를 자동 계측할 수 있어요.
| 프레임워크 또는 라이브러리 | NuGet 패키지 | 통합 이름 |
|---|---|---|
| .NET Remoting | built-in | Remoting |
| ADO.NET | 모든 AdoNet 통합 | AdoNet |
| Aerospike | Aerospike.Client 4.0.0+ |
Aerospike |
| ASP.NET (Web Forms 포함) | built-in | AspNet |
| ASP.NET MVC | Microsoft.AspNet.Mvc 4.0+ |
AspNetMvc |
| ASP.NET Web API 2 | Microsoft.AspNet.WebApi 5.1+ |
AspNetWebApi2 |
| Amazon DynamoDB | AWSSDK.DynamoDBv2 3.0+ |
AwsDynamoDb |
| Amazon Kinesis | AWSSDK.Kinesis 3.0+ |
AwsKinesis |
| Amazon SNS | AWSSDK.SNS 3.0+ |
AwsSns |
| Amazon SQS | AWSSDK.SQS 3.0+ |
AwsSqs |
| Azure Cosmos DB | Microsoft.Azure.Cosmos 3.6.0+ |
CosmosDb |
| Couchbase | CouchbaseNetClient 2.2.8+ |
Couchbase |
| Elasticsearch | Elasticsearch.Net 5.3.0+ |
ElasticsearchNet |
| GraphQL .NET | GraphQL 2.3.0+ |
GraphQL |
| gRPC | Grpc.Core 2.3.0+ |
Grpc |
| HotChocolate | HotChocolate 11.0.0+ |
HotChocolate |
| HttpClient / HttpMessageHandler | built-in | HttpMessageHandler |
| IBM MQ | amqmdnetstd 9.0.0+ |
IbmMq |
| Kafka | Confluent.Kafka 1.4+ |
Kafka |
| MongoDB | MongoDB.Driver.Core 2.1.0+ |
MongoDb |
| MSMQ | built-in | Msmq |
| MySql | MySql.Data 6.7.0+MySqlConnector 0.61.0+ |
MySql |
| Oracle | Oracle.ManagedDataAccess 4.122.0+ |
Oracle |
| PostgreSQL | Npgsql 4.0+ |
Npgsql |
| Process | built-in | Process |
| RabbitMQ | RabbitMQ.Client 3.6.9+, |
RabbitMQ |
| Redis (ServiceStack 클라이언트) | ServiceStack.Redis 4.0.48+ |
ServiceStackRedis |
| Redis (StackExchange 클라이언트) | StackExchange.Redis 1.0.187+ |
StackExchangeRedis |
| SQLite | System.Data.Sqlite 2.0.0+Microsoft.Data.Sqlite 1.0.0+ |
Sqlite |
| SQL Server | System.Data 4.0.0+System.Data.SqlClient 4.0.0+Microsoft.Data.SqlClient 1.0.0+ |
SqlClient |
| WCF (server) | built-in | Wcf |
| WebClient / WebRequest | built-in | WebRequest |
참고: Redis 6.0+는 HELLO, MIGRATE, ACL SETUSER 같은 명령에서 인라인 인증을 지원해요.
- Datadog Trace Agent: 인증 매개변수가 트레이스 메타데이터에서 자동으로 난독화되도록 최소 필수·권장 버전은
7.76.1이에요. - Datadog Lambda Extension (Serverless 환경): 최소 필수 버전은
v28.0.0이에요.
원하는 라이브러리가 없나요? 먼저 라이브러리가 OpenTelemetry와 호환되는 관측성 데이터를 생성하는지 확인하세요(자세한 내용은 OpenTelemetry 계측 라이브러리 사용 참고). 아니라면 Datadog이 지속적으로 지원을 추가하고 있어요. Datadog 팀에 문의해 도움을 받으세요.
지원되는 Datadog Agent 버전
| Datadog Agent 버전 | 패키지 버전 |
|---|---|
| 7.x | latest |
| 6.x | latest |
| 5.x | latest |
.NET 런타임 지원 정책 (.NET runtime support policy)
.NET Tracer는 호스트 운영체제, .NET Framework 런타임, 특정 .NET Framework 라이브러리, Datadog Agent/API에 의존해요. 이 서드파티 소프트웨어 시스템은 특정 .NET Framework 버전을 지원해요. 외부 소프트웨어가 특정 .NET Framework 버전을 더 이상 지원하지 않으면, .NET Tracer도 해당 버전에 대한 지원을 제한해요.
지원 수준 (Levels of support)
| 수준 | 제공되는 지원 |
|---|---|
| 지원 안 함 (Unsupported) | 구현 없음. 특별 요청은 고객 지원에 문의하세요. |
| 미리 보기 (Preview) | 초기 구현. 아직 모든 기능을 포함하지 않을 수 있어요. 새 기능·버그·보안 수정 지원은 최선의 노력으로 제공돼요. |
| 일반 공급 (GA) | 모든 기능의 전체 구현. 새 기능·버그·보안 수정에 대한 완전한 지원. |
| 유지보수 (Maintenance) | 기존 기능의 전체 구현. 새 기능은 받지 않아요. 버그·보안 수정 지원만. |
| 수명 종료 (EOL) | 지원 없음. |
패키지 버전 관리 (Package versioning)
.NET Framework용 Datadog APM은 시맨틱 버전 관리를 실천해요. 버전 업데이트는 런타임 지원에 다음 변경을 의미해요.
- 메이저 버전 업데이트(예:
1.0.0→2.0.0)는 모든 런타임의 지원을 Preview/GA에서 Maintenance/EOL로 바꿀 수 있어요. - 마이너 버전 업데이트(예:
1.0.0→1.1.0)는 한 런타임의 지원 수준을 낮추지 않지만 하나를 추가할 수 있어요. - 패치 버전 업데이트(예:
1.0.0→1.0.1)는 어떤 런타임의 지원도 변경하지 않아요.
더 알아보기 (Learn more)
도움이 되는 추가 문서, 링크, 글: