PHP プロファイラーの有効化

要件

Datadog Profiler を使用するには、64 ビットの Linux で、少なくとも PHP 7.1 が必要です。

以下は、非対応です。

• PHP ZTS ビルド
• PHP デバッグビルド
• Fibers (PHP 8.1+)

以下のプロファイリング機能は、dd-trace-php ライブラリの以下の最小バージョンで利用可能です。

Continuous Profiler は、AWS Lambda などのサーバーレスプラットフォームには対応していません。

APM に Datadog Agent を構成する

アプリケーションのプロファイリングを開始するには

1. すでに Datadog を使用している場合は、Agent をバージョン 7.20.2 以降または 6.20.2 以降にアップグレードしてください。

2. GitHub リリースページから datadog-setup.php スクリプトをダウンロードします。バージョン 0.69.0 は、このインストーラーを含む最初のトレーサーのリリースです。

3. トレーサーとプロファイラーの両方をインストールするために、例えば php datadog-setup.php --enable-profiling のようにインストーラーを実行します。このスクリプトは対話型で、検出された PHP の位置のどれにインストールするかを尋ねます。スクリプトの最後には、今後の使用のために非対話型バージョンのコマンド引数を出力します。

   PHP を呼び出す前に環境変数を設定します。例:

   # DD_PROFILING_ENABLED は バージョン 0.82.0 以上では不要です。
   export DD_PROFILING_ENABLED=true
   
   export DD_SERVICE=app-name
   export DD_ENV=prod
   export DD_VERSION=1.3.2
   
   php hello.php
   

   php-fpm の www.conf ファイルの env ディレクティブを使用します。次に例を示します。

   ; DD_PROFILING_ENABLED は バージョン 0.82.0 以上では不要です。
   env[DD_PROFILING_ENABLED] = true
   
   env[DD_SERVICE] = app-name
   env[DD_ENV] = prod
   env[DD_VERSION] = 1.3.2
   

   サーバー構成、バーチャルホスト、ディレクトリ、または .htaccess ファイルから SetEnv を使用します。

   # DD_PROFILING_ENABLED は バージョン 0.82.0 以上では不要です。
   SetEnv DD_PROFILING_ENABLED true
   
   SetEnv DD_SERVICE app-name
   SetEnv DD_ENV prod
   SetEnv DD_VERSION 1.3.2
   

その他の環境変数については、構成ドキュメントを参照してください。

4. リクエストを受け取ってから 1～2 分後、APM > Profiler ページにプロファイルが表示されます。

次のステップ

プロファイラーの概要ガイドでは、パフォーマンスの問題があるサンプルサービスを例に、Continuous Profiler を使用して問題を理解し修正する方法を確認します。

その他の参考資料

お役に立つドキュメント、リンクや記事:

プロファイラーの概要ドキュメント 使用可能なプロファイルタイプの詳細ドキュメント プロファイラの使用中に発生する問題を修正ドキュメント