使用应用发现服务自动发现线下IT资产、识别主机与进程的网络关系时,需要在局域网内的中心主机上安装采集器,用于收集整理探针采集的数据并形成日志文件。本文将介绍如何安装应用发现服务采集器。

前提条件

  • 确保您的主机的操作系统在支持列表中,请参见支持列表
  • 已在待安装采集器的中心主机上安装1.8及以上版本的JDK

操作步骤

  1. 登录应用发现服务控制台,然后在左上角选择地域。
  2. 概览页单击新手引导,然后在新手引导页面查看并保存license。
    新手引导
  3. 概览页单击下载采集器
    下载采集器
  4. 将安装包拷贝到待安装采集器的服务器上,并执行以下命令解压安装包。
    unzip apds-collector.zip
  5. 在解压文件中按需修改apds-collector.config文件中的参数。
    1. 以编辑模式进入apds-collector.config文件。
      vi  apds-collector.config
    2. 按i键开始编辑,按需修改各参数为真实配置。各参数含义如下:
      表 1. 参数含义
      参数 含义
      server.port RESTful API的端口号
      agent.port 连接探针的端口号
      logger.level 日志等级
      file.rolling.interval 离线文件中单个数据文件滚动的周期
      file.max.size.mb 离线文件总大小上限,达到上限要开始滚动数据文件(删除旧的数据文件写新的数据文件),单位为:MB。
      file.path 生成采集器离线文件的路径
      file.zip.path 压缩采集器离线文件的路径
      file.max.time.hour 离线文件采集的最大时长,达到时长后会开始自动滚动(删除旧的数据文件写新的数据文件),单位为:小时。
      encrypt 是否数据加密
      license 加密的密钥,若不加密可以不填。license在控制台查看,每个账户拥有唯一的license。
      agent.survival.time.hour 探针上报的最大时长(以第一个探针上报开始算采集起始点),单位为:小时。达到时长后会自动通知所有探针停止采集上报。若要探针再次开采,采集器需调用clean和startAll API。
      loggingRoot 日志根路径
      说明 所有配置参数均可缺省。
    3. 按Esc键结束编辑。
    4. 输入:wq!命令保存并退出apds-collector.config文件。
  6. 执行以下命令启动采集器。
    sh start.sh

结果验证

执行less apds-collector.log命令在 apds-collector.log查看采集器运行日志,若出现以下日志则表示启动成功 。
bind success, ip : ***.**.**.***, port : ****

后续步骤

采集器安装完成后,您还需要进行以下操作:

采集器和探针管理

  • 通过采集器安装包中的脚本文件来进行采集器和探针管理,各文件说明如下:
    表 2. 文件说明
    文件名 含义
    apds-collector.log 记录采集器运行日志。
    stop.sh 停止采集器。
    compress.sh 压缩采集器离线文件。运行脚本后,所有探针将停止采集数据,采集器离线文件开始打包 ,完成后所有探针将恢复采集。还可以通过执行 http://127.0.0.1:8082/compress 来完成此操作。
    status.sh 查看探针链接状态。还可以通过执行 http://127.0.0.1:8082/status 来完成此操作。
    stopAllAgentCollect.sh 使所有探针停止采集数据。还可以通过执行 http://127.0.0.1:8082/stopAll 来完成此操作。
    startAllAgentCollect.sh 使所有探针开始采集数据。还可以通过执行 http://127.0.0.1:8082/startAll 来完成此操作。
    reset.sh 清空本地采集器离线文件。还可以通过执行 http://127.0.0.1:8082/clean 来完成此操作。
  • 通过采集器的RESTful API进行探针和采集器管理,具体API参考含义如下:
    表 3. 采集器的RESTful API列表
    RESTful API 说明
    http://127.0.0.1:8082/start?vpcId=xxx&clientIp=yyy 指定某个探针开始采集上报数据,探针启动后默认是采集上报状态,也可以让其停止采集然后再次开启采集,如果探针重启后会默认变成采集上报状态。需指定探针的vpcId和clientIp。
    http://127.0.0.1:8082/stop?vpcId=xxx&clientIp=yyy 指定某个探针停止采集上报数据。需指定探针的vpcId和clientIp。
    http://127.0.0.1:8082/status 查看目前连接在线的所有探针的vpcId、clientIp和对应的探针状态。
    http://127.0.0.1:8082/compress 开始对本地采集的数据文件打压缩包,上传到web的是压缩包。
    http://127.0.0.1:8082/clean 清空本地的数据文件,此时agent.survival.time.hour重新开始计算。
    http://127.0.0.1:8082/startAll 使所有探针开始采集上报数据。
    http://127.0.0.1:8082/stopAll 使所有探针停止采集上报数据。
    http://127.0.0.1:8082/help API帮助提示信息。