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

要件

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

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

PHP ZTS ビルドは dd-trace-php バージョン 0.99 以降でサポートされていますが、PHP デバッグ ビルドは サポートされていません。

    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

    dd-trace-php ライブラリで次のプロファイリング機能を利用するには、以下の最小バージョンが必要です:

    機能必要な dd-trace-php バージョン
    Code Hotspots0.71+
    Endpoint Profiling0.79.0+
    タイムライン0.98.0+

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

    インストール

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

    1. Datadog Agent v6 以上がインストールされ、稼働していることを確認してください。Datadog は Datadog Agent v7+ の使用を推奨しています。

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

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

    4. datadog-setup.php の config モードを使用してプロファイラを設定します:

      # `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 などのサーバーは、INI 設定を変更した後に再起動が 必要です。

      詳細な INI 設定については 構成ドキュメント を参照してください。

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

    次のステップ

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

    その他の参考資料

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

    プロファイラーの概要ドキュメント more more 使用可能なプロファイルの視覚化の詳細ドキュメント more more プロファイラの使用中に発生する問題を修正ドキュメント more more PHP で例外プロファイリングを行うべき理由ブログ more more