Apache Doris 集群管理：SHOW FRONTENDS DISKS 命令详解

概述

在 Apache Doris 分布式分析型数据库中，前端节点(Frontend)是集群的重要组成部分，负责元数据管理、查询协调等工作。本文将详细介绍 SHOW FRONTENDS DISKS 命令，该命令用于查看 FE 节点上关键目录的磁盘使用情况，是Doris集群运维中不可或缺的监控工具。

命令用途

SHOW FRONTENDS DISKS 命令主要提供以下信息：

1. FE节点上各类关键目录的磁盘使用情况
2. 文件系统级别的容量和使用率数据
3. 各类型目录的实际存储位置

通过这些信息，DBA可以：

• 监控磁盘空间使用情况，预防磁盘满导致的系统故障
• 合理规划存储资源分配
• 排查因磁盘空间不足导致的问题

命令语法

SHOW FRONTENDS DISKS;

返回结果详解

执行该命令后，将返回包含以下字段的表格：

字段名	说明
Name	FE节点在BDBJE中的唯一标识名称
Host	FE节点所在服务器的IP地址
DirType	目录类型，包括：meta(元数据)、log(日志)、audit-log(审计日志)、temp(临时文件)、deploy(部署目录)
Dir	该类型目录在服务器上的实际路径
Filesystem	目录所在的Linux文件系统
Capacity	文件系统总容量
Used	已使用空间大小
Available	剩余可用空间
UseRate	空间使用百分比
MountOn	文件系统的挂载点

权限要求

执行此命令需要以下权限之一：

• ADMIN_PRIV（管理员权限）
• NODE_PRIV（节点管理权限）

高级用法

如需对查询结果进行进一步筛选，可以使用表值函数 frontends_disks()，它与 SHOW FRONTENDS DISKS 命令等效：

SELECT * FROM FRONTENDS_DISKS();

通过这种方式，可以结合WHERE等SQL子句进行更灵活的查询，例如：

-- 只查询使用率超过80%的目录
SELECT * FROM FRONTENDS_DISKS() WHERE UseRate > 80;

实际应用示例

执行基础查询：

SHOW FRONTENDS DISKS;

典型返回结果示例：

+-----------------------------------------+-------------+-----------+---------------------------------+------------+----------+------+-----------+---------+------------+
| Name                                    | Host        | DirType   | Dir                             | Filesystem | Capacity | Used | Available | UseRate | MountOn    |
+-----------------------------------------+-------------+-----------+---------------------------------+------------+----------+------+-----------+---------+------------+
| fe_a1daac68_5ec0_477c_b5e8_f90a33cdc1bb | 10.xx.xx.90 | meta      | /home/disk/output/fe/doris-meta | /dev/sdf1  | 7T       | 2T   | 4T        | 36%     | /home/disk |
| fe_a1daac68_5ec0_477c_b5e8_f90a33cdc1bb | 10.xx.xx.90 | log       | /home/disk/output/fe/log        | /dev/sdf1  | 7T       | 2T   | 4T        | 36%     | /home/disk |
| fe_a1daac68_5ec0_477c_b5e8_f90a33cdc1bb | 10.xx.xx.90 | audit-log | /home/disk/output/fe/log        | /dev/sdf1  | 7T       | 2T   | 4T        | 36%     | /home/disk |
| fe_a1daac68_5ec0_477c_b5e8_f90a33cdc1bb | 10.xx.xx.90 | temp      | /home/disk/output/fe/temp_dir   | /dev/sdf1  | 7T       | 2T   | 4T        | 36%     | /home/disk |
| fe_a1daac68_5ec0_477c_b5e8_f90a33cdc1bb | 10.xx.xx.90 | deploy    | /home/disk/output/fe            | /dev/sdf1  | 7T       | 2T   | 4T        | 36%     | /home/disk |
+-----------------------------------------+-------------+-----------+---------------------------------+------------+----------+------+-----------+---------+------------+

运维建议

1. 元数据目录(meta)：这是最重要的目录，存储了集群的所有元数据信息。建议：

   • 保持至少30%的可用空间
   • 定期监控使用率变化
   • 考虑使用高性能存储设备

2. 日志目录(log/audit-log)：

   • 设置合理的日志保留策略
   • 对于审计日志，可根据合规要求调整保留周期
   • 大流量场景下，日志可能快速增长，需特别关注

3. 临时目录(temp)：

   • 查询过程中产生的临时文件存放位置
   • 突发大查询可能导致临时目录快速填满
   • 建议与其他关键目录分开存储

4. 通用监控策略：

   • 对所有目录设置使用率告警阈值（如80%）
   • 定期检查各目录所在文件系统的健康状况
   • 在容量规划时预留足够buffer

常见问题排查

问题1：FE节点启动失败，报磁盘空间不足

排查步骤：

1. 使用 SHOW FRONTENDS DISKS 查看各目录使用情况
2. 重点关注meta和log目录
3. 清理不必要的历史日志文件
4. 如有必要，扩展磁盘容量或迁移数据目录

问题2：查询性能下降，临时目录使用率高

解决方案：

1. 检查temp目录使用率
2. 优化大查询，减少中间结果集
3. 考虑为temp目录分配更大的空间
4. 定期清理旧的临时文件

总结

SHOW FRONTENDS DISKS 是Apache Doris集群运维中的重要工具，通过它DBA可以全面掌握FE节点的磁盘使用状况。合理利用此命令并结合定期监控，可以有效预防因磁盘问题导致的系统故障，保障集群稳定运行。