Ruby 호환성 요구사항 (Ruby Compatibility Requirements)
Datadog Ruby Trace 라이브러리의 호환성 요구사항을 안내해요.
출처: 문서
본문
이 문서는 datadog gem v2.x용이에요. ddtrace gem v1.x 문서를 찾고 있다면 레거시 Ruby Compatibility Requirements 문서를 참고하세요.
호환성 (Compatibility)
Ruby Datadog Trace 라이브러리는 오픈소스예요. 자세한 내용은 dd-trace-rb GitHub 저장소를 참고하세요.
지원되는 Ruby 인터프리터 (Supported Ruby interpreters)
| 타입 | 문서 | 버전 | 지원 유형 | Gem 버전 지원 |
|---|---|---|---|---|
| MRI | https://www.ruby-lang.org/ | 4.0 | 최신 | 최신 |
| 3.4 | 최신 | 최신 | ||
| 3.3 | 최신 | 최신 | ||
| 3.2 | 최신 | 최신 | ||
| 3.1 | 최신 | 최신 | ||
| 3.0 | 최신 | 최신 | ||
| 2.7 | 최신 | 최신 | ||
| 2.6 | 최신 | 최신 | ||
| 2.5 | 최신 | 최신 | ||
| 2.4 | EOL | < 2.0.0 | ||
| 2.3 | EOL | < 2.0.0 | ||
| 2.2 | EOL | < 2.0.0 | ||
| 2.1 | EOL | < 2.0.0 | ||
| 2.0 | EOL | < 0.50.0 | ||
| 1.9 | EOL | < 0.27.0 | ||
| JRuby | https://www.jruby.org | 9.4 | EOL | < 2.31.0 |
| 9.3 | EOL | < 2.31.0 | ||
| 9.2.21.0+ | EOL | < 2.31.0 |
지원되는 웹 서버 (Supported web servers)
| 타입 | 문서 | 버전 | 지원 유형 |
|---|---|---|---|
| Puma | http://puma.io/ | 2.16+ / 3.6+ | 최신 |
| Unicorn | https://bogomips.org/unicorn/ | 4.8+ / 5.1+ | 최신 |
| Passenger | https://www.phusionpassenger.com/ | 5.0+ | 최신 |
지원되는 트레이싱 프레임워크 (Supported tracing frameworks)
| 타입 | 문서 | 버전 | 지원 유형 | Gem 버전 지원 |
|---|---|---|---|---|
| OpenTelemetry | https://github.com/open-telemetry/opentelemetry-ruby | >= 1.1.0 | 최신 | 1.9.0+ |
| OpenTracing | https://github.com/opentracing/opentracing-ruby | 0.4.1+ | EOL | < 2.0.0 |
지원되는 운영체제 (Supported operating systems)
| OS | 지원 유형 | 패키지 버전 |
|---|---|---|
| Linux x86_64 | 최신 | 최신 |
| Linux aarch64 | 최신 | 최신 |
| macOS | 개발 환경 전용 | 최신 |
| MS Windows | 미구현 | 최신 |
나열되지 않은 CPU 아키텍처에 대한 Linux 지원이 필요한가요? 특별 요청은 고객 지원팀에 문의하세요.
지원되는 Datadog Agent 버전 (Supported Datadog agent versions)
| Datadog Agent 버전 | 지원 유형 | 패키지 버전 |
|---|---|---|
| 7.x | 최신 | 최신 |
| 6.x | 최신 | 최신 |
| 5.x | 최신 | 최신 |
통합 (Integrations)
사용 가능한 통합 목록과 구성 옵션은 다음을 참고하세요:
| 이름 | 키 | 지원 버전: MRI | 지원 버전: JRuby | 구성 방법 | Gem 소스 |
|---|---|---|---|---|---|
| Action Cable | action_cable |
>= 5.0 |
>= 5.0 |
링크 | 링크 |
| Action Mailer | action_mailer |
>= 5.0 |
>= 5.0 |
링크 | 링크 |
| Action Pack | action_pack |
>= 4.0 |
>= 4.0 |
링크 | 링크 |
| Action View | action_view |
>= 4.0 |
>= 4.0 |
링크 | 링크 |
| Active Job | active_job |
>= 4.2 |
>= 4.2 |
링크 | 링크 |
| Active Model Serializers | active_model_serializers |
>= 0.9 |
>= 0.9 |
링크 | 링크 |
| Active Record | active_record |
>= 4.0 |
>= 4.0 |
링크 | 링크 |
| Active Support | active_support |
>= 4.0 |
>= 4.0 |
링크 | 링크 |
| AWS | aws |
>= 2.0 |
>= 2.0 |
링크 | 링크 |
| Concurrent Ruby | concurrent_ruby |
>= 0.9 |
>= 0.9 |
링크 | 링크 |
| Dalli | dalli |
>= 2.0 |
>= 2.0 |
링크 | 링크 |
| DelayedJob | delayed_job |
>= 4.1 |
>= 4.1 |
링크 | 링크 |
| Elasticsearch | elasticsearch |
>= 1.0 |
>= 1.0 |
링크 | 링크 |
| Ethon | ethon |
>= 0.11 |
>= 0.11 |
링크 | 링크 |
| Excon | excon |
>= 0.50 |
>= 0.50 |
링크 | 링크 |
| Faraday | faraday |
>= 0.14 |
>= 0.14 |
링크 | 링크 |
| Grape | grape |
>= 1.0 |
>= 1.0 |
링크 | 링크 |
| GraphQL | graphql |
>= 2.2.6, 2.1.11+, 2.0.28+, 1.13.21+ |
>= 2.2.6, 2.1.11+, 2.0.28+, 1.13.21+ |
링크 | 링크 |
| gRPC | grpc |
>= 1.7 |
gem 사용 불가 | 링크 | 링크 |
| hanami | hanami |
>= 1, < 2 |
>= 1, < 2 |
링크 | 링크 |
| http.rb | httprb |
>= 2.0 |
>= 2.0 |
링크 | 링크 |
| httpclient | httpclient |
>= 2.2 |
>= 2.2 |
링크 | 링크 |
| httpx | httpx |
>= 0.11 |
>= 0.11 |
링크 | 링크 |
| Kafka | ruby-kafka |
>= 0.7.10 |
>= 0.7.10 |
링크 | 링크 |
| Karafka | karafka |
>= 2.3.0 |
>= 2.3.0 |
링크 | 링크 |
| Kicks | kicks |
>= 3.0.0 |
>= 3.0.0 |
링크 | 링크 |
| Makara (Active Record 경유) | makara |
>= 0.3.5 |
>= 0.3.5 |
링크 | 링크 |
| MongoDB | mongo |
>= 2.1 |
>= 2.1 |
링크 | 링크 |
| MySQL2 | mysql2 |
>= 0.3.21 |
gem 사용 불가 | 링크 | 링크 |
| Net/HTTP | http |
(지원되는 모든 Ruby) | (지원되는 모든 Ruby) | 링크 | 링크 |
| OpenSearch | opensearch-ruby |
>= 1.0.0 |
>= 1.0.0 |
링크 | 링크 |
| Postgres | pg |
>= 0.18.4 |
gem 사용 불가 | 링크 | 링크 |
| Presto | presto |
>= 0.5.14 |
>= 0.5.14 |
링크 | 링크 |
| Que | que |
>= 1.0.0.beta2 |
>= 1.0.0.beta2 |
링크 | 링크 |
| Racecar | racecar |
>= 0.3.5 |
>= 1.3.5 |
링크 | 링크 |
| Rack | rack |
>= 1.1 |
>= 1.1 |
링크 | 링크 |
| Rails | rails |
>= 4.0 |
>= 4.0 |
링크 | 링크 |
| Rake | rake |
>= 12.0 |
>= 12.0 |
링크 | 링크 |
| Redis | redis |
>= 3.2 |
>= 3.2 |
링크 | 링크 |
| Resque | resque |
>= 1.0 |
>= 1.0 |
링크 | 링크 |
| Rest Client | rest-client |
>= 1.8 |
>= 1.8 |
링크 | 링크 |
| Roda | roda |
>= 2.1, <4 |
>= 2.1, <4 |
링크 | 링크 |
| Sequel | sequel |
>= 3.41 |
>= 3.41 |
링크 | 링크 |
| Shoryuken | shoryuken |
>= 3.2 |
>= 3.2 |
링크 | 링크 |
| Sidekiq | sidekiq |
>= 3.5.4 |
>= 3.5.4 |
링크 | 링크 |
| Sinatra | sinatra |
>= 1.4 |
>= 1.4 |
링크 | 링크 |
| Sneakers | sneakers |
>= 2.12.0 |
>= 2.12.0 |
링크 | 링크 |
| Stripe | stripe |
>= 5.15.0 |
>= 5.15.0 |
링크 | 링크 |
| Sucker Punch | sucker_punch |
>= 2.0 |
>= 2.0 |
링크 | 링크 |
| WaterDrop | waterdrop |
>= 2.8.8.rc1 |
>= 2.8.8.rc1 |
링크 | 링크 |
지원 정책 (Support Policy)
Datadog for Ruby는 특정 버전의 호스트 운영체제, Ruby 런타임, 특정 Ruby 라이브러리, Datadog Agent/API에 정의된 의존성 위에 구축돼요. 이러한 버전이 메인테이너의 지원을 받지 못하게 되면 Datadog for Ruby도 이에 대한 지원을 제한해요.
지원 수준 (Levels of Support)
| 수준 | 제공되는 지원 |
|---|---|
| 미지원 (Unsupported) | 기능할 수는 있지만 테스트되거나 지원되지 않아요. 특별 요청은 고객 지원팀에 문의하세요. |
| 미구현 (Unimplemented) | 구현이 없어요. 특별 요청은 고객 지원팀에 문의하세요. |
| Pre-release | 초기 구현이에요. 아직 모든 기능을 포함하지 않을 수 있어요. 새 기능, 버그·보안 수정 지원은 최선 노력 기준으로 제공돼요. |
| 최신 (Latest) | 모든 기능의 완전한 구현이에요. 새 기능, 버그·보안 수정에 대한 전체 지원을 제공해요. |
| 유지보수 (Maintenance) | 기존 기능의 완전한 구현이에요. 새 기능은 받지 않아요. 중요 버그·보안 수정 지원만 제공해요. |
| EOL | 지원이 없어요. 버전은 여전히 사용할 수 있지만 버그 수정은 제공되지 않아요. |
패키지 버전 관리 (Package Versioning)
Datadog for Ruby는 시맨틱 버전 관리를 사용해요.
런타임 지원 축소와 관련해 이는 다음을 의미해요:
- 메이저 버전 업데이트(예:
1.0.0에서2.0.0)는 어떤 런타임의 지원을 Beta/Latest에서 Maintenance/EOL로 변경할 수 있어요. - 마이너 버전 업데이트(예:
1.0.0에서1.1.0)는 어떤 런타임의 지원을 Beta/Latest에서 Maintenance로 변경할 수 있어요. - 패치 버전 업데이트(예:
1.0.0에서1.0.1)는 어떤 런타임의 지원도 변경하지 않아요.
라이브러리 버전 지원 (Library version support)
Datadog for Ruby는 라이브러리의 최신 메이저 버전에는 GA 지원을, 이전 메이저 버전에는 유지보수 지원을 제공해요. 이 지원은 메이저 버전의 최신 마이너 또는 패치 버전을 통해 제공돼요. 예를 들어 유지보수 지원을 받는 라이브러리의 최신 버전이 1.21.0이라면, 버그 수정은 1.21.0(또는 1.20.1)의 새 릴리스로 제공돼요. 이러한 버그 수정은 1.x의 이전 마이너 버전에 패치로 백포트되지 않아요.
| Gem 메이저 버전 | 지원 유형 |
|---|---|
| 2.x | 최신 |
| 1.x | 유지보수 |
| 0.x | EOL |