- 重要な情報
- はじめに
- 用語集
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
The Datadog Profiler requires at least PHP 7.1, on 64-bit Linux.
The following are not supported:
An operating system with glibc 2.17 or newer is required. The following versions or newer meet this requirement:
Datadog recommends running an OS version that is not EOL.
Version 3.13 or newer of Alpine Linux is required because the profiler is built against musl v1.2.
The following profiling features are available in the following minimum versions of the dd-trace-php
library:
Feature | Required dd-trace-php version |
---|---|
Code Hotspots | 0.71+ |
Endpoint Profiling | 0.79.0+ |
Continuous Profiler is not supported on serverless platforms, such as AWS Lambda.
To begin profiling applications:
If you are already using Datadog, upgrade your Agent to version 7.20.2+ or 6.20.2+.
Download the datadog-setup.php
script from the GitHub release page. Version 0.69.0 is the first tracer release to include this installer.
Run the installer to install both the tracer and profiler, for example php datadog-setup.php --enable-profiling
. This script is interactive and asks which of the detected PHP locations it should install to. At the end of the script, it outputs the non-interactive version of the command arguments for future use.
Set the environment variables before calling PHP, for example:
# DD_PROFILING_ENABLED is not required for v0.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
Use the env
directive in the php-fpm’s www.conf
file, for example:
; DD_PROFILING_ENABLED is not required for v0.82.0+
env[DD_PROFILING_ENABLED] = true
env[DD_SERVICE] = app-name
env[DD_ENV] = prod
env[DD_VERSION] = 1.3.2
Use SetEnv
from the server config, virtual host, directory, or .htaccess
file:
# DD_PROFILING_ENABLED is not required for v0.82.0+.
SetEnv DD_PROFILING_ENABLED true
SetEnv DD_SERVICE app-name
SetEnv DD_ENV prod
SetEnv DD_VERSION 1.3.2
See the configuration docs for more environment variables.
A minute or two after receiving a request, profiles appear on the APM > Profiler page.
The Getting Started with Profiler guide takes a sample service with a performance problem and shows you how to use Continuous Profiler to understand and fix the problem.