Q100719:启用调试和详细日志记录

概括

启用渲染日志中的调试消息有助于排查Katana中的渲染崩溃问题,并获取有关问题发生位置的更多详细信息。渲染插件也提供了启用更详细日志记录的设置,以帮助排查渲染供应商插件中发生的渲染器崩溃问题。

本文将一步步指导您如何在Katana中使用不同的渲染器启用更详细的日志记录。

更多信息

要启用Katana渲染日志中的调试消息,您需要在Katana的日志配置文件中调整日志级别。

默认配置文件位于%KATANA_ROOT%/bin/log.conf 。如果您觉得更方便,可以将此文件复制到其他目录,根据需要进行修改,然后通过指定FNLOGGING_CONFIG环境变量,使Katana使用您的自定义配置文件。更多详情,请参阅Katana用户指南中的“消息日志记录”部分。

准备好在渲染日志中启用调试消息后,请按照以下步骤打开并编辑日志配置文件,该文件通常位于%KATANA_ROOT%/bin/log.conf

  1. 将下列行更改为

log4cplus.rootLogger=INFO, Katana LogFile, Katana ConsoleOutput

log4cplus.rootLogger=DEBUG, Katana LogFile, Katana ConsoleOutput
log4cplus.logger.python = DEBUG

  1. 要清除渲染日志中的旧数据并开始查看最新记录的消息,您需要删除katana .log文件。如果您使用的是 Windows 系统,可以在`%TEMP%`目录中找到该文件。对于 Linux 用户,该文件位于`/tmp/`目录中。

如果您在将 USD 数据转换为Katana数据后遇到 USD 文件问题,可以收集一些额外信息来帮助排查问题。创建一个 RenderSettings 节点,找到deferredUsdToKatana部分。在该部分中,启用详细模式。启用后,您可以在 USD 场景合成和场景图生成过程中,通过勾选详细模式来获取更多输出信息。

插件特定日志级别

除了提高Katana的渲染日志级别之外,一些渲染供应商插件也提供了增加渲染日志中消息详细程度的选项。如果崩溃与渲染供应商插件有关,那么启用该插件特定的详细设置将有助于更清晰地了解崩溃发生的位置。以下步骤介绍如何针对每个会话(而非全局)更改渲染供应商插件的日志级别。

注意:任何由渲染供应商插件引起的崩溃都需要直接向渲染供应商报告。

3Delight

如果您想在 3Delight 中启用详细模式,以便在渲染之前、期间和之后获取更多信息提示,您可以将 3Delight 安装文件夹中的 verbose 选项设置为 1。3Delight 默认安装在C:\Program Files\3Delight目录下。

请访问 3Delight 文档以获取最新信息: 3delight.config 文件

阿诺德

要在Katana ToArnold 插件中激活详细模式,您可以创建一个 ArnoldGlobalSettings 节点,并“详细设置”下启用 AI_LOG_DEBUG 选项

请访问 Arnold 文档获取最新信息: 详细程度设置 - Arnold for Katana

渲染人

默认情况下,RenderMan for Katana 的日志级别Katana“INFO”,该级别由位于 $KATANA_HOME$/logging 目录下的日志配置文件以及修改rootLogger “INFO” $KATANA_HOME$/logging此外,您还可以通过创建 PrmanGlobalStatements 节点并修改commandArguments.loglevel参数,在 RenderManForKatana 插件中提高日志级别

请访问 RenderMan 文档以获取最新信息: 使用 RenderManforKatana 的渲染设置

红移

要提高 Redshift4Katana 插件的详细程度,您可以创建一个 RedshiftRenderSettings 节点并更改options.Log Level参数。

请访问 Redshift 文档以获取最新信息: 日志文件位置

延伸阅读

如需更多关于如何解决渲染问题的帮助,请访问Q100391: Katana中的渲染问题排查

如需帮助解决性能问题,请访问Katana用户指南 - 优化性能 > Geolib3-MT 分析

更多帮助

如果您仍然遇到渲染问题,请提交支持工单,并告知我们您遇到的问题以及您目前已采取的故障排除步骤。同时,请提供Q100520 中概述的系统信息:获取操作系统报告以用于Foundry支持调查期间发送的硬件规格信息。

有关如何提交支持工单的更多信息,请参阅Q100064:如何提交支持工单文章。

    我们很遗憾听到

    请告诉我们