TeamCity 2020.2 ヘルプ

ビルドエージェントログの表示

エージェント固有のケースを分析するために、TeamCity エージェントプロセスによってエージェントマシンの <TeamCity agent home>/logs ディレクトリに保存された内部ログファイルがあります。

エージェントが TeamCity サーバーに接続されている場合、エージェントのエージェントログタブで、TeamCity Web UI でエージェントログを参照およびダウンロードできます。

ログをカスタマイズする必要がある場合は、以下を参照してください。

ログファイル

TeamCity は、イベントの内部ロギングに Log4j(英語) を使用します。デフォルトのビルドエージェント Log4j 構成ファイルは <agent home>/conf/teamcity-agent-log4j.xml です。
DEBUG モードを有効にする方法については、ファイル内のコメントを参照してください。<param name="maxBackupIndex"..." ノードの値を増やし、<priority value="DEBUG"/> ノードを <category> 要素に挿入する必要があります。ビルドエージェントのログは <agent home>/logs ディレクトリに配置されます。通常、更新されたログ設定を適用するためにエージェントを再起動する必要はありません。

ファイル名

説明

teamcity-agent.log

一般ビルドエージェントログ

teamcity-build.log

エージェントによって実行されたビルドの stdout および stderr 出力

teamcity-vcs.log

VCS 関連のロギング (チェックアウトモードの場合 "Automatically on agent")

upgrade.log

ビルドエージェントのアップグレードのログ (アップグレードプロセスによって記録されます)

launcher.log

エージェントの監視 / 起動プロセスのログ

wrapper.log

(エージェントが Windows サービスまたは Java Service Wrapper によって実行されている場合にのみ存在します)プロセス構築エージェント起動プロセスの出力

一般的なデバッグログ

エージェントで一般的なデバッグログを有効にするには、<agent home>/conf/teamcity-agent-log4j.xml ファイルで jetbrains.buildServer カテゴリのログ記録の優先順位を変更します。

<category name="jetbrains.buildServer"> <priority value="DEBUG"/> <appender-ref ref="ROLL"/> </category>

次に、teamcity-agent.log* ファイルを参照してください。
デバッグモードをオフにするには、行 <priority value="INFO"/> を作成します。

VCS デバッグロギング

エージェントでの詳細な VCS ログ記録を有効にするには、<agent home>/conf/teamcity-agent-log4j.xml ファイルで VCS カテゴリのログ記録の優先順位を変更します。

<category name="jetbrains.buildServer.VCS"> <priority value="DEBUG"/> <appender-ref ref="ROLL.VCS"/> </category>

次に、teamcity-vcs.log* ファイルを参照してください。
デバッグモードをオフにするには、行を <priority value="INFO"/> にします。

特定のデバッグログ

エージェントからサーバーに送信されたデータのダンプを取得するには、<agent home>/conf/teamcity-agent-log4j.xml ファイルの行をコメント解除して、エージェントの XML-RPC ログを有効にします。

<category name="jetbrains.buildServer.XMLRPC"> <!--<priority value="DEBUG"/>--> <appender-ref ref="ROLL.XMLRPC"/> </category>

次に、teamcity-xmlrpc.log を参照してください。
オフにするには、行 <priority value="INFO"/> を作成します。

高度なロギング設定

teamcity_logs プロパティの値( -D オプションを介して JVM に渡される)を変更することで、ログの場所を設定できます。 log4j.configuration プロパティの値を変更して Log4j 設定ファイルの場所を変更することもできます。オプションの引き渡し方法については、対応する文書のセクションを参照してください。

ロギングの調整に関する追加オプションについては、TeamCity サーバーログページを参照してください。