百度日志服务BLS

    收集器安装

    收集器是百度日志服务提供的、安装于主机中的服务组件,安装之后收集器会监听相应的文件,收集日志文件内容并投递至目的地址中。目前收集器支持64位的Linux系统,如需支持其他系统,请提工单申请。

    安装步骤

    1. 登录百度智能云控制台,导航栏选择“产品服务>数据分析>百度日志服务 BLS”进入百度日志服务页面。
    2. 首次使用百度日志服务BLS需开通服务,请点击“开通服务”按钮。
    3. 点击左侧导航栏“收集器”,子菜单选择“收集器安装”,进入收集器安装页面。
    4. 系统自动创建了认证Token,同时也生成了与此Token和操作系统绑定的安装命令,使用安装命令可在您的主机中安装百度日志服务的收集器。BLS支持在CentOS、Ubuntu、Debian系统中安装和部署,请选择您的操作系统,并点击“复制”按钮,安装命令便复制到您的剪贴板中。

    image.png

    说明:如未显示安装命令的“复制”按钮,请参考常见问题之为什么浏览器中不显示安装命令的“复制”按钮?

    1. 安装命令样例与解释。

       wget -O - https://logbeat-repo-sz.su.bcebos.com/install-logbeat-sz.sh | bash /dev/stdin <token值> <OS版本> install /opt root
       

      该命令中,<token值>表示用户在的BLS服务器端的唯一认证标识,无需用户修改;<OS版本>为所安装的系统版本,如centos/ubuntu/debian;随后为执行安装命令;最后为收集器安装目录和本地运行用户,您可以自定义指定此安装目录和本地运行用户。注意最后一个参数是指定本地运行收集器的用户,与执行安装命令的用户不一定是一个用户。区别是,一个是用哪个用户安装收集器,如root等;一个是以哪个用户启动收集器,如work等。

      说明:同一台机器上支持安装多个收集器,只要指定不同安装目录即可,不同收集器间相互独立运行,但同一个token应该只安装一个收集器。

    2. 登录您的主机,您可在root权限下执行安装命令。此时,如果本地运行账户不存在,安装脚本会创建本地运行账户,并以它启动收集器。并且在root权限下执行安装命令,脚本会为系统添加服务命令:service logbeatd [start/stop/status/restart]和开机自启动服务。

      注意:以您指定的本地账户启动收集器后,对于待采集的文件,需要有该账户的读取权限,目录路径需要有该账户的读取和执行权限。

    3. 您也可以使用非root用户安装收集器,需要注意的是与用root用户安装的差别就是安装脚本不会添加服务命令与开机自启服务。
    4. 显示如下提示信息即代表收集器安装成功。

      Configure agent with token: 2687cdf2-245d-6c3f-37ba-d7ad84925024 ...done.
      Start bls agent.

    如何在安装收集器时同时部署任务

    如果您希望把日志服务提供的收集器打包在镜像文件中,便于快速部署同样配置的服务器,请预先创建传输任务,并在安装时添加任务参数,具体说明如下:

    1. 在“收集器安装”页面选择对应的操作系统并复制安装命令
    2. 在传输任务列表页中查找、选择您想要预置的传输任务,记录这些传输任务任务ID
    3. 在安装命令最后附加这些任务ID作为任务参数,格式如下:

      wget -O - https://logbeat-repo-sz.su.bcebos.com/install-logbeat-sz.sh | bash /dev/stdin <token值> <OS版本> install /opt root [task1ID,task2ID,task3ID...]

      说明:
      a) 任务ID列表与上一参数间须空一格
      b) 多个任务间以英文“,”连接,并且不能有空格
      c) 任务列表必须以英文"[]"包裹
      d) 仅支持您账户下创建的传输任务ID,您无法添加其他人创建的传输任务
      e) 传输任务ID错误不影响收集器正常运行

      示例如下: 在Ubuntu主机中安装收集器并部署两个传输任务

      wget -O - https://logbeat-repo-sz.su.bcebos.com/install-logbeat-sz.sh | bash /dev/stdin cdda****5880 ubuntu install /opt root [3482****4b6a,b5b6****2c93]

    更新收集器

    更新方法为执行收集器根目录中,bin/update.sh脚本,该脚本可以附带一个参数[version],如:

    sh bin/update.sh [latest/1.1.1]

    不填则默认为latest,表示更新为最新的收集器。

    卸载收集器

    第一步:停止收集器进程:service logbeatd stop;或者执行/opt/logbeat/bin/stop.sh;

    第二步:删除收集器目录:rm -rf /opt/logbeat。

    上一篇
    百度智能云环境准备
    下一篇
    收集器管理