设置代理编辑

先决条件编辑

操作系统编辑

代理目前仅适用于 Linux 操作系统。

PHP编辑

代理支持 PHP 版本 7.2-8.2。

curl编辑

代理需要 libcurl 7.58 或更高版本。

安装编辑

使用 支持平台的软件包 之一安装代理。

使用 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

从源代码构建编辑

如果您找不到您的发行版,您可以通过从源代码构建来安装代理。以下说明将使用 Elastic 用于构建我们官方软件包的相同 docker 环境来构建 APM 代理。

代理目前仅适用于 Linux 操作系统。

  1. https://github.com/elastic/apm-agent-php/ 下载代理源代码。
  2. 执行以下命令来构建代理并安装它
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

要正常工作,代理需要构建的 elastic_apm-*.so 和下载的源文件。因此,如果您想在一台机器上构建 elastic_apm-*.so,然后将其部署到另一台机器上,则需要复制构建的 elastic_apm-*.so 和下载的源文件。