リリース
バージョン
Datadog Node.js のトレーシングライブラリのバージョンは、semver に従っています。新しいメジャーバージョンがリリースされると、それが主要なリリースラインとなり、すべての新機能、バグ修正、セキュリティパッチがそこに置かれます。以下は、semver の各タイプの変更を構成するものの概要です。
| メジャー | マイナー | パッチ |
|---|
| 旧バージョンと互換性のない変更点。 | 旧バージョンとの互換性がある (壊れない) ものを追加する。 | セキュリティ修正 |
| 旧バージョンと互換性のない API の変更点。 | API の追加 | バグ修正 |
| 旧バージョンと互換性のない機能の変更点。 | 機能の追加 | |
| Node.js のバージョン、対応ライブラリ、その他の機能など、あらゆるもののサポートを打ち切る。 | Node.js のバージョン、対応ライブラリ、その他の機能など、あらゆるもののテスト済みのサポートを追加する。 | |
リリースに複数のカテゴリーがある場合、最も高いカテゴリーが選択されます。 リリースノートは、GitHub の各リリースに掲載されています。
メンテナンス
_メンテナンスモード_とは、可能な限りセキュリティとバグ修正のみを行い、新しい機能はケースバイケースで提供しない期間のことです。dd-trace のメジャーバージョンは、後続の dd-trace のメジャーバージョンがリリースされた時点でメンテナンスモードに移行します。メンテナンスモードの期間は、後続バージョンのリリース日から 1 年間です。
例えば、dd-trace のバージョン 5.0.0 が 2023 年 5 月 4 日にリリースされた場合、4.x.x リリースラインは 2024 年 5 月 4 日までメンテナンスモードベースでサポートされます。このメンテナンスモード期間中は、セキュリティパッチやバグパッチが可能な限り適用されます。
もし、特定のバージョンの dd-trace-js のサポートについて質問や懸念がある場合は、サポートにお問い合わせください。
Node.js のバージョンサポート
Node.js プロジェクトが LTS のメジャーリリースラインのサポートを終了すると (EOL になると)、次のメジャーバージョンの dd-trace でそのサポートが停止されます。
dd-trace ライブラリの最後のメジャーサポートリリースラインは、メンテナンスモードベースで、少なくともあと 1 年間はその EOL バージョンの Node.js をサポートします。
いくつかの問題は dd-trace で解決できず、代わりに Node.js で解決しなければなりません。このような場合、問題のある Node.js のリリースが EOL であれば、EOL ではない別のリリースに移行しなければ問題を解決することは不可能です。
Datadog は、LTS でない Node.js のメジャーリリースライン (奇数バージョン) に対する特定のサポートを提供するために、dd-trace の新しいリリースを作成することはありません。
最高のサポートレベルを得るためには、常に最新の LTS リリースの Node.js と、最新のメジャーバージョンの dd-trace を実行します。Node.js のどのリリースラインを使用する場合でも、最新のセキュリティ修正を確実に行うために、そのリリースラインの最新バージョンの Node.js を使用します。
Node.js のリリースについては、Node.js の公式ドキュメントを参照してください。
オペレーティングシステム対応
以下のオペレーティングシステムが dd-trace によって公式にサポートされています。リストにないオペレーティングシステムも動作する可能性はありますが、例えば ASM やプロファイリング、ランタイムメトリクスなど、いくつかの機能が欠けています。一般的には、メジャーバージョンの最初のリリース時に活発にメンテナンスされているオペレーティングシステムがサポートされます。
| dd-trace バージョン | オペレーティングシステム | アーキテクチャ | 最小バージョン |
|---|
| 3.x | Linux (glibc) | arm、arm64、x64 | CentOS 7、Debian 9、RHEL 7、Ubuntu 14.04 |
| Linux (musl) | arm、arm64、x64 | Alpine 3.13 |
| macOS | arm64、x64 | Catalina (10.15) |
| Windows | ia32、x64 | Windows 8.1、Windows Server 2012 |
| 2.x | Linux (glibc) | arm、arm64、ia32、x64 | CentOS 7、Debian 9、RHEL 7、Ubuntu 14.04 |
| Linux (musl) | arm、arm64、ia32、x64 | Alpine 3.10 |
| macOS | arm64、x64 | Yosemite (10.10) |
| Windows | ia32、x64 | Windows 8.1、Windows Server 2012 |
対応インテグレーション
APM は、プラグインシステムを使用することで追加設定なしで使用できる装置を多くの一般的なフレームワークやライブラリ向けに提供しています。一覧にないモジュールのサポートをご希望の場合は、サポートチームまでお問い合わせください。
プラグインの切り替え方法と構成方法の詳細については、API ドキュメントをご確認ください。
Web フレームワークの互換性
ネイティブモジュールの互換性
データストアの互換性
ワーカーの互換性
SDK の互換性
| モジュール | バージョン | サポートの種類 | 注 |
|---|
| aws-sdk | >=2.1.35 | 完全対応 | CloudWatch、DynamoDB、Kinesis、Redshift、S3、SNS、SQS、一般的なリクエスト。 |
Promise ライブラリの互換性
ロガーの互換性
非対応のライブラリ
Fibers
fibers は async_hooks と互換性がありません。これは Node.js のモジュールで、dd-trace-js が非同期コンテキストを追跡するために使用し、それによって正確なトレースを保証しています。fibers と async_hooks の間の相互作用は、予防できないクラッシュや未定義の挙動につながる可能性があります。そのため、fibers を直接、あるいは Meteor などのフレームワークを介して間接的に呼び出すアプリケーションで dd-trace-js を使用すると、不安定 (クラッシュ) や不正確なトレースが発生する可能性があります。
追加情報または議論については、この github 問題にコメントを残すか、サポートにお問い合わせください。
その他の参考資料
