夜莺监控客户端配置手册(agent)

滴滴服务器端安装完成后，需要在其他安装客户端(agent)才可以实现数据监控，agent打包方法请参考夜莺部署手册

环境准备：

服务端IP地址：192.168.170.132

目标端ip地址：192.168.170.135(centos7)

部署步骤：

1、在目标服务器上创建文件夹n9e，执行命令如下：

mkdir /home/n9e

2、将agent.tgz压缩文件上传到/home/n9e目录下，并解压，如图：

3、进入etc目录中，编辑address.yml文件，如图：

将address.yml中的127.0.0.1的IP地址更换成服务端的ip地址，可通过sed命令替换，如图：

4、编辑服务配置文件，将agent做成系统服务，内容如下：

[Unit]
Description=n9e agent
After=network-online.target
Wants=network-online.target

[Service]
# modify when deploy in prod env
User=root
Group=root

Type=simple
Environment="GIN_MODE=release"
ExecStart=/home/n9e/n9e-agent
WorkingDirectory=/home/n9e

Restart=always
RestartSec=1
StartLimitInterval=0

[Install]
WantedBy=multi-user.target

5、配置完成后，通过以下命令启动agent，执行命令如下：

systemctl start agent

systemctl enable agent

注意：agent使用端口为2080，因此需要本机防火墙通过2080端口

centos6部署客户端

1、将客户端文件上传到目标服务器上，解压后，修改address.yml文件，修改内部的服务端地址

2、编辑identity.yml文件，修改内部的获取资源命令，修改内容如下：

ifconfig route|grep '^default'|awk '{print $NF}'|grep inet|awk ‘{print $2}’|head -n 1 |awk -F “:” ‘{print $2}’

注意两条命令都要修改

3、编辑服务启动文件vim /etc/init.d/n9e，添加内容如下：

添加完成后，通过service n9e stop|start|restart即可实现启停

通过chkconfig n9e on 实现开机自启动

注意：第二行和第三行必须要加上，否则添加开启自启动会报错service n9e does not support chkconfig，其中2345表示默认启动级别， 10是启动优先级，90是停止优先级，优先级范围是0－100，数字越大，优先级越低。

级别有0-6共7个级别 ：

• 等级0表示：表示关机 　
• 等级1表示：单用户模式
• 等级2表示：无网络连接的多用户命令行模式 　
• 等级3表示：有网络连接的多用户命令行模式
• 等级4表示：不可用
• 等级5表示：带图形界面的多用户模式
• 等级6表示：重新启动

注意：如果启动agent后服务端看不到资产，可能是数据没有上报成功，此时可以检查identiey.yml中脚本是否可以正确获取到IP地址，如果不能那就修改脚本

如果还是不能获取到(概率非常小)，也可以直接将IP地址写死在配置文件中，如图：

windows客户端配置

1、将windows客户端软件包放在对应的服务器上，编辑etc目录下的address.yml,如图：

修改其中的IP地址为服务端的IP地址，如图：

配置完成后，在可执行程序上右键，以管理员方式运行即可，如图：

2、上述配置完成后在服务端的资产管理系统即可接收到数据，并可查看各项指标的监控情况

备注：如果担心不小心关闭程序窗口，还可以通过上图中的nssm将程序打包成服务，此时即可实现后台运行，打包方法如下：

1、首先通过dos窗口进入到nssm目录下，执行命令nssm install 服务名称，如图：

在弹出的服务框中，选择可执行文件的位置，如图：

然后点击install service安装即可，如图：

安装完成后进入到服务中可以看到已经安装的服务，启动即可，如图：

启动后，在服务端的资产管理系统里可以看到新增的机器，同时可以看到监控的资源情况，如图：

注意：如果看不到监控信息，请检查tsdb模块，此模块为存储数据模块

Windows客户端监听端口为2058，注意防火墙开通端口即可

注意：因为agent需要上报数据给ams，transfer，monapi，同时执行任务，因此需要开通agent所在机器到服务端机器的8002、8004、8005、8006、8008、8009端口

附加：如果collector起来后，服务端看不到资产，说明未上报成功，可以检查是否无法获取到IP，如果系统有多个网卡可能会出现无法自动获取IP的情况，此时可以将IP地址写死在配置文件中，如图：

重启服务，即可看到资产信息