设置 Agent
编辑设置 Agent
编辑先决条件
编辑操作系统
编辑Agent 目前仅适用于 Linux 操作系统。
PHP
编辑Agent 支持 PHP 7.2-8.2 版本。
curl
编辑Agent 需要 libcurl 7.58 或更高版本。
安装
编辑使用以下之一安装 Agent 受支持平台的软件包。
使用 RPM 软件包 (RHEL/CentOS、Fedora)
编辑rpm -ivh <package-file>.rpm
使用 DEB 软件包 (Debian、Ubuntu 18+)
编辑dpkg -i <package-file>.deb
使用 APK 软件包 (Alpine)
编辑apk add --allow-untrusted <package-file>.apk
从源代码构建
编辑如果您找不到您的发行版，您可以通过从源代码构建来安装 Agent。以下说明将使用 Elastic 用于构建官方软件包的相同 Docker 环境来构建 APM Agent。
Agent 目前仅适用于 Linux 操作系统。
- 从 https://github.com/elastic/apm-agent-php/下载 Agent 源代码。
- 执行以下命令以构建 Agent 并安装它
cd apm-agent-php
# for linux glibc - libc distributions (Ubuntu, Redhat, etc)
export BUILD_ARCHITECTURE=linux-x86-64
# for linux with musl - libc distributions (Alpine)
export BUILD_ARCHITECTURE=linuxmusl-x86-64
# provide a path to php-config tool
export PHP_CONFIG=php-config
# build extensions
make -f .ci/Makefile build
# run extension tests
PHP_VERSION=`$PHP_CONFIG --version | cut -d'.' -f 1,2` make -f .ci/Makefile run-phpt-tests
# install agent extensions
sudo cp agent/native/_build/${BUILD_ARCHITECTURE}-release/ext/elastic_apm-*.so `$PHP_CONFIG --extension-dir`
# install automatic loader
sudo cp agent/native/_build/${BUILD_ARCHITECTURE}-release/loader/code/elastic_apm_loader.so `$PHP_CONFIG --extension-dir`
通过将以下内容添加到您的 php.ini 文件中来启用扩展
extension=elastic_apm_loader.so elastic_apm.bootstrap_php_part_file=<repo root>/agent/php/bootstrap_php_part.php
为了正常工作，Agent 需要构建的 elastic_apm-*.so 和下载的源文件。因此，如果您想在一台机器上构建 elastic_apm-*.so，然后在另一台机器上部署它，则需要复制构建的 elastic_apm-*.so 和下载的源文件。