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

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

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

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

ログファイル

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

DEBUG モードを有効にするには、Log4j 構成ファイルのコメントを参照してください。ビルドエージェントのログは <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-log4j2.xml ファイルで jetbrains.buildServer カテゴリのログの優先度を変更します。

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

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

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

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

VCS デバッグロギング

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

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

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

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

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

特定のデバッグログ

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

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

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

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

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

高度なロギング設定

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

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

2025 年 4 月 07 日

関連ページ：

ビルドエージェント起動プロパティの設定

TeamCity では、ビルドエージェントに 2 つのプロセスが含まれます。エージェントランチャー — エージェントプロセスを起動する Java プロセス。エージェント — ビルドエージェントのメインプロセス。エージェントランチャーの子プロセスとして実行されます。ビルドエージェントをスクリプト経由で実行するか、Windows サービスとして実行するかにかかわらず、最初にエージェントランチャーが起動し、次にエージェント自体が起動します。スクリプト経由でエージェントを実行することが推奨される方法です...

ビルドエージェントの設定とメンテナンス

TeamCity エージェントの詳細の表示：TeamCity Web UI のエージェントページは、TeamCity エージェントに関する包括的な情報を提供します。ページ上のタブの数は、エージェントのセットアップによって異なる場合があります。接続済み / 切断済み接続済みタブと切断済みタブには、エージェントがエージェントプール (デフォルト) 順に表示されます。エージェントをアルファベット順に表示するには、エージェントプールによるグループ化ボックスのチェックを外します。TeamCity は各プー...