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 プロジェクトが 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 ドキュメントをご確認ください。
| モジュール | バージョン | サポートの種類 | 注 |
|---|---|---|---|
| connect | 2 以降 | 完全対応 | |
| express | 4 以降 | 完全対応 | Sails、Loopback、その他に対応 |
| fastify | 1 以降 | 完全対応 | |
| graphql | 0.10 以降 | 完全対応 | Apollo Server および express-graphql に対応 |
| gRPC | >=1.13 | 完全対応 | |
| hapi | 2 以降 | 完全対応 | 対応 [@hapi/hapi] バージョン 17.9 以降 |
| koa | 2 以降 | 完全対応 | |
| microgateway-core | 2.1 以降 | 完全対応 | Apigee Edge 用のコアライブラリ。edgemicro CLI への対応には @datadog/cli を使用した静的パッチが必要。 |
| moleculer | >=0.14 | 完全対応 | |
| next | >=9.5 | 完全対応 | CLI で使用する場合は、NODE_OPTIONS='-r dd-trace/init' が必要です。トレーサーは、次のNext.jsの機能をサポートしています：
|
| paperplane | 2.3 以降 | 完全対応 | serverless-mode では非対応 |
| restify | 3 以降 | 完全対応 |
| モジュール | バージョン | サポートの種類 | 注 |
|---|---|---|---|
| cassandra-driver | 3 以降 | 完全対応 | |
| couchbase | 2.4.2 以降 | 完全対応 | |
| elasticsearch | 10 以降 | 完全対応 | バージョン 5 以降の @elastic/elasticsearch に対応 |
| ioredis | 2 以降 | 完全対応 | |
| knex | 0.8 以降 | 完全対応 | このインテグレーションはコンテキストの伝搬のみが目的 |
| mariadb | 3 以降 | 完全対応 | |
| memcached | 2.2 以降 | 完全対応 | |
| mongodb-core | 2 以降 | 完全対応 | Mongoose に対応 |
| mysql | 2 以降 | 完全対応 | |
| mysql2 | 1 以降 | 完全対応 | |
| oracledb | >=5 | 完全対応 | |
| pg | 4 以降 | 完全対応 | pg と共に使用した場合 pg-native に対応 |
| redis | 0.12 以降 | 完全対応 | |
| sharedb | 1 以降 | 完全対応 | |
| tedious | 1 以降 | 完全対応 | mssql および sequelize 用の SQL Server ドライバー |
| モジュール | バージョン | サポートの種類 | 注 |
|---|---|---|---|
| @google-cloud/pubsub | 1.2 以降 | 完全対応 | |
| amqp10 | 3 以降 | 完全対応 | AMQP 1.0 ブローカー (ActiveMQ、または Apache Qpid など) に対応 |
| amqplib | 0.5 以降 | 完全対応 | AMQP 0.9 ブローカー (RabbitMQ、または Apache Qpid など) に対応 |
| generic-pool | 2 以降 | 完全対応 | |
| kafkajs | >=1.4 | 完全対応 | |
| kafka-node | 間もなく対応 | ||
| rhea | 1 以降 | 完全対応 |
| モジュール | バージョン | サポートの種類 | 注 |
|---|---|---|---|
| aws-sdk | >=2.1.35 | 完全対応 | CloudWatch、DynamoDB、Kinesis、Redshift、S3、SNS、SQS、一般的なリクエスト。 |
| モジュール | バージョン | サポートの種類 |
|---|---|---|
| bluebird | 2 以降 | 完全対応 |
| promise | 7 以降 | 完全対応 |
| promise-js | 0.0.3 以降 | 完全対応 |
| q | 1 以降 | 完全対応 |
| when | 3 以降 | 完全対応 |
| モジュール | バージョン | サポートの種類 |
|---|---|---|
| bunyan | 1 以降 | 完全対応 |
| paperplane | 2.3.2 以降 | 完全対応 |
| pino | 2 以降 | 完全対応 |
| winston | 1 以降 | 完全対応 |
fibers は async_hooks と互換性がありません。これは Node.js のモジュールで、dd-trace-js が非同期コンテキストを追跡するために使用し、それによって正確なトレースを保証しています。fibers と async_hooks の間の相互作用は、予防できないクラッシュや未定義の挙動につながる可能性があります。そのため、fibers を直接、あるいは Meteor などのフレームワークを介して間接的に呼び出すアプリケーションで dd-trace-js を使用すると、不安定 (クラッシュ) や不正確なトレースが発生する可能性があります。
追加情報または議論については、この github 問題にコメントを残すか、サポートにお問い合わせください。
お役に立つドキュメント、リンクや記事:
