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

2. レンダリングログから古いデータを消去し、最新の記録メッセージを表示するには、 katana .logファイルを削除する必要があります。Windows をご利用の場合、このファイルは`%TEMP%`ディレクトリにあります。Linux をご利用の場合、このファイルは`/tmp/`ディレクトリにあります。

USDデータをKatanaデータに変換した後にUSDファイルに問題が発生した場合、問題のトラブルシューティングに役立つ追加情報を収集できます。RenderSettingsノードを作成し、 deferredUsdToKatanaセクションを探します。このセクション内で、Verbosityモードを有効にします。Verbosityモードを有効にすると、USDシーンの合成やシーングラフ生成時に出力情報からより多くの情報を取得できます。

プラグイン固有のログレベル

Katanaのレンダリングログレベルを上げることに加えて、一部のレンダリングベンダープラグインには、レンダリングログに記録されるメッセージの詳細設定を上げるオプションがあります。クラッシュがレンダリングベンダープラグインに関連する場合、レンダリングベンダープラグイン固有の詳細設定を有効にすると、クラッシュが発生した場所が明確になります。以下は、レンダリングベンダープラグインのログレベルをグローバルではなくセッションごとに変更する手順です。

注意:レンダリング ベンダーのプラグインによって発生したクラッシュについては、レンダリング ベンダーに直接報告する必要があります。

さらに詳しく

レンダリングの問題のトラブルシューティング方法の詳細については、Q100391「 Katanaのレンダリングの問題のトラブルシューティング」を参照してください。

パフォーマンスの問題のトラブルシューティングについては、 Katanaユーザーガイドの「パフォーマンスの最適化」>「Geolib3-MTプロファイリング」をご覧ください。

さらなる支援

引き続きレンダリングの問題が発生している場合は、サポートチケットを開き、発生している問題とこれまでに行ったトラブルシューティング手順をお知らせください。また、 Q100520「 Foundryサポート調査時に送信するためのハードウェア仕様に関するオペレーティングシステムレポートの取得」に記載されているシステム情報もお知らせください。

サポート チケットを開く方法の詳細については、 「Q100064: サポート チケットの発行方法」の記事を参照してください。