Skip to main content

常见问题

监控常见问题

  1. 页面反馈:monitor.host:监控Host必须是ipv4,ipv6或域名

    如信息所示,输入的监控Host须是ipv4,ipv6或域名,不能携带协议头,例如协议头http

  2. 网站API等监控反馈statusCode:403或401,但对端服务本身无需认证,浏览器直接访问是OK

    请排查是否是被防火墙拦截,如宝塔等默认设置了对请求header中User-Agent=Apache-HttpClient的拦截,若被拦截请删除此拦截规则。(v1.0.beat5版本已将user-agent模拟成浏览器此问题不存在)

  3. 安装包部署的hertzbeat下ping连通性监控异常
    安装包安装部署的hertzbeat,对ping连通性监控不可用,但本地直接ping是可用的。

    安装包部署需要配置java虚拟机root权限启动hertzbeat从而使用ICMP,若未启用root权限则是判断telnet对端7号端口是否开通
    docker安装默认启用无此问题
    详见 https://stackoverflow.com/questions/11506321/how-to-ping-an-ip-address

  4. 配置了k8s监控,但是实际监控时间并未按照正确间隔时间执行
    请参考下面几点排查问题:

    一:首先查看hertzbeat的错误日志,如果出现了'desc: SQL statement too long, check maxSQLLength config',信息
    二:需要调整tdengine配置文件,可在服务器创建taos.cfg文件,调整# max length of an SQL : maxSQLLength 654800,然后重启tdengine,需要加入配置文件的挂载
    三:如果遇到了重启tdengine失败,需要调整挂载数据文件中的配置,见 .../taosdata/dnode/dnodeEps.json,中dnodeFqdn调整为启动失败的dockerId即可,然后docker restart tdengine
    6.配置http api监控,用于进行业务接口探测,确保业务可以用,另外接口有进行token鉴权校验,"Authorization:Bearer eyJhbGciOiJIUzI1....",配置后测试,提示“StatusCode 401”。服务端应用收到的token为"Authorization:Bearer%20eyJhbGciOiJIUzI1....",hertzbeat对空格进行转义为“%20”,服务器没有转义导致鉴权失败,建议转义功能作为可选项。

Docker部署常见问题

  1. MYSQL,TDENGINE和HertzBeat都Docker部署在同一主机上,HertzBeat使用localhost或127.0.0.1连接数据库失败
    此问题本质为Docker容器访问宿主机端口连接失败,由于docker默认网络模式为Bridge模式,其通过localhost访问不到宿主机。

    解决办法一:配置application.yml将数据库的连接地址由localhost修改为宿主机的对外IP
    解决办法二:使用Host网络模式启动Docker,即使Docker容器和宿主机共享网络 docker run -d --network host .....

  2. 按照流程部署,访问 http://ip:1157/ 无界面
    请参考下面几点排查问题:

    一:依赖服务MYSQL数据库,TDENGINE数据库是否已按照启动成功,对应hertzbeat数据库是否已创建,SQL脚本是否执行
    二:HertzBeat的配置文件 application.yml 里面的依赖服务IP账户密码等配置是否正确
    三:若都无问题可以 docker logs hertzbeat 查看容器日志是否有明显错误,提issue或交流群或社区反馈

  3. 日志报错TDengine连接或插入SQL失败

    一:排查配置的数据库账户密码是否正确,数据库是否创建
    二:若是安装包安装的TDengine2.3+,除了启动server外,还需执行 systemctl start taosadapter 启动 adapter

安装包部署常见问题

  1. 按照流程部署,访问 http://ip:1157/ 无界面
    请参考下面几点排查问题:

    一:依赖服务MYSQL数据库,TDENGINE数据库是否已按照启动成功,对应hertzbeat数据库是否已创建,SQL脚本是否执行
    二:HertzBeat的配置文件 hertzbeat/config/application.yml 里面的依赖服务IP账户密码等配置是否正确
    三:若都无问题可以查看 hertzbeat/logs/ 目录下面的运行日志是否有明显错误,提issue或交流群或社区反馈

  2. 日志报错TDengine连接或插入SQL失败

    一:排查配置的数据库账户密码是否正确,数据库是否创建
    二:若是安装包安装的TDengine2.3+,除了启动server外,还需执行 systemctl start taosadapter 启动 adapter