TeamCity 2019.1ヘルプ

TeamCityサーバーログ

このページで:

TeamCityサーバーは、サーバーの動作に関する課題を調査したり、内部エラーの詳細を取得したりするために調べることができる内部アクティビティのログを保持しています。

ログは、TeamCityサーバーマシンのディスクディレクトリー(通常は < TeamCity Server home >/logs)のプレーンテキストファイルに保存されます。TeamCityの実行中は、ファイルにメッセージが追加されます。

サーバーの実行中、ログは管理 | 診断セクションの Server Logs タブのWeb UIで表示できます。

一般的なロギングの説明

TeamCityは、ロギングにlog4jライブラリー(英語)を使用し、その設定をカスタマイズできます。

デフォルトでは、ログファイルは < TeamCity Server home >/logs ディレクトリーにあります。

最も重要なログファイルは次のとおりです。

teamcity-server.log

一般的なサーバーログ

teamcity-activities.log

ユーザー開始イベントおよび主要なビルド関連イベントのログ

teamcity-vcs.log

VCS -relatedアクティビティのログ

teamcity-cleanup.log

clean-up -relatedログを含む

teamcity-notifications.log

通知 -関連ログ

teamcity-clouds.log

(デフォルトではオフ)クラウド統合 -relatedログ

teamcity-sql.log

(デフォルトではオフ)SQLクエリのログ、詳細を参照

teamcity-http-auth.log

(デフォルトではオフ)NTLMおよびその他のHTML要求の認証に関連するメッセージをログに記録する

teamcity-xmlrpc.log

(デフォルトではオフ)サーバーがXML-RPC経由でエージェントおよびIDEプラグインに送信したメッセージのログ

vcs-content-cache.log

(デフォルトではオフ)VCSからの個々のファイルコンテンツリクエストに関連するログ

teamcity-rest.log

(デフォルトではオフ)REST-API関連のロギング

teamcity-freemarker.log

(デフォルトではオフ)通知テンプレート処理関連のログ

teamcity-agentPush.log

(デフォルトではオフ) エージェントのプッシュ操作に関連するログ

teamcity-remote-run.log

(デフォルトではオフ)サーバーでの個人ビルド処理に関連するログ

teamcity-svn.log

(デフォルトではオフ)SVN統合ログ

teamcity-tfs.log

(デフォルトではオフ)TFS統合ログ

teamcity-starteam.log

(デフォルトではオフ)StarTeam統合ログ

teamcity-clearcase.log

(デフォルトではオフ)ClearCaseの統合ログ

teamcity-ldap.log

LDAP -関連ログ

teamcity-nuget.log

NuGet -関連ログ

teamcity-maintenance.log

(デフォルトではオフ) maintainDBツールで実行されたバックアップ/復元/移行のログ

teamcity-maintenance-truncation.log

(デフォルトでオフ)は、maintainDBツールで実行されたバックアップ/復元/移行中のデータの切り捨てに関する拡張情報を含みます

teamcity-versioned-settings.log

(デフォルトではオフ) プロジェクト設定とバージョン管理の同期に関する情報が含まれています

teamcity-ws.log

ブラウザとWebSocket接続を使用したTeamCityサーバー間の通信に関連するログ

teamcity-issue-trackers.log

TeamCityと設定された課題追跡システム間の通信に関連するログ

ロギング構成の変更時に他のファイルを作成することもできます。

一部のファイルには .N 拡張子が付いている場合があります。これは、メインファイルのローテーション時に以前のログメッセージがコピーされたファイルです。より多くのファイルを保存するには、 maxBackupIndex を参照してください。

ロギング関連の診断UI

システム管理者ロールを持つユーザーは、管理 | 診断 | サーバー・ログを使用してTeamCity UIからサーバーログを直接表示およびダウンロードできます。

ロギング構成の変更

TeamCityの実行中に、使用可能な logging presetsを選択することにより、アクティブなロギング設定を変更できます。

アクティブなロギングプリセットは、管理 | 診断ページ、トラブルシューティングデバッグログサブセクションで変更されます。プリセットを選択すると、ロギング設定がすぐに変更され、サーバーの再起動後、ページで再び変更されるまでプリセットが保持されます。必要なログが収集されたら、「<デフォルト>」に戻ることをお勧めします。

使用可能なプリセットは、< TeamCity Data Directory >/config/_logging ディレクトリーの.xml拡張子を持つファイルに保存されます。新しいファイルをディレクトリーに追加し、既存のファイルを変更できます(.dist規則を使用)。診断 | ロギングプリセットを介して新しいプリセットをアップロードすることもできます。

ロギングプリセット(たとえば、サーバーの初期化中にロギングを取得するには、次のようにします)を使用してデバッグロギングモードを有効にしたり、ロギングに永続的な変更を加えることができない場合は、conf/teamcity-server-log4j.xml ファイルをバックアップし、conf/teamcity-server-log4j.xml 上で < TeamCity Data Directory >/config/_logging/debug-general.xml ファイルをコピーまたは名前変更してからサーバーを起動できます。

ロギング設定の変更

log4j構成を微調整する場合は、< TeamCity Server home >/conf/teamcity-server-log4j.xml ファイルを編集できます( .war TeamCityディストリビューションについては、関連セクションを参照してください)。サーバーが実行中の場合、log4j構成ファイルが自動的にリロードされ、ロギング構成がオンザフライで変更されます(log4jの制限が適用されるため、大幅な変更を行う場合はサーバーの再起動を検討してください)。

log4j構成の最も有用な設定:
ファイルに保存する最小ログレベルを変更するには、priority 要素の value 属性を調整します。

<category ...> <priority value="INFO"/> ...

ログはデフォルトでローテーションされます。デバッグが有効になっている場合、maxBackupIndex 要素の value 属性を増やして、保存されるログファイルの数に影響を与えることは理にかなっています。その間、十分な空きディスク容量があることを確認してください。

<appender ...> <param name="maxBackupIndex" value="10"/> ...

maxBackupIndex およびその他のサポートされる属性の詳細については、ApacheのドキュメントのクラスRollingFileAppender(英語)を参照してください。

ログを読む

各メッセージにはタイムスタンプとレベル(ERROR , WARN , INFO , DEBUG)があります。

例:

[2010-11-19 23:22:35,657] INFO - s.buildServer.SERVER - Agent vmWin2k3-3 has been registered with id 19, not running a build
  • ERROR は、操作が失敗し、一部のデータが失われたか、アクションが実行されなかったことを意味します。一般的に、ログにはエラーはありません。

  • WARN は通常、操作が失敗したが、再試行されるか、操作が重要ではないと見なされることを意味します。ある程度の警告は問題ありません。ただし、このような警告のログを確認して、何が問題で何が問題なのかをより理解することができます。

  • INFO は、現在のアクティビティを報告するだけの情報メッセージです。

  • DEBUG は、たとえばTeamCity開発者が分析する課題の調査にのみ役立ちます。

一般的なロギング設定

デフォルトでは、TeamCityは .../conf/teamcity-server-log4j.xml ファイルでlog4j構成を検索します( binから実行する場合、TeamCity .exe および .tar.gz ディストリビューションの場合、< TeamCity Server home >/conf/teamcity-server-log4j.xml に解決されます)。そのようなファイルが存在しない場合、デフォルトのlog4j構成が使用されます。ログは、デフォルトで ../logs ディレクトリーに保存されます。

構成オプションの値は、対応する log4j.configuration および teamcity_logs JVMオプションまたは内部プロパティーを介して変更できます。
例: log4j.configuration=file:../conf/teamcity-server-log4j.xml および teamcity_logs=../logs/
デフォルト値は、.exeおよびtar.gzディストリビューションで利用可能な bin/teamcity-server スクリプトで検索できます。

バンドルされた teamcity-server または runAll スクリプト以外の手段でTeamCityを開始する場合は、上記のオプションをサーバーJVMに必ず渡してください。バンドルされていないWebサーバーへのTeamCityのインストールに関する推奨事項も参照してください。

デフォルトの teamcity-server-log4j.xml ファイルの内容は、.exe および tar.gz ディストリビューションに含まれています。デバッグが有効になっているものは、サーバーの最初の起動後、< TeamCity Data Directory >/config/_logging/debug-general.xml 名にあります。サンプルteamcity-server-log4j.xml(英語)ファイルも参照してください。


関連事項:

管理者ガイド : ビルドエージェントログの表示
トラブルシューティング : 課題の報告