生成 FortiClient（macOS）的诊断报告

新版 FortiClient（macOS）提供诊断报告生成功能。遇到 EMS 通信、VPN、ZTNA 或客户端运行异常时，可在本机运行 Diagnostic Tool / 诊断工具，收集诊断信息并提交给 Fortinet TAC。

采集顺序：确认日志设置 → 复现问题 → 生成诊断报告 → 检查并保存 → 恢复日志设置。 如果工具提示在采集过程中复现故障，则按提示操作。

注

本文以带有诊断工具入口的 FortiClient（macOS）为主要操作对象。不同版本、安装类型和 EMS 策略下，入口、按钮及报告内容可能不同，以本机界面为准。诊断报告与 Export Logs / 导出日志 的采集范围可能不同；能够运行诊断工具时，优先保存完整诊断报告。

采集前准备

在重启、升级、卸载或清除日志前，先保留已有故障记录，并记录以下信息：

项目	需要记录的内容
软件版本	macOS 版本、FortiClient 完整版本，以及 Mac 使用 Apple 芯片还是 Intel 处理器；受管终端另记录 EMS 版本
故障现象	预期结果、实际结果、完整错误文本和复现步骤
故障时间	发生及复现时间，精确到秒并注明时区
终端信息	主机名；受管终端另记录 EMS 中的 UID 和命中策略
网络与变更	当前网络、代理或其他 VPN，以及近期升级、证书或策略变更

确认磁盘空间充足，能够按诊断工具提示完成必要的权限授权。偶发问题应先保存现有日志，避免重新采集前清除了唯一的故障记录。

配置日志并复现问题

诊断工具可以汇总已有信息，但无法补回之前未记录的 Debug 日志。需要详细排错时，应先启用相关模块的日志，再复现故障。

在 EMS 中确认目标终端实际命中的 Endpoint Policy，以及该策略引用的 System Settings 配置文件。
进入配置文件的日志设置；如有 Basic / Advanced 切换，切换到 Advanced。
记录原设置，临时将所需模块的日志级别调整为 Debug，保存并等待终端同步。
在 FortiClient 的 Settings / 设置 中确认日志级别已经生效。受管终端的选项被锁定时，应在 EMS 调整。
执行一次明确的故障操作，记录开始、报错和结束时间，并保存错误截图。

日志选项与模块名称以实际平台和版本为准，设置方法参见客户端日志的设置。如果配置文件被大量终端共用，应使用排错专用配置并限定目标范围。

在 macOS 本机生成诊断报告

1. 打开诊断工具

打开 FortiClient 主界面，进入 About / 关于，查找 Diagnostic Tool / Run Diagnostic Tool / 诊断工具 入口。

2. 启动采集

打开诊断窗口后，检查窗口显示的采集说明及日志范围。按提示单击 Run Diagnostic Tool / Run Tool / 运行工具。

FortiClient诊断工具随后就会自动开启采集诊断信息。

重要

如果 macOS 弹出权限或管理员凭据提示，按工具要求完成授权。
采集期间保留进度窗口，不要提前退出 FortiClient 或关闭诊断工具。

3. 按提示复现故障

对于 VPN 问题，工具会提示要求在建立或断开隧道。如果涉及VPN的问题，按照工具给的信息操作。如果问题不涉及VPN，那么直接单击OK按钮跳过

如果问题已经复现且工具没有要求再次操作，等待采集结束即可。涉及 EMS、FortiGate 或身份认证服务时，同时保存服务端相同时间段的日志。

4. 保存诊断报告

采集结束后，根据工具的完成提示、保存对话框并自动打开的 Finder 窗口，找到本次生成的报告。

一般保存在以下路径：

/Users/<用户名>/Library/Application Support/Fortinet/FortiClient/Diagnostic_Result

将完整报告复制到本次故障的独立目录，保留原文件名、格式和目录结构。
核对生成时间及文件大小，确认不是之前采集的旧报告。
如果结果为压缩包，使用副本检查能否正常解压，确认包含实际诊断内容。

无法运行诊断工具时导出日志

如果客户端没有显示诊断入口，或工具执行失败，可先导出日志并保存工具报错，避免耽误故障信息采集。

确认所需日志级别和模块已经生效。
复现问题并记录准确时间。
在 FortiClient 中进入 Settings / 设置 → Log File / 日志文件 → Export Logs / 导出日志。
按提示选择保存位置，等待导出完成，检查导出文件非空且包含故障时段的记录。

导出日志可以作为排错材料，但不应直接标记为已生成完整诊断报告。界面也无法导出时，可按FortiClient（macOS）模块日志补充采集原始日志；IPsec IKEv2 等问题还可能需要对应的 macOS 系统日志。

检查报告并提交

提交前确认以下内容：

报告属于目标终端，FortiClient 版本与故障描述一致。
采集已经结束，文件非空，相关日志覆盖本次故障或复现时段。
附有复现步骤、准确时间及时区、完整报错及必要的服务端日志。
缺少某个模块或未能复现时，在工单中说明，避免将文件生成成功视为故障已被完整记录。

保留原始报告，通过工单要求的渠道提交。可随附件提供以下说明：

问题描述：[预期结果与实际结果]
发生时间及时区：[YYYY-MM-DD HH:mm:ss，UTC+08:00]
macOS / FortiClient / EMS 版本：[完整版本]
Mac 处理器：[Apple 芯片 / Intel]
终端主机名 / UID：[主机名 / UID]
网络环境：[办公网、家庭网络等]
复现步骤：[按顺序列出]
错误信息：[完整错误文本]
最近变更：[升级、策略、证书等]
附件说明：[诊断报告或导出日志、截图及对应时间]

完成采集后，恢复原日志级别和临时策略分配，并确认终端收到恢复配置。

常见问题

现象	处理方法
找不到诊断入口	检查 About 和 Settings，核对客户端版本与安装类型；先使用 Export Logs 保存故障日志
升级后提示诊断工具损坏	记录完整版本和错误截图，核对对应版本发布说明，再由 TAC 确认处理方式；可先导出日志
工具长时间未完成	检查是否正在等待权限授权、VPN 操作或用户输入，保存进度及报错信息
找不到生成文件	查看工具结束提示或保存位置，按生成时间核对本次报告；不要把原始日志目录当作固定输出位置
报告中缺少故障记录	检查日志级别、模块、策略同步及时间范围；必要时在正确设置下重新复现和采集

重要

FortiClient（macOS）7.4.7 发布说明仍列有升级后诊断工具损坏的已知问题 1218936。遇到相同现象时应核对实际版本，参阅官方已知问题说明。

更新历史

Ver	Description	Author	Rev	Date
1.0	First Complete	ysheng	tanga	2025.10.29