使用增强日志记录项目

Velocity 客户端的增强日志记录功能可以让管理员在 Android 设备上启用调试日志记录并轻松检索日志文件。针对 Velocity 日志、网络日志或屏幕捕获文件使用增强日志记录。使用增强日志记录来更改日志级别时，设备上任何配置文件中设置的日志级别都会被暂时覆盖。此操作可以启动和停止调试日志记录，而无需修改现有的主机配置文件或将文件分发到设备。

创建增强日志记录项目，指定要收集的日志文件或屏幕捕获，然后使用客户端扫描显示的 QR 码。客户端打开调试日志记录和/或屏幕捕获，直到满足以下条件之一：

•设备用户关闭增强日志记录功能。

•通过点击菜单 > 退出关闭客户端。

•设备内存不足，无法存储文件。

增强日志记录停止时，客户端会向用户显示一条消息，压缩文件并将其发送到控制台，以便管理员查看。如果控制台不可用，则 zip 文件将保存到设备上的 Downloads/com.wavelink.velocity 目录。

设备用户无需 QR 码即可打开增强日志记录功能，但文件会始终存储在设备本地，不会发送到控制台。有关不使用 QR 码启用增强日志记录功能的信息，请参阅使用 Velocity 客户端。打开增强日志记录功能时如果没有使用 QR 码，则不会包含屏幕捕获文件。

如果正在使用增强日志记录功能时，为增强日志记录项目打开屏幕捕获功能，则客户端将为每个处于活动状态的会话创建一个单独的屏幕捕获文件 (.wltsc)。

如果设备运行 Android 10，则客户端无权访问 Downloads/com.wavelink.velocity 目录，因此会将文件保存在 Android/data/com.wavelink.velocity/files 目录中。版本比 Android 10 更新或更高的 Android 设备允许访问“下载”目录，但 Android 10 设备不允许。

QR 码如何工作？

使用 QR 码打开增强日志记录功能时，控制台将充当通过 HTTPS 接收文件的服务器，同时控制台会显示 QR 码。系统会使用 QR 码中包含的令牌来保护流量。为了确保安全，应仅在主动使用增强日志记录功能时展示 QR 码。如果选择打印 QR 码，建议限制相关访问权限。 QR 码与生成它的控制台一一对应。

为了从客户端接收 zip 文件，控制台必须在设备停止日志记录时显示 QR 码。收到的文件会保存在“下载”文件夹中。如果没有显示 QR 码，控制台不会收到任何文件。（在这种情况下，设备会显示消息，说明控制台不可用并将文件存储在本地。）不过，如果关闭后又再次打开项目，只要在客户端停止日志记录时显示同一 QR 码，则设备仍然可以将文件发送到控制台。如果重新启动控制台或者更改主机地址或端口，则 QR 码会失效。

增强日志记录选项

增强日志记录项目具有以下选项：

•客户。项目关联的公司或组织的名称。

•主机。本地计算机的 IP 地址或主机名。由于 QR 码会使用主机地址，因此，如果更改主机地址，QR 码也会更改，导致先前生成的 QR 码失效。

•端口。控制台监听传入文件的端口。确保其他功能未在使用此端口。

•包括：

•调试日志记录。设置要调试的所有会话的日志级别，并将 Velocity 日志包含在要发送到控制台的文件中。

•网络日志记录（仅限 TE）。设置要调试的网络日志记录的日志级别，并将网络日志包含在要发送到控制台的文件中。网络日志不适用于 Web 会话。

•屏幕捕获（仅限 TE）。打开屏幕捕获功能，捕获所有活动 TE 会话的屏幕。每个会话都有一个单独的屏幕捕获文件。屏幕捕获文件会发送到控制台。有关使用屏幕捕获功能来自定义屏幕的更多信息，请参阅配置屏幕。