> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/zh/cun-chu/vsan-diagnostics.md). # vSAN 诊断指南 ## 概述 vSAN 诊断工具为 VergeOS 虚拟存储区域网络提供全面的存储系统分析和故障排查功能。这些诊断命令使系统管理员能够监控存储性能、排查存储问题，并在整个集群中保持最佳的 vSAN 健康状态。 {% hint style="info" %} **你将学到什么** * 如何访问和使用 vSAN 诊断工具 * 了解每个诊断命令及其存储重点 * vSAN 故障排查和维护的最佳实践 * 何时针对存储问题使用特定的诊断命令 {% endhint %} ## 前提条件 * 具有 vSAN 管理权限的 VergeOS 界面访问权限 * 对分布式存储概念的基本理解 * 了解 VergeOS vSAN 架构 {% hint style="info" %} **vSAN 访问** vSAN 诊断仅在根/父级别可用。租户无法访问 vSAN 诊断工具。 {% endhint %} ## 访问 vSAN 诊断 1. **导航到 vSAN 诊断：** * 选择 **系统** → **vSAN 诊断** 从顶部菜单。 * 或者：从主仪表板中，点击 **vSAN 层级** 计数框 → **vSAN 诊断** 左侧菜单中的。 2. **使用诊断命令：** * 从 **查询** 下拉菜单中选择所需命令 * 在右侧配置可用参数 * 单击 **发送 →** 以执行该命令 {% hint style="success" %} **命令可见性** 启用 **“显示命令”** 以查看正在执行的确切命令，这对于 SSH 执行或脚本自动化很有用。 {% endhint %} ## 诊断命令参考 ### 查找 inode **用途：** 在 vSAN 文件系统中定位特定 inode，以进行详细分析。 **何时使用：** * 排查文件系统损坏 * 定位特定数据块 * 高级存储故障排查 **参数：** * **Inode 编号：** 要定位的特定 inode 标识符 **CLI 语法：** ```bash vcmd find --inode=[INODE_NUMBER] ``` *** ### 获取缓存信息 **用途：** 显示全面的缓存系统信息和统计数据。 **何时使用：** * 性能优化 * 缓存命中/未命中比率分析 * 内存使用情况评估 * 存储性能故障排查 **CLI 语法：** ```bash vcmd cache info ``` *** ### 获取客户端 **用途：** 显示活动的 vSAN 客户端及其连接详情。 **何时使用：** * 连接故障排查 * 客户端性能分析 * 网络连通性验证 * 负载分布评估 **CLI 语法：** ```bash vcmd clients list ``` *** ### 获取集群速率 **用途：** 显示集群范围内的性能指标和吞吐速率。 **何时使用：** * 集群性能监控 * 吞吐分析 * 建立性能基线 * 容量规划 **CLI 语法：** ```bash vcmd cluster rates ``` *** ### 获取集群使用情况 **用途：** 显示全面的集群存储利用率统计信息。 **何时使用：** * 容量规划 * 存储利用率监控 * 空间分配分析 * 增长趋势评估 **CLI 语法：** ```bash vcmd cluster usage ``` *** ### 获取当前主节点 **用途：** 识别集群中当前的 vSAN 主节点。 **何时使用：** * 集群领导角色故障排查 * 主节点故障切换分析 * 集群协调问题 * 性能优化 **CLI 语法：** ```bash vcmd master current ``` *** ### 获取设备列表 **用途：** 列出所有参与 vSAN 的存储设备。 **何时使用：** * 设备清单管理 * 存储配置验证 * 设备状态监控 * 容量评估 **CLI 语法：** ```bash vcmd devices list ``` *** ### 获取设备状态 **用途：** 显示 vSAN 存储设备的详细状态信息。 **何时使用：** * 设备健康监控 * 故障检测 * 性能分析 * 维护规划 **参数：** * **设备 ID：** 要查询的特定设备 **CLI 语法：** ```bash vcmd device status [DEVICE_ID] ``` *** ### 获取设备使用情况 **用途：** 显示单个存储设备的使用统计信息。 **何时使用：** * 设备利用率监控 * 负载均衡分析 * 性能优化 * 磨损均衡评估 **参数：** * **设备 ID：** 用于分析的目标设备 **CLI 语法：** ```bash vcmd device usage [DEVICE_ID] ``` *** ### 获取文件状态 **用途：** 检索 vSAN 中特定文件的详细状态信息。 **何时使用：** * 文件完整性验证 * 复制状态检查 * 数据位置跟踪 * 损坏调查 **参数：** * **文件路径：** 用于分析的目标文件 **CLI 语法：** ```bash vcmd file status [FILE_PATH] ``` *** ### 获取 Fuse 信息 **用途：** 显示 FUSE（用户空间文件系统）的挂载和操作信息。 **何时使用：** * 文件系统挂载故障排查 * FUSE 性能分析 * 挂载点验证 * 访问问题诊断 **CLI 语法：** ```bash vcmd fuse info ``` *** ### 获取完整性检查状态 **用途：** 显示正在进行或已完成的完整性检查操作状态。 **何时使用：** * 数据完整性监控 * 验证过程跟踪 * 损坏检测 * 维护状态检查 **CLI 语法：** ```bash vcmd integcheck status ``` *** ### 获取日志状态 **用途：** 显示 vSAN 日志状态和操作信息。 **何时使用：** * 写入性能故障排查 * 日志空间监控 * 事务日志分析 * 性能优化 **CLI 语法：** ```bash vcmd journal status ``` *** ### 获取节点设备列表 **用途：** 列出集群中特定节点的存储设备。 **何时使用：** * 节点特定的设备清单 * 按节点容量规划 * 设备分布分析 * 节点维护准备 **参数：** * **节点 ID：** 用于列出设备的目标节点 **CLI 语法：** ```bash vcmd node devices [NODE_ID] ``` *** ### 获取节点信息 **用途：** 显示关于特定 vSAN 节点的全面信息。 **何时使用：** * 节点健康评估 * 配置验证 * 性能分析 * 排查节点问题 **参数：** * **节点 ID：** 目标节点标识符 **CLI 语法：** ```bash vcmd node info [NODE_ID] ``` *** ### 获取节点列表 **用途：** 列出所有参与 vSAN 集群的节点。 **何时使用：** * 集群成员验证 * 节点清单管理 * 集群拓扑分析 * 健康状态概览 **CLI 语法：** ```bash vcmd nodes list ``` *** ### 从 inode 获取路径 **用途：** 根据 inode 编号解析文件系统路径。 **何时使用：** * 文件系统导航 * inode 到路径映射 * 损坏分析 * 高级故障排查 **参数：** * **Inode 编号：** 用于路径解析的源 inode **CLI 语法：** ```bash vcmd path from-inode [INODE_NUMBER] ``` *** ### 获取预读信息 **用途：** 显示预读缓存配置和统计信息。 **何时使用：** * 读取性能优化 * 缓存调优 * 顺序访问分析 * 性能故障排查 **CLI 语法：** ```bash vcmd readahead status ``` *** ### 获取修复状态 **用途：** 显示正在进行的修复操作和数据重建状态。 **何时使用：** * 数据修复监控 * 恢复过程跟踪 * 故障恢复评估 * 维护状态检查 **CLI 语法：** ```bash vcmd repair status ``` *** ### 获取运行配置 **用途：** 显示 vSAN 系统当前正在运行的配置。 **何时使用：** * 配置验证 * 排查配置问题 * 备份配置参考 * 变更管理 **CLI 语法：** ```bash vcmd config show ``` *** ### 获取同步列表 **用途：** 列出同步操作及其状态。 **何时使用：** * 数据同步监控 * 复制状态跟踪 * 一致性验证 * 性能分析 **CLI 语法：** ```bash vcmd sync list ``` *** ### 获取层级设备映射 **用途：** 显示不同存储层级之间的设备映射。 **何时使用：** * 层级配置验证 * 设备放置分析 * 性能优化 * 容量规划 **CLI 语法：** ```bash vcmd tier device-maps ``` *** ### 获取层级节点映射 **用途：** 显示存储层级如何分布在集群节点之间。 **何时使用：** * 层级分布分析 * 负载均衡验证 * 性能优化 * 容量规划 **CLI 语法：** ```bash vcmd tier node-maps ``` *** ### 获取层级状态 **用途：** 显示存储层级的全面状态信息。 **何时使用：** * 层级健康监控 * 性能分析 * 容量利用率跟踪 * 层级优化 **CLI 语法：** ```bash vcmd tier status ``` *** ### 获取最高使用率 **用途：** 识别存储资源和性能的最大消耗者。 **何时使用：** * 性能瓶颈识别 * 资源利用分析 * 容量规划 * 使用率优化 **CLI 语法：** ```bash vcmd usage top-rates ``` *** ### 获取使用情况 **用途：** 显示全面的 vSAN 使用统计和指标。 **何时使用：** * 整体系统利用率监控 * 容量规划 * 建立性能基线 * 资源分配分析 **CLI 语法：** ```bash vcmd usage show ``` *** ### 获取卷使用情况 **用途：** 显示 vSAN 中单个卷的使用统计信息。 **何时使用：** * 卷特定容量监控 * 性能分析 * 空间分配验证 * 增长跟踪 **参数：** * **卷 ID：** 用于分析的目标卷 **CLI 语法：** ```bash vcmd volume usage [VOLUME_ID] ``` *** ### 完整性检查 **用途：** 在整个 vSAN 上启动全面的数据完整性检查。 **何时使用：** * 计划维护 * 数据损坏调查 * 预防性健康检查 * 故障后验证 {% hint style="warning" %} **性能影响** 完整性检查可能会显著影响系统性能，应在维护窗口期间安排。 {% endhint %} **CLI 语法：** ```bash vcmd integcheck start ``` *** ### 完整性检查设备 **用途：** 对特定存储设备执行完整性检查。 **何时使用：** * 设备特定的完整性验证 * 定向故障排查 * 修复后验证 * 选择性维护 **参数：** * **设备 ID：** 用于完整性检查的目标设备 **CLI 语法：** ```bash vcmd integcheck device [DEVICE_ID] ``` *** ### 汇总磁盘使用情况 **用途：** 提供整个 vSAN 的全面磁盘使用摘要。 **何时使用：** * 容量报告 * 使用趋势分析 * 存储优化规划 * 高层报告 **CLI 语法：** ```bash vcmd usage summarize ``` ## 最佳实践 ### vSAN 健康监控工作流 1. **系统概览：** 从获取集群使用情况和获取集群速率开始 2. **性能分析：** 查看获取最高使用率和设备特定指标 3. **健康评估：** 检查获取修复状态和获取完整性检查状态 4. **容量规划：** 使用汇总磁盘使用情况和层级信息 5. **故障排查：** 根据需要使用设备特定和节点特定命令 ### 预防性维护 * **定期健康检查：** 监控集群使用情况、修复状态和设备健康状况 * **性能监控：** 跟踪集群速率和最高使用模式 * **完整性验证：** 在维护窗口期间安排定期完整性检查 * **容量规划：** 定期查看使用趋势和增长模式 ### 性能优化 * **缓存分析：** 监控缓存信息和命中率，以寻找优化机会 * **层级管理：** 查看层级设备映射和节点映射，以实现均衡分布 * **负载均衡：** 利用客户端和使用信息来优化工作负载分布 * **读取优化：** 根据访问模式调整预读设置 ## 排查常见 vSAN 问题 ### 性能问题 1. 检查 **获取集群速率** 和 **获取最高使用率** 针对瓶颈 2. 查看 **获取缓存信息** 针对缓存效率 3. 分析 **获取设备使用情况** 针对单个设备性能 ### 容量问题 1. 使用 **获取集群使用情况** 和 **汇总磁盘使用情况** 针对空间分析 2. 查看 **获取层级状态** 针对层级特定容量 3. 检查 **获取卷使用情况** 针对单个卷消耗 ### 数据完整性问题 1. 查看 **获取完整性检查状态** 针对最近的完整性检查 2. 检查 **获取修复状态** 针对正在进行的修复 3. 使用 **获取文件状态** 针对特定文件完整性验证 ### 集群健康问题 1. 验证 **获取当前主节点** 针对领导状态 2. 检查 **获取节点列表** 和 **获取节点信息** 针对节点健康 3. 查看 **获取同步列表** 针对同步问题 ### 设备问题 1. 使用 **获取设备列表** 和 **获取设备状态** 针对设备健康 2. 检查 **获取节点设备列表** 针对节点特定的设备问题 3. 运行 **完整性检查设备** 针对疑似设备问题 ## 高级诊断 ### 文件系统分析 * 使用 **查找 inode** 和 **从 inode 获取路径** 用于文件系统调查 * 使用 **获取文件状态** 用于详细文件分析 * 检查 **获取 Fuse 信息** 用于挂载相关问题 ### 配置管理 * 查看 **获取运行配置** 用于当前配置 * 使用映射命令验证层级和设备映射 * 交叉引用节点和设备信息以确保一致性 ### 性能调优 * 分析缓存和预读统计信息以进行优化 * 监控客户端连接和使用模式 * 查看日志状态以优化写入性能 ## 下一步 掌握 vSAN 诊断后，可进一步探索： * 高级 vSAN 性能调优技术 * 自动化监控和告警系统 * 与外部存储管理工具集成 * 灾难恢复和备份策略 如需复杂的 vSAN 问题或性能优化指导，请联系 [VergeOS 支持](/overview/zh/support-and-services.md) 并提供详细的诊断输出和系统配置信息。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/zh/cun-chu/vsan-diagnostics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.