安装 Agent

哪吒监控的被控端服务被称为 Agent

Agent 二进制文件仓库地址为：https://github.com/nezhahq/agent/releases

一键安装 Agent

哪吒监控支持在 Windows、macOS 和 Linux 上一键安装 Agent。遵循本文档的步骤，你可以轻松地在服务器上部署它。

准备工作

在安装前，需要提前在管理面板中设置通信域名，该域名不可以接入 CDN。本文档以示例通信域名 “data.example.com” 为例。

1. 在后台管理面板点击头像，进入“系统设置”页。

2. 在“仪表板服务器域名/IP（无 CDN）”项中填入通信域名。

3. 点击“确认”保存设置。

一键安装步骤

1. 在 服务器 页面中，点击 安装命令 并选择对应操作系统，安装命令将自动复制到你的剪贴板。

2. 在被控端服务器中运行安装命令，等待安装完成后返回到 服务器 页面查看是否上线。

3. 如果安装成功，页面中将自动弹出新的服务器，你可以点击编辑按钮为其设置名称。

平台特有问题说明

1.不小心多执行了几次，多了好多一样的Agent怎么办？

如果有多个 nezha-agent 服务实例，你可以运行以下命令来查看所有相关服务并停止它们：

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

然后，针对每个服务运行：

sudo systemctl stop <service-name>

最后，删除/opt/nezha/agent/nezha-agent/xxx-config.yml 文件

2.Windows 特殊说明

1. 在 Windows 服务器中，运行 PowerShell。

2. 在 PowerShell 中粘贴并运行安装命令(复制命令后修改并按下面方法执行)。

#分别执行
$env:NZ_SERVER="xxxx:8008" #记得加""
$env:NZ_TLS="false" 
$env:NZ_CLIENT_SECRET="xxxx"
#然后执行
  
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Ssl3 -bor [Net.SecurityProtocolType]::Tls -bor [Net.SecurityProtocolType]::Tls11 -bor [Net.SecurityProtocolType]::Tls12;set-ExecutionPolicy RemoteSigned;Invoke-WebRequest https://raw.githubusercontent.com/nezhahq/scripts/main/agent/install.ps1 -OutFile C:install.ps1;powershell.exe C:install.ps1

3.Agent 有 Docker 镜像吗？

Agent 目前没有推出 Docker 镜像。
Agent 的设计思路和 Dashboard 相反：Dashboard 的目标是尽量减少对宿主机的干扰，而 Agent 则需要深度与宿主机集成以执行监控服务和命令任务。

虽然将 Agent 放入容器中可以继续执行监控任务，但 WebShell 等功能将无法正常运行，因此官方不提供 Docker 镜像支持。

设置三网监控

要新增一个网络波动监控，请按照以下步骤操作：

1. 进入管理面板
   转到 服务 页，点击 + 按钮添加新的服务监控。

2. 配置参数
   在新增监控时，设置以下参数：

   • 名称：为此服务自定义一个名称。

   • 目标

     • TCP Ping：输入运营商 IP 地址/域名并添加端口号，例如：1.1.1.1:80 或 example.com:22。

   • 类型：选择监控类型（TCP Ping）。

   • 服务中显示：选择是否向游客显示此监控（隐私性选项）。

   • 间隔：设置监控间隔时间（单位：秒）。

   • 覆盖范围：选择一条规则来确定哪些 Agent 请求目标。

   • 特定服务器：指定覆盖范围内需要使用的 Agent。

   • 通知组 ID：选择已在 通知 页中配置的通知方式，详见 通知方式配置。

   • 启用失败通知：可选择在目标故障时接收通知（默认为不启用）。

3. 提交监控
   点击 提交 按钮保存配置，稍等片刻后返回主页查看监控结果。

效果：

全国三网IP地址

• 河北

• 山西

• 辽宁

• 吉林

• 黑龙江

• 江苏

• 浙江

• 安徽

• 福建

• 江西

• 山东

• 河南

• 湖北

• 湖南

• 广东

• 海南

• 四川

• 贵州

• 云南

• 陕西

• 甘肃

• 青海

• 内蒙古

• 广西

• 西藏

• 宁夏

• 新疆

• 北京

• 天津

• 上海

• 重庆

通知设置

哪吒监控支持对服务器的负载、CPU、内存、硬盘、流量、月流量、进程数和连接数进行监控，并在达到用户设定的阈值时发送通知。

1.先设置一个通知方式

我这里是用飞书

获取 URL 参数

1. 创建机器人：在飞书群设置中添加自定义机器人（Webhook）。

2. 获取 Webhook URL：创建完成后获得。

通知配置：

• 名称：哪吒面板 Bot

• URL：https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxxxxxxxxxxx

• 请求方式：POST

• 请求类型：JSON

• Body：

1
2
3
4
5
6

{
  "msg_type": "text",
  "content": {
    "text": "【哪吒通知消息】\n🕐 时间：\n#DATETIME#\n📋 事件：\n#NEZHA#"
  }
}

更多通知方式：

https://nezha.wiki/guide/notifications.html

如果对通知配置有疑问，可以使用以下第三方配置生成器简化操作（哪吒监控不对第三方生成器的功能性作任何保证）：

• Nezha Rule Generator：适用于大多数场景。

• Nezha-Traffic-Alarm-Generator：专注于周期流量通知规则生成。

2.设置告警

https://nezha.wiki/guide/notifications.html#%E8%AD%A6%E6%8A%A5%E8%A7%84%E5%88%99%E8%AF%B4%E6%98%8E

3.设置通知分组

通知分组允许用户将多个通知方式组合成一个通知组，通知组可用作任务或告警的通知目标，实现一键发送多种方式的通知。

配置步骤

1.点击“分组”-“通知分组”

2.选择你要已经设置好的通知方式。

4.应用通知组

在任务或告警规则中选择通知组作为通知目标，触发时会同时通过分组内的所有通知方式发送通知。