使用应用发现服务自动发现线下 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 帮助提示信息。