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

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

エージェントが TeamCity サーバーに接続され、承認済みの場合、TeamCity Web UI のエージェントのログタブでエージェントログを閲覧とダウンロードできます。未承認のエージェントではこのタブを使用できません。TeamCity はそれらのマシンと通信しないため、代わりにエージェントマシン上のログファイルを直接読み取ってください。

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

ログファイル

TeamCity はイベントの内部ロギングに Log4j 2.x を使用します。デフォルトのビルドエージェント Log4j 構成ファイルは <エージェントホーム>/conf/teamcity-agent-log4j2.xml です。

DEBUG モードを有効にするには、Log4j 構成ファイルのコメントを参照してください。ビルドエージェントのログは <エージェントホーム>/ログ ディレクトリに配置されます。通常、更新されたロギング構成を適用するためにエージェントを再起動する必要はありません。

ファイル名	説明
`teamcity-agent.log`	一般ビルドエージェントログ
`teamcity-build.log`	エージェントによって実行されたビルドの `標準出力` および `標準エラー出力` 出力
`teamcity-vcs.log`	VCS 関連のロギング (チェックアウトモードの場合 "Automatically on agent")
`upgrade.log`	ビルドエージェントのアップグレードのログ (アップグレードプロセスによって記録されます)
`ランチャー.ログ。`	エージェントの監視 / 起動プロセスのログ
`wrapper.log`	（エージェントが Windows サービスまたは Java Service Wrapper によって実行されている場合にのみ存在します）プロセス構築エージェント起動プロセスの出力

一般的なデバッグロギング

エージェントで一般的なデバッグログを有効にするには、 <エージェントホーム>/conf/teamcity-agent-log4j2.xml ファイルで jetbrains.ビルドサーバー カテゴリのログの優先度を変更します。

<Logger name="jetbrains.buildServer" level="DEBUG">
    <AppenderRef ref="ROLL"/>
</Logger>

  

TeamCity バージョン < 2022.04 を使用している場合は、 <エージェントホーム>/conf/teamcity-agent-log4j.xml ファイルで次の置換を行ってください：

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

  

次に、 teamcity-agent.ログ* ファイルを参照してください。

VCS デバッグロギング

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

<Logger name="jetbrains.buildServer.VCS" level="DEBUG">
    <AppenderRef ref="ROLL.VCS"/>
</Logger>

  

TeamCity バージョン < 2022.04 を使用している場合は、 <エージェントホーム>/conf/teamcity-agent-log4j.xml ファイルで次の置換を行ってください：

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

  

次に、 teamcity-vcs.ログ* ファイルを参照してください。

特定のデバッグロギング

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

<Logger name="jetbrains.buildServer.XMLRPC" level="DEBUG">
    <AppenderRef ref="ROLL.XMLRPC"/>
</Logger>

TeamCity バージョン < 2022.04 を使用している場合は、 <エージェントホーム>/conf/teamcity-agent-log4j.xml ファイルで次の置換を行う必要があります。

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

次に、 teamcity-xmlrpc.ログ を参照してください。

高度なロギング構成

teamcity_ログ プロパティの値を変更することで、ログの場所を設定できます (-D オプションを介して JVM に渡されます)。また、 log4j2.構成 プロパティの値を変更することで、Log4j 構成ファイルの場所を変更することもできます。オプションを渡す方法については、対応するドキュメントのセクションを参照してください。

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

2026 年 9 月 11 日