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

Docs > Continuous Profiler > プロファイラーの有効化 > PHP プロファイラーの有効化

要件

すべての言語におけるランタイムとトレーサーの最小バージョンと推奨バージョンの要約については、サポートされている言語とトレーサーのバージョンをお読みください。

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

PHP ZTS builds are supported since dd-trace-php version 0.99+, while PHP debug builds are not supported.

glibc 2.17 以降を搭載した OS が必要です。以下のバージョン以降がこの要件を満たしています。

CentOS 7
EOL (End of Life) を迎えた Debian 8
EOL となった Ubuntu 14.04

Datadog では、EOL ではない OS のバージョンを実行することを推奨しています。

プロファイラーは musl v1.2 に対してビルドされているため、Alpine Linux のバージョン 3.13 以降が必要です。

また、次のコマンドを使用して libgcc_s をインストールする必要があります。

apk add libgcc

The following profiling features are available in the following minimum versions of the dd-trace-php library:

機能	Required `dd-trace-php` version
Code Hotspots	0.71+
Endpoint Profiling	0.79.0+
Timeline	0.98.0+ (beta since 0.89.0+)

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

インストール

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

Ensure Datadog Agent v6+ is installed and running. Datadog recommends using Datadog Agent v7+.
GitHub リリースページから datadog-setup.php スクリプトをダウンロードします。バージョン 0.69.0 は、このインストーラーを含む最初のトレーサーのリリースです。
トレーサーとプロファイラーの両方をインストールするために、例えば php datadog-setup.php --enable-profiling のようにインストーラーを実行します。このスクリプトは対話型で、検出された PHP の位置のどれにインストールするかを尋ねます。スクリプトの最後には、今後の使用のために非対話型バージョンのコマンド引数を出力します。

Configure the profiler using config mode through the datadog-setup.php:

# `datadog.profiling.enabled` is not required for v0.82.0+.
php datadog-setup.php config set -d datadog.profiling.enabled=1

php datadog-setup.php config set \
  -d datadog.service=app-name \
  -d datadog.env=prod \
  -d datadog.version=1.3.2

php hello.php

Apache, PHP-FPM and other servers require a restart after changing the INI settings.

See the configuration docs for more INI settings.