跳转到主要内容
修改 monit-agent 配置后，不同类型的变更需要不同的生效方式。本文说明何时 reload、何时重启，以及如何确认监控对象已经成功接入。

​
配置生效规则

变更内容生效方式
agent.yaml 中的主机采集、MySQL、Redis、PostgreSQL、MongoDB、Kafka、Elasticsearch 等配置发送 SIGHUP reload
Edge 地址、Basic Auth、TLS、hostLocator、审计目录重启 Agent
发送 SIGHUP： 
sudo systemctl kill -s HUP monitagent
重启服务： 
sudo systemctl restart monitagent
如果只是新增或调整 agent.yaml 中的对象配置，优先使用 SIGHUP reload。只有启动参数或服务级参数变化时才需要重启。

​
验证接入是否成功

启动 Agent 后，通常几秒内可以在监控对象页面看到一个主机对象。 如果页面仍为空，请按以下顺序检查：
1

确认 Agent 是否运行

sudo systemctl status monitagent
2

确认 Edge 地址是否正确

检查地址是否带了 ws:// 或 wss://，并确认当前租户对应的 Edge 已经在线。
3

查看 Agent 日志

sudo journalctl -u monitagent -n 100
4

检查 agent.yaml

如果修改过 agent.yaml，确认配置文件没有 YAML 语法错误。

​
对象没有出现时的检查项

现象检查方向
监控对象页面为空先确认主机对象是否出现；如果主机对象都没有出现，优先检查 Agent 进程、Edge 地址和日志。
某类数据库或中间件对象没有出现检查对应的 targets、locator_mappings 和凭据文件配置。
Elasticsearch 对象没有出现确认集群可达。Agent 需要在启动或 reload 时通过 GET _cluster/health 获取 cluster_name。
页面对象地址显示为 localhost 或 127.0.0.1为该 target 配置 locator_mappings，映射为固定内网 IP、DNS 或 host:port。

​
推荐接入顺序

  1. 先只接入主机对象。
  2. 页面出现主机后，再逐步添加 MySQL、Redis、PostgreSQL 等数据库对象。
  3. 各对象出现后，再按需开启 mysql.query、redis.command、postgres.query、mongodb.command、elasticsearch.cat 等受控查询工具。

​
相关文档

监控对象概览

了解监控对象和 monit-agent 的工作方式。

配置监控对象

查看 agent.yaml 中各对象类型的配置示例和建议。