DDTrace PHP
安装依赖¶
PHP APM 插件安装,参见 Datadog PHP 接入文档。
配置¶
根据 PHP 实际运行环境不同(Apache/NGINX),其配置有一些差异,详见 Datadog PHP trace SDK 配置文档。
Web 项目中一个请求就是一个进程,会导致中心的资源目录数据流很大,所以建议关闭资源上报:
#ENV
export DD_INSTRUMENTATION_TELEMETRY_ENABLED=false
#command
-Ddd.instrumentation.telemetry.enable=false
环境变量支持¶
下面是常用的 PPH APM 参数配置,完整的参数配置列表,参见 Datadog 文档。
-
DD_AGENT_HOSTINI:
datadog.agent_host默认值:
localhostDataKit 监听的主机地址
-
DD_TRACE_AGENT_PORTINI:
datadog.trace.agent_port默认值:
8126DataKit 监听端口号,此处需手动指定为 9529
-
DD_ENVINI:
datadog.env默认值:
null设置程序环境信息,比如
prod/pre-prod -
DD_SERVICEINI:
datadog.service默认值:
null设置 APP 服务名
-
DD_SERVICE_MAPPINGINI:
datadog.service_mapping默认值:
null重命名 APM 服务名,比如
DD_SERVICE_MAPPING=pdo:payments-db,mysqli:orders-db -
DD_TRACE_AGENT_CONNECT_TIMEOUTINI:
datadog.trace.agent_connect_timeout默认值:
100Agent 连接 DataKit 超时配置 (单位 ms),默认 100
-
DD_TAGSINI:
datadog.tags默认值:
null设置每个 span 上都会默认追加的 tag 列表,例如:
key1:value1,key2:value2 -
DD_VERSIONINI:
datadog.version设置服务版本
-
DD_TRACE_SAMPLE_RATEINI:
datadog.trace.smaple_rate默认值:
-1设置采样率从 0.0(0%) ~ 1.0(100%)。