- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
PHP Datadog Trace ライブラリはオープンソースです。詳細については、GitHub リポジトリをご覧ください。
Datadog APM for PHP は、ホスト OS や PHP ランタイム、特定の PHP ライブラリ、 Datadog Agent や API の特定のバージョンで定義される依存関係に基づいて構築されています。 これらのバージョンがメンテナによってサポートされなくなった場合、 Datadog APM for PHP はこれらのサポートにも制限をかけます。
レベル | サポート内容 |
---|---|
非対応 | 実装していません。特別なご要望はカスタマーサポートチームにお問い合わせください。 |
ベータ版 | 初期実装です。まだすべての機能が含まれていない可能性があります。新機能のサポート、バグやセキュリティの修正は、ベストエフォートで提供されます。 |
一般提供 (GA) | 全機能の完全実装。新機能、バグ、セキュリティフィックスを完全サポート。 |
メンテナンス | 既存機能の完全実装。新機能は受けません。バグフィックス、セキュリティフィックスのみの対応となります。 |
レガシー | レガシーな実装。機能は限定されますが、メンテナンスは提供されません。[特別なご要望がある場合は、サポートチームにお問い合わせください。 |
サポート終了 (EOL) | サポートなし。このバージョンはまだ使用可能ですが、バグ修正は提供されません。 |
PHP APM は以下のバージョンの PHP (ZTS と NTS の両方) に対応しています。
PHP バージョン | サポートレベル | パッケージバージョン |
---|---|---|
8.2.x | 一般提供 | > 0.82.0+ |
8.1.x | 一般提供 | > 0.66.0+ |
8.0.x | 一般提供 | > 0.52.0+ |
7.4.x | 一般提供 | すべて |
7.3.x | 一般提供 | すべて |
7.2.x | 一般提供 | すべて |
7.1.x | 一般提供 | すべて |
7.0.x | 一般提供 | すべて |
5.6.x | メンテナンス (2023 年 12 月 31 日まで) | すべて |
5.5.x | メンテナンス (2023 年 12 月 31 日まで) | すべて |
5.4.x | メンテナンス (2023 年 12 月 31 日まで) | すべて |
PHP APM は以下の SAPI に対応しています。
SAPI | サポートの種類 |
---|---|
apache2handler | 完全対応 |
cli | 完全対応 |
fpm-fcgi | 完全対応 |
cgi-fcgi | 完全対応 |
PHP APM は以下のアーキテクチャに対応しています。
プロセッサアーキテクチャー | サポートレベル | パッケージバージョン |
---|---|---|
Linux GNU amd64 (x86-64-linux-gnu ) | GA | すべて |
Linux MUSL amd64 (x86-64-linux-musl ) | GA | すべて |
Linux GNU arm64 (aarch64-linux-gnu ) | GA | > 0.78.0 |
Linux MUSL arm64 (aarch64-linux-musl ) | GA | > 0.78.0 |
Datadog はデフォルトで、すべての PHP Web フレームワークをサポートし、フレームワークレベルのインスツルメンテーション、または一般的な Web トレースを行うことができます。
フレームワークレベルのインスツルメンテーションには、内部メソッドのトレースとフレームワーク固有のタグ付けが含まれます。
一般的な Web トレースには、データベースや HTTP クライアントなどのサポートされたライブラリのスパンに加えて、コールから発生したレイテンシーやエラーを追跡するための web.request
スパンが含まれています。
次の表は、Datadog が正常にトレースするフレームワークとバージョンの一部を示しています。
ウェブフレームワーク:
モジュール | バージョン | サポートの種類 | インスツルメンテーションレベル |
---|---|---|---|
CakePHP | 2.x | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
CodeIgniter | 2.x | PHP 7+ | フレームワークレベルのインスツルメンテーション |
CodeIgniter | 3.x | PHP 7+ | 一般的な Web トレース |
Drupal | サポートされているすべての PHP バージョン | 一般的な Web トレース | |
FuelPHP | 1.1 | PHP 7+ | 一般的な Web トレース |
Laminas | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション | |
Laravel | 4.2、5.x、6.x | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
Laravel 8 | 8.x (トレーサー 0.52.0+ ) | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
Lumen | 5.2+ | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
Magento | 1、2 | サポートされているすべての PHP バージョン | 一般的な Web トレース |
Neos Flow | 1.1 | サポートされているすべての PHP バージョン | 一般的な Web トレース |
Phalcon | 1.3、3.4 | サポートされているすべての PHP バージョン | 一般的な Web トレース |
RoadRunner | 2.x | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
Slim | 2.x、3.x、4.x | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
Symfony | 2.x、3.3、3.4、4.x、5.x、6.x | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
WordPress | 4.x、5.x | PHP 7+ | フレームワークレベルのインスツルメンテーション |
Yii | 1.1、2.0 | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
Zend Framework | 1.12、1.21 | サポートされているすべての PHP バージョン | フレームワークレベルのインスツルメンテーション |
Zend Framework | 2.x | サポートされているすべての PHP バージョン | 一般的な Web トレース |
このリストにウェブフレームワークがない場合でも、トレーサーの最新リリースではそのまま使用できます。
Datadog では、PHP ウェブフレームワークのより詳細なトレースのためのサポートを継続的に追加しています。スパンメタデータおよびフレームワーク内部に対するさらなるサポートをご希望の場合は、サポートチームまでお気軽にお問い合わせください。
デフォルトで、CLI SAPI からのトレースは無効になっています。PHP CLI スクリプトのトレースを有効にするには、DD_TRACE_CLI_ENABLED=true
とします。
モジュール | バージョン | サポートの種類 |
---|---|---|
CakePHP Console | 2.x | 完全対応 |
Laravel Artisan | 5.x、8.x | 完全対応 |
Symfony CLI | 4.x、5.x、6.x | 完全対応 |
追加 CLI ライブラリに関するサポートをご希望の場合は、サポートチームまでお気軽にお問い合わせください。
モジュール | バージョン | サポートの種類 |
---|---|---|
Amazon RDS (PDO または MySQLi 使用) | (対応する PHP) | 完全対応 |
Elasticsearch | 1+ | 完全対応 |
Eloquent | Laravel 対応バージョン | 完全対応 |
Laravel キュー | Laravel 対応バージョン | 完全対応 |
Memcache | (対応する PHP) | 完全対応 |
Memcached | (対応する PHP) | 完全対応 |
MongoDB - mongo 拡張機能を使用 | 1.4.x | 完全対応 |
MySQLi | (対応する PHP) | 完全対応 |
PDO | (対応する PHP) | 完全対応 |
PhpRedis | 3、4、5 | PHP 7、8 |
Predis | 1.1 | 完全対応 |
SQLSRV | (対応する PHP) | 完全対応 |
追加データストアに関するサポートをご希望の場合は、サポートチームまでお気軽にお問い合わせください。
モジュール | バージョン | サポートの種類 |
---|---|---|
Amqp | 2.x、3.x | PHP 7.1+ |
Curl | (対応する PHP) | 完全対応 |
Guzzle | 5.x、6.x、7.x | 完全対応 |
ライブラリに関するサポートをご希望の場合は、サポートチームまでお気軽にお問い合わせください。
コールスタックは PHP 5 のみに限定されます。詳細は深いコールスタックのトラブルシューティングページを参照してください。
ジェネレータのインスツルメントは、PHP 5 および PHP 7 ではサポートされていません。
Datadog は、pcntl を使ってフォークされたプロセスのトレースをサポートしています。pcntl_fork
のコールが検出されると、専用のスパンが作成され、フォークされたプロセスがインスツルメントされます。これは DD_TRACE_FORKED_PROCESS
で無効にすることができます。詳細については、ライブラリの構成ページを参照してください。
アプリケーションが pcntl_unshare(CLONE_NEWUSER);
を実行し、トレーサーがインストールされている場合、アプリケーションは致命的にクラッシュします。これは、CLONE_NEWUSER
を持つ unshare
がプロセスをスレッド化しないことを要求し、PHP トレーサーが別スレッドを使用してメインプロセスをブロックせずに Datadog Agent にトレースを送信するために起こります。
お役に立つドキュメント、リンクや記事: