OneAPM for Nginx

Jerry 发表于 2016年08月25日 17:48 最后修改于 2016年08月25日 18:36

简介

Nginx 探针分为两部分,分别是 Agent 和 Daemon

Agent 是Nginx 扩展,负责抓取Nginx 数据

Daemon 是一个独立的Linux可执行程序,负责合并,缓存Agent发过来的数据

注:该安装文档是针对现有服务器已有Nginx Server, 要安装探针的情况。

下文约定 /usr/local/nginx/sbin/nginx 为服务器当前运行 Nginx Server

请通读全文后,再进行部署,部署前最好备份nginx的可执行文件与配置文件

 

下载安装包

oneapm-nginx.tar.gz , 解压后参考下图

 

安装Nginx 探针

1.     解压压缩包并进入目录

tar zxvf oneapm-nginx.tar.gz && cd oneapm-nginx

2.     编译 Nginx Agent

例如:

./oneapm_nginx_agent_install.sh --nginx-path=/usr/local/nginx/sbin/nginx

注:--nginx-path, 该参数为当前Nginx 可执行程序的绝对路径 必填

上图,表示nginx agent 编译成功 (如果nginx不止一份配置文件,请看附录)

3.     安装 Nginx Daemon

cd oneapm-nginx-agent-install-script/

./oneapm-install install --license=license --name=appname,tiername

注:appname 是应用名称(应与Java探针名称一致),tiername是nginx层名称

4.     启动 Daemon ,并重启 nginx

oneapm-daemon

service nginx restart

还原Nginx卸载Daemon

mv -f /usr/local/nginx/sbin/nginx.oneapm.old /usr/local/nginx/sbin/nginx

./oneapm-install uninstall

注:编译nginx agent 时,如果编译成功会将原nginx 二进制文件重命名为 nginx.oneapm.old 备份

 

附录

1.     配置文件说明

logfile:日志存放目录

loglevel:日志级别 off, error, warn, info, trace, debug

collector_host:Server 端 IP

port:端口号

ssl_connect:是否启用ssl协议,如果启用配置为1

enable:是否启用nginx探针

applicationName:app应用名称

tierName:nginx探针tier名称

 

loglevel 和enable修改后无需重启oneapm-daemon和nginx,

修改后动态生效(1min),其他配置修改后需要重启oneapm-daemon和nginx

 

终止oneapm-daemon命令:oneapm-daemon -s stop

启动oneapm-daemon命令:oneapm-daemon 回车

 

2.     ./oneapm_nginx_agent_install.sh 主要动作说明

1.     自动解压 当前目录里的 Nginx1.6 压缩包

2.     拷贝Nginx Agent 脚本和 源码到 Nginx1.6 源码包目录

3.     获取当前运行的 Nginx 编译选项,并添加 Agent 编译参数,编译Nginx

4.     备份现运行Nginx文件为nginx.oneapm.old, 拷贝编译目录下的Nginx二进制文件覆盖现运行Nginx 二进制文件

 

3.     Nginx 加载多分配置文件情况

如果该 Nginx Server 加载了多份不同的配置文件

在 ./oneapm_nginx_agent_install.sh 运行结束后

通过 $your_nginx_path/nginx -t -c $your_nginx_config_path 来测试各个配置文件是否能正常加载。./oneapm_nginx_agent_install.sh 只会通过 nginx -t 测试nginx 默认配置文件

注:此功能特性目前仅 Ai 企业版支持,如有相关需求或问题,请随时联系我们,谢谢!http://www.oneapm.com/info/about.html


回复

回复已关闭