安装
当前最新版本: v1.5.1
自动下载安装
一、 使用七牛账号登录logkit-pro官方网站,点击 <开始使用> ,进入 <机器管理页面>
二、在 <机器管理> 页面点击 <添加机器>
三、根据不同操作系统安装
Linux/Mac 用户安装
点击 添加机器页面的 <复制地址> 获得如下安装命令:
其中,您需要将 YOUR_ACCESS_KEY 换成您实际的七牛access_key,将 YOUR_SECRET_KEY 换成您实际的七牛secret_key,将 YOUR_EMAIL 换成您实际的账号邮箱。((在七牛云网站的<个人面板> <秘钥管理>中获取)),替换后您看到的实际命令类似如下:
注: 若您不执行上述的信息替换,也可以成功安装,命令执行的下载脚本中会带有token鉴权方式,网络通畅的情况下会自动刷新。若网络长时间(超过1个月)中断,则token会过期,导致安装的logkit-pro无法再连接到服务器,替换为您实际的access_key信息后没有该隐患。
打开一个命令控制台执行上述命令即可安装成功,如下图所示:
Windows 用户安装
点击 <下载文件> , 在Windows系统中直接鼠标双击执行,即可安装,如下所示。
注: 下载的文件会包含access_key等鉴权信息。
四、下载成功后可以在logkit-pro公有云界面上看到连接过来的机器已经在线
至此,您已经安装成功,可以开始使用啦。
自动安装到的本地目录
Linux用户root权限: /var/local/logkit-pro/agent
Linux用户非root权限: $HOME/logkit-pro/agent
在当前用户的主目录下。
Windows用户: C:\logkit-pro
Mac用户: $HOME/logkit-pro/agent
在当前用户的主目录下。
对应的日志文件也在安装目录下的logkit.log
文件。
手动下载安装
注意: 在
0.3.0
及以前的版本只支持手动安装,并且不支持连接到服务器,0.3.0
开始,手动安装的logkit-pro不仅可以单机运行,也可以连到服务器运行。
Windows 版本 logkit-pro 下载
Linux Ubuntu/Debian 版本下载
Linux Centos/Redhat 版本下载
Centos/Redhat 64位版本下载
Centos/Redhat 32位版本下载
MacOS 版本下载
启动 logkit-pro
修改配置文件
注意,手动安装需要修改配置文件,只需将配置文件中 connect_to_server
选项改为 true
, 并在ak、sk位置填入您对应七牛账号的access_key
和secret_key
(在七牛云网站的<个人面板> <秘钥管理>中获取)
修改后的配置如图所示:
直接启动
在命令控制台(Console), 进入 logkit-pro 所在的文件夹,然后输入(某些版本可能配置文件的名称可能为logkit.conf
):
./logkit-pro -f logkit-pro.conf
后台启动
通过命令行进入 logkit-pro 所在的文件夹,然后输入:
nohup ./logkit-pro -f logkit-pro.conf > logkit.log 2>&1 &
[可选]supervisor管理
我们强烈推荐您使用supervisor管理logkit-pro,具体可以查看文档: 使用supervisor管理logkit-pro
其他安装方式
Docker 镜像版本下载
docker pull pandora1/logkit:v1.5.1
docker run -d -p 3000:3000 -e QINIU_ACCESS_KEY='修改为您的七牛access_key' -e QINIU_SECRET_KEY='修改为您的七牛secret_key' -v /local/logkit/meta:/app/meta -v /local/logkit/.logkitconfs:/app/.logkitconfs -v /local/logkit/dataconf:/app/confs -v /local/log/path:/logs/path pandora1/logkit:v1.5.1
镜像中的 logkit-pro 收集
/logs
目录下的日志,需要把本地的日志目录也挂载到镜像里面去才能启动,比如本地的日志目录为/local/log/path
, 挂载到镜像中的/logs/path
目录,那么收集器配置中填写的日志路径必须是/logs/path
。
其他如读取socket
、mysql
等,请注意docker启动时的网络模式,选择host模式。
可能需要挂载的目录如下:
/app/confs
这个目录是为了命令行用户准备的,可以通过挂载目录的形式直接往里面放配置文件,热加载,无需页面操作。/app/.logkitconfs
这个目录是服务端或本地WEB页面配置的logkit收集器配置保存的目录。/app/meta
这个目录记录了当前收集器读取的状态,保证数据读取不重不漏。/logs/path
这个目录是您的日志所在目录。
如果只用WEB界面添加(分发)的配置,可以不挂载
/app/confs
。