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

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

When the agent is connected to TeamCity server and authorized, you can browse and download the agent logs in TeamCity web UI, on the ログ tab for an agent. This tab is not available for unauthorized agents, as TeamCity does not communicate with their machines — read the log files on the agent machine directly instead.

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

ログファイル

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 サーバーログページを参照してください。

2026 年 9 月 01 日

関連ページ：

TeamCity エージェントをインストールして開始する

TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...

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

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

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

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