Skip to content

自定义 Agent 监控项目

通过运行参数的配置,您可以灵活调整 Agent 的功能和行为,满足不同场景的监控需求。


运行参数

配置参数

如果您通过一键脚本安装了 Agent,可以编辑 /opt/nezha/agent/config.yml 文件来添加或修改参数。
同一台服务器可以运行多个 Agent,每个 Agent 配置文件相互独立。

运行参数及其作用:

  • debug:

    • 当为 true 时启用调试模式,记录详细日志。
  • disable_auto_update:

    • 当为 true 时禁用 Agent 的自动更新功能,增强系统稳定性和安全性。
  • disable_command_execute:

    • 当为 true 时禁用在线终端、文件管理和定时任务的执行,提升安全性。
  • disable_force_update:

    • 当为 true 时禁用强制更新功能,仅允许手动更新。
  • disable_nat:

    • 当为 true 时禁用内网穿透功能,保护内网数据。
  • disable_send_query:

    • 当为 true 时禁用 Agent 发起的 TCP PingICMP PingHTTP GET 请求。
  • gpu:

    • 当为 true 时启用 GPU 监控。
    • 注意:启用 GPU 监控可能需要安装额外依赖,详细信息参考:启用 GPU 监控
  • insecure_tls:

    • 当为 true 时禁用证书检查,适用于使用自签名证书的场景。
  • ip_report_period:

    • 设置本地 IP 更新间隔时间(秒)。默认值为 1800 秒(30 分钟)。
    • 如果该值小于 report_delay 设置值,则以 report_delay 为准。
  • report_delay:

    • 设置系统信息上报的时间间隔(秒)。默认值为 1 秒,建议设置为 3 秒以降低资源占用(有效范围:1-4 秒)。
  • server:

    • 与 Dashboard 通信的域名或 IP 地址,需包括端口号。
  • skip_connection_count:

    • 当为 true 时禁用网络连接数的监控,适用于高连接数或资源受限的环境。
  • skip_procs_count:

    • 当为 true 时禁用进程数的监控,以降低资源占用。
  • temperature:

    • 当为 true 时启用硬件温度监控(仅支持部分硬件,部分 VPS 可能无法获取温度信息)。
  • tls:

    • 当为 true 时启用 Agent 与 Dashboard 间的通信 SSL/TLS 加密。
    • 如果 Agent 使用 Nginx 反向代理且启用了 SSL/TLS 配置,请开启此选项。
  • use_gitee_to_upgrade:

    • 当为 true 时使用 Gitee 仓库作为自动更新源,对中国大陆服务器更为友好。
  • use_ipv6_country_code:

    • 当为 true 时强制使用 IPv6 地址查询国家代码(默认使用 IPv4)。
  • uuid:

    • 当前 Agent 的唯一标识参数,用于 Dashboard 识别数据来源。
    • 若需替换 Dashboard 中已存在的 Agent,可以手动设置此参数。

保存生效

在修改配置文件中的参数后,需要重新启动 Agent 服务以使更改生效。具体操作如下:

  1. 重新启动服务
    运行以下命令重新启动默认的第一个 Agent 服务:

    shell
    sudo systemctl restart nezha-agent.service
  2. 多 Agent 服务的情况
    如果同一服务器上运行了多个 Agent 服务,请先列出所有 Agent 服务的名称:

    shell
    sudo systemctl list-units --type=service | grep nezha-agent

    然后分别使用以下命令重新启动对应的 Agent 服务:

    shell
    sudo systemctl restart <service-name>

    <service-name> 替换为实际的服务名称,例如 nezha-agent@2.service