Kibana|Kibana 启用 PHP APM

本篇文章主要是解释如何使用ES的APM功能进行获取运行状态。其实官网有安装流程,我仅仅是把我安装的过程记录下。
前言 因为阿里云有ARMS。正好跟网上的朋友沟通的时候知道了APM。突然发现阿里云的AMRS不就是APM么。又因为ARMS只最高支持PHP7.3,所以我特意过来看下ES的APM如何安装,因为它支持PHP8.0。支持的版本也比较新。
首先请按照前面两篇文章进行设置ubuntu 安装 ElasticSearch和ubuntu 安装 kibana。
安装所需的包 这里我们需要的是 apm-server。执行以下命令即可安装:

sudo apt install apm-server

【Kibana|Kibana 启用 PHP APM】最后执行启动命令即可。
管理命令 启动:
sudo systemctl start apm-server

停止:
sudo systemctl stop apm-server

重新启动:
sudo systemctl restart apm-server

设置开机启动:
sudo systemctl enable apm-server

取消开机启动
sudo systemctl disable apm-server

查看运行状态
sudo systemctl status apm-server

PHP Agent 这里需要安装一个扩展。首先的话是需要安装PHP的。这里有一篇安装 PHP8.0 的文章可以用来参考。
如果不是 apt 安装的 PHP,建议采用下面的 手动安装 的办法。
首先从 GitHub 包下载 中下载指定的 deb 包。
然后执行命令安装 agent:
sudo dpkg -i .deb

安装成功后可编辑的配置文件地址为:/etc/php/8.0/fpm/conf.d/99-elastic-apm-custom.ini
手动安装 可以执行如下步骤进行编译安装。
首先我们需要将源代码存储到一个目录中。比如说 /usr/local/src
首先就是下载文件并解压:
sudo wget -c https://github.com/elastic/apm-agent-php/archive/refs/tags/v1.3.tar.gz sudo tar zxf v1.3.tar.gz

然后我们切入要编译的目录并执行编译命令
cd apm-agent-php-1.3/src/ext sudo phpize sudo CFLAGS="-std=gnu99" ./configure --enable-elastic_apm sudo make sudo make install

完成后在 php.ini 添加以下配置,以便启用 elastic_apm
extension=elastic_apm.so elastic_apm.bootstrap_php_part_file=/src/bootstrap_php_part.php

配置
  • elastic_apm.environment
设置环境名称。比如说测试环境可以设置为 testing 或者 production。用来区分环境变量。
  • elastic_apm.hostname
设置主机名称。因为默认都是随机的名称,可以设置为更加人性化的名称。如果该名称没有设置,则默认读取主机的名称
  • elastic_apm.server_url
APM 服务器的链接地址。包含协议和端口。默认地址是 http://localhost:8200,如果 APM 服务器不在本机则需要进行设置。
  • elastic_apm.service_name
服务的名称。也就是项目的名称。比如说 api 项目, base 项目等。
  • elastic_apm.service_node_name
节点名称。当有web集群的时候,该设置特别有用。比如说名称为 php-1等等。
  • elastic_apm.service_version
服务的版本号。比如说PHP的话可以使用 commit ID 作为版本号。可以设置为 git rev-parse HEAD 或者使用简写 git log --pretty="%h" -n1 HEAD
  • elastic_apm.transaction_sample_rate
设置对请求采样的频率。默认是 1.0,范围是 0.0 ~ 1.0 之间,如果为不收集,则不记录上下文信息,标签或者跨度。
最后 这样重启PHP,访问几个链接就可以在 Kibana 中查看到 APM 收集的相关信息了。

    推荐阅读