linux中如何安装使用open-falcon agent

发布时间：2022-02-18 11:37:42 作者：小新
来源：亿速云阅读：227

# Linux中如何安装使用Open-Falcon Agent

## 一、Open-Falcon简介

Open-Falcon是小米公司开源的一款企业级监控系统，具有以下核心特点：
- 分布式架构设计，支持水平扩展
- 高性能数据采集和处理能力
- 灵活的告警策略配置
- 丰富的可视化功能
- 支持多种数据采集方式

Agent是Open-Falcon监控体系中的数据采集终端，负责：
1. 定期采集主机指标数据（CPU、内存、磁盘等）
2. 执行用户自定义的监控脚本
3. 将采集数据上报给Transfer组件

## 二、环境准备

### 2.1 系统要求
- 操作系统：主流Linux发行版（CentOS 7+/Ubuntu 16.04+）
- 硬件配置：
  - 最低配置：1核CPU/512MB内存
  - 推荐配置：2核CPU/2GB内存
- 网络要求：
  - 能访问Open-Falcon的Transfer服务（默认端口：8433）

### 2.2 依赖安装
```bash
# CentOS/RHEL
sudo yum install -y git wget curl tar

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y git wget curl tar

三、安装Open-Falcon Agent

3.1 下载安装包

官方提供两种安装方式：

方式一：直接下载二进制包

wget https://github.com/open-falcon/falcon-plus/releases/download/v0.3/open-falcon-v0.3.tar.gz
tar -zxvf open-falcon-v0.3.tar.gz
cd open-falcon-v0.3/

方式二：源码编译安装

git clone https://github.com/open-falcon/falcon-plus.git
cd falcon-plus
make agent
cd open-falcon

3.2 配置Agent

修改配置文件agent/config/cfg.json：

{
    "debug": true,
    "hostname": "",  // 自动获取主机名，建议保持为空
    "ip": "",        // 自动获取IP地址
    "plugin": {
        "enabled": true,
        "dir": "./plugin",  // 插件目录
        "git": "https://github.com/open-falcon/plugin.git",
        "logs": "./logs"
    },
    "heartbeat": {
        "enabled": true,
        "addr": "127.0.0.1:6030",  // 修改为实际HBS地址
        "interval": 60,
        "timeout": 1000
    },
    "transfer": {
        "enabled": true,
        "addrs": [
            "127.0.0.1:8433"  // 修改为实际Transfer地址
        ],
        "interval": 60,
        "timeout": 1000
    }
}

关键配置项说明： - hostname: 建议保持为空，agent会自动获取 - transfer.addrs: 必须配置为实际的Transfer服务地址 - heartbeat.addr: 配置为HBS服务地址

3.3 启动Agent

前台启动（测试用）：

./agent/bin/falcon-agent -c ./agent/config/cfg.json

后台启动（生产环境）：

./agent/bin/falcon-agent -c ./agent/config/cfg.json &> agent.log &

3.4 验证安装

检查进程：

ps aux | grep falcon-agent

检查端口（默认1988）：

netstat -tlnp | grep falcon-agent

测试数据采集：

curl http://127.0.0.1:1988/health

四、Agent高级配置

4.1 自定义监控项

创建插件脚本（示例：监控Nginx进程）

mkdir -p plugin/nginx
vim plugin/nginx/nginx_status.sh

脚本内容：

#!/bin/bash
# 获取Nginx进程数
count=$(ps aux | grep nginx | grep -v grep | wc -l)
echo -e "nginx.process.num\t$count"

给脚本添加执行权限

chmod +x plugin/nginx/nginx_status.sh

4.2 配置插件调度

修改plugin/config/plugin.json：

{
    "plugins": [
        {
            "name": "nginx",
            "filePath": "nginx/nginx_status.sh",
            "params": [],
            "schedule": {
                "cron": "*/30 * * * * *",
                "startDelay": 10
            }
        }
    ]
}

4.3 日志管理

Agent日志默认位置： - 运行日志：./logs/agent.log - 插件日志：./logs/plugin/*.log

日志轮转配置（使用logrotate）：

sudo vim /etc/logrotate.d/falcon-agent

添加内容：

/opt/open-falcon/agent/logs/*.log {
    daily
    missingok
    rotate 7
    compress
    delaycompress
    notifempty
    create 0640 root root
}

五、Agent管理命令

5.1 服务管理

启动服务：

./open-falcon start agent

停止服务：

./open-falcon stop agent

重启服务：

./open-falcon restart agent

5.2 状态检查

检查版本：

./agent/bin/falcon-agent -v

查看运行状态：

./agent/bin/falcon-agent -h

5.3 调试模式

开启调试日志：

./agent/bin/falcon-agent -c ./agent/config/cfg.json -d

六、常见问题排查

6.1 数据不上报问题

检查Transfer服务是否正常
验证网络连通性：
```
telnet transfer_host 8433
```
检查Agent日志中的错误信息

6.2 插件不执行问题

检查插件脚本是否有执行权限
验证插件配置文件格式是否正确
查看插件日志logs/plugin/*.log

6.3 资源占用过高

调整采集频率：
```
"interval": 60  # 单位：秒
```
减少自定义插件数量
限制插件执行时间

七、最佳实践建议

主机命名规范：
- 使用有意义的hostname（如：bj-db-01）
- 避免使用动态IP作为标识
监控策略：
- 关键指标（CPU、内存等）采集间隔建议60秒
- 业务指标可根据需求调整采集频率
安全建议：
- 使用内网通信
- 限制Agent端口的访问IP
- 定期更新Agent版本
性能优化：
- 对高频率采集项使用聚合插件
- 对耗时较长的插件单独设置调度周期

八、版本升级

下载新版本：

wget https://github.com/open-falcon/falcon-plus/releases/download/v0.3.1/open-falcon-v0.3.1.tar.gz

停止旧服务：

./open-falcon stop agent

备份配置：

cp -r agent/config /tmp/agent_config_backup

解压新版本并恢复配置：

tar -zxvf open-falcon-v0.3.1.tar.gz
cp /tmp/agent_config_backup/* new_version/agent/config/

启动新服务：

./open-falcon start agent

九、总结

Open-Falcon Agent作为监控系统的数据采集终端，具有以下优势： - 轻量级设计，资源占用低 - 支持插件机制，扩展性强 - 配置简单，易于维护

通过本文介绍的安装配置方法，您可以快速搭建起主机监控体系。实际生产环境中，建议结合业务需求调整监控策略，并建立完善的告警机制。

注意：本文基于Open-Falcon v0.3版本编写，不同版本配置可能略有差异，请以官方文档为准。 “`