跳到主要内容

Linux 方式安装 light-agent

本文档将指导您在 Linux 服务器上安装和配置 light-agent。

操作环境说明

本文档中的所有操作均需要在 需要监控的业务服务器 上执行。light-agent 需要安装在您要监控的应用程序所在的服务器上。请确保您：

  1. 已登录到业务服务器
  2. 具有 root 权限或 sudo 权限
  3. 能够访问 Lighthouse 平台

系统要求​

支持的操作系统
  • CentOS/RHEL 7.x 及以上
  • Ubuntu 16.04 及以上
  • Debian 9 及以上
硬件要求
  • 内存：至少 512MB 可用内存
  • 磁盘空间：至少 1GB 可用空间
网络要求
  • 确保服务器能够访问 Lighthouse 平台
  • 防火墙需开放相关端口（默认 80）

前置条件​

  1. 确保系统已安装以下基础组件：
    • curl
    • systemd
  2. 确保有 root 或 sudo 权限
  3. 已获取 Lighthouse 平台的访问地址
提示

如果您使用的是最小化安装的 Linux 系统，可能需要先安装 curl：

# CentOS/RHEL
yum install -y curl

# Ubuntu/Debian
apt-get update && apt-get install -y curl

安装步骤​

1. 安装 light-agent​

在目标服务器上执行以下命令：

curl -sfL http://<Lighthouse IP>/downloads/install.sh | \
COLLECTOR_SERVER_HOST=<Lighthouse IP> \
sh -
参数说明
  • <Lighthouse IP>：替换为您的 Lighthouse 平台访问地址
  • COLLECTOR_SERVER_HOST：数据采集服务器地址

2. 验证安装​

执行以下命令检查服务状态：

systemctl status light-agent

查看运行日志：

journalctl -u light-agent

常用操作​

所有操作均在目标服务器上执行：

重启探针​

systemctl restart light-agent

停止探针​

systemctl stop light-agent

启动探针​

systemctl start light-agent

卸载探针​

/usr/local/light-agent/scripts/uninstall.sh

故障排除​

如果遇到问题，请在目标服务器上执行以下检查：

  1. 服务状态异常

    • 检查系统日志：journalctl -u light-agent -n 100
    • 确认服务器与 Lighthouse 平台的网络连通性

  2. 安装失败

    • 确认是否有足够的系统权限
    • 检查系统资源是否满足要求
    • 验证安装脚本的下载地址是否正确

  3. 数据上报异常

    • 检查配置文件中的服务器地址是否正确
    • 确认网络防火墙设置是否允许数据上报
注意事项
  • 安装过程需要 root 权限
  • 请确保系统时间同步正确
  • 建议定期检查探针状态和日志

技术支持​

如果您在安装或使用过程中遇到问题，请：

  1. 收集以下信息：
    • 操作系统版本和状态
    • light-agent 服务日志
    • 相关错误信息
  2. 联系技术支持团队获取帮助