TeamCity 2020.2 ヘルプ

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 からサーバーログを直接表示およびダウンロードできます。

ロギング構成の変更

While TeamCity is running, active logging settings can be changed by selecting between available 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 ファイルを編集できます。サーバーが実行中の場合、log4j 構成ファイルが自動的に再ロードされ、ログ構成がオンザフライで変更されます(log4j の制限が引き続き適用されるため、大幅な変更を行う場合は、サーバーの再起動を検討してください)。

debug-all.xmldebug-vcs.xml などの他のプリセットファイルの設定を変更しても、設定は自動的に取得されません。変更を強制するには、ログプリセットを <Default> などの他の値に切り替えてから、debug-all に戻します。

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

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

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

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

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

ログを読む

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

例:

[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 (英語) ファイルも参照してください。

関連ページ:

TeamCity ホームディレクトリ

TeamCity ホームディレクトリまたはTeamCity インストールディレクトリは、TeamCity がインストールされたときに TeamCity サーバーアプリケーションファイルおよびライブラリが解凍されたディレクトリです。TeamCity ホームディレクトリの場所は、TeamCity サーバ...

クリーンアップ

TeamCity のクリーンアップ機能により、古いビルドデータや不要なビルドデータを自動的に削除できます。サーバーのクリーンアップ構成は管理 | サーバー管理 | クリーンアップ設定で使用可能です。クリーンアップスケジュールの設定が可能で、一般的なクリーンアップ情報が表示されます。特定のプロジェクト...

パーソナルビルド

パーソナルビルドは、一般的なビルドシーケンスのビルドアウトであり、通常はバージョン管理にまだコミットされていない変更を使用します。パーソナルビルドは通常、サポートされている IDEの 1 つからリモート実行プロシージャを介して開始されます。以下で説明するように、変更を含むパッチをサーバーに直接アップ...

バージョン管理でのプロジェクト設定の保存

TeamCity を使用すると、プロジェクト設定をバージョン管理リポジトリと双方向で同期できます。サポートされている VCS は、Git、Mercurial、Perforce、Subversion、Azure DevOps Server(以前の TFS)です。設定を XML 形式またはKotlin

TeamCity と課題追跡システムの統合

TeamCity を課題トラッカーと統合して、開発プロジェクトの包括的なビューを提供できます。TeamCity は、バージョン管理の変更に対するコメントに記載されている課題を検出し、TeamCity Web UI の課題トラッカーへのリンクに変換します。統合はプロジェクトレベルで構成されます。プロジ...

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

TeamCity エージェントの詳細を表示する :TeamCity Web UI のエージェントページは、TeamCity エージェントに関する包括的な情報を提供します。ページ上のタブの数は、エージェントのセットアップによって異なる場合があります。接続済み / 切断済み接続済みタブと切断済みタブには...