API节点常见问题

    1. 检查API节点进程是否已经启动,通常可以通过 ps 命令来检查:

      结果应该类似于:

      1. [root@web001 ~]# ps ax|grep edge-api
      2. 3930 ? Sl 65:32 /opt/www/edge-admin/edge-api/bin/edge-api
      3. 76969 pts/0 S+ 0:00 grep --color=auto edge-api

      其中 3930 就是edge-api的进程ID(不是固定的),如果没有这一行,则说明你的API节点没有启动,请执行 edge-api start 启动节点。

    2. 检查启动过程中有无错误,可以通过edge-api安装目录下的 logs/run.log 文件来查看启动日志:

      1. tail -f logs/run.log
    3. 检查是否有防火墙或者安全策略,可以在别的服务器上(比如边缘节点上)通过 telnet 检查是否能够连接API节点端口:

      其中 192.168.1.100 换成你的API节点所在服务器的IP,如果连接不了,通常是防火墙或者安全策略设置问题,请修改防火墙和安全策略设置;对于有些服务商提供的安全策略,不仅仅要设置API节点的入站策略,还要设置边缘节点的出站策略,都需要设置API节点的端口为通过。

    4. 检查数据库磁盘是否已满,虽然几率很小,但是仍然有不少用户因为这个问题导致edge-api无法启动,使用命令查看:

      1. df -h
    5. 检查其他节点(比如边缘节点)的防火墙是否封禁了API节点的IP地址,比如因WAF规则设置错误,可能会导致误封。

    修改API节点端口后,其他节点无法连接怎么办?

    如果你修改了API节点端口(监听地址或访问地址),其他的节点(比如管理平台、边缘节点)中的配置文件 api.yaml 中的端口地址也需要手工更改成新的API节点端口。

    如果想还原自己的设置,可以通过SQL语句:

    1. use $安装数据库;
    2. UPDATE edgeAPINodes SET http=JSON_SET(http, '$.listen[0].portRange', "8001");

    把其中的 $安装数据库 换成你的实际安装用的数据库;8001就是安装时指定的端口。

    修改后,需要重启edge-api进程,让配置生效。

    出现这种情况,是因为MySQL服务的max_prepared_stmt_count参数值过小,可以通过重启API节点自动设置(在使用的MySQL用户有超级权限的情况下),或者在MySQL配置文件 my.cnf 中设置:

    1. [mysqld]
    2. ...
    3. max_prepared_stmt_count=65535
    4. ...

    修改配置后,记得重启MySQL以便让配置生效。

    如果你不知道 my.cnf 的位置,可以通过命令:

    来查看MySQL查找的所有配置文件位置。

    如果暂时不方便重启MySQL服务,可以使用root用户连接MySQL,然后执行:

    1. set global max_prepared_stmt_count=65535;

    如果你还有其他业务连接同一个数据库,也要适当增大此值。

    MySQL binlog占用空间过大怎么办?

    有时会发现MySQL数据库目录下binlog文件占用的文件过大,比如:

    1. -rw-r----- 1 mysql mysql 21G Oct 30 16:50 binlog.000019

    对于硬盘空间比较少的服务器会影响服务的正常运行。

    对于这个问题,我们可以在MySQL配置中,比如my.cnf(有的叫 mysql-server.cnf)中设置binlog的过期时间,因为在绝大部分情况下,我们不需要回滚N天之前的数据。

    对于MySQL v5.7.x,设置过期时间3天:

    1. [mysqld]
    2. ...
    3. expire_logs_days=3
    4. ...

    对于MySQL 8.x.x,设置过期时间3天:

    其中259200是时钟秒数。

    修改配置后,重启MySQL服务生效。

    重启MySQL服务后,可以使用SHOW VARIBLES来查看变量是否已经设置成功:

    1. # v5.6.x
    2. SHOW VARIABLES WHERE VARIABLE_NAME='expire_logs_days';
    3. # v8.x.x
    4. SHOW VARIABLES WHERE VARIABLE_NAME='binlog_expire_logs_seconds';

    访问日志占用数据库空间太大怎么办?

    1. 设置服务访问日志自动清理,在”系统设置”菜单–“高级设置”菜单–数据库–自动清理设置中可以设置服务访问日志保留天数,可以根据根据你的访问量和数据库存储空间调整此值;
    2. 可以设置MySQL binlog的有效期,请参考本文的 ;