TeamCity 2020.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の制限が適用されるため、大幅な変更を行う場合はサーバーの再起動を検討してください)。

If you change settings in other preset files, like debug-all.xml or debug-vcs.xml , the settings won't be picked up automatically. To enforce the change, switch logging preset to some other value, like <Default> and then switch back to debug-all .

Most useful settings of log4j configuration:
To change the minimum log level to save in the file, tweak the value attribute of the priority element:

<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 ディレクトリに保存されます。

The configuration options values can be changed via the corresponding log4j.configuration and teamcity_logs JVM options or internal properties.
For example: log4j.configuration=file:../conf/teamcity-server-log4j.xml and teamcity_logs=../logs/ .
Default values can be looked up in the bin/teamcity-server script available in the .exe and tar.gz distributions.

バンドルされた 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のクリーンアップ機能により、古いビルドデータや不要なビルドデータを自動的に削除できます。このページで:サーバーのクリーンアップ設定手動クリーンアップ起動、クリーンアップ規則基本ルール依存関係ビルドの基本ルールの動作、フィーチャーブランチを使用したビルド構成の基本ルールの動作、パーソナ...

REST API

TeamCityは、外部アプリケーションを統合し、TeamCityサーバーとのスクリプト相互作用を作成するためのREST APIを提供します。このページは3つのメインセクションで構成されています。一般情報は、REST API認証の原理、リクエストの構造、サポートされるHTTPメソッドについて説明して...

パーソナルビルド

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

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

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

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

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