TeamCity サーバーログ
TeamCity サーバーは、サーバーの動作に関する問題を調査したり、内部エラーの詳細を取得したりするために調べることができる内部アクティビティのログを保持しています。
ログは、TeamCity サーバーマシンのディスクディレクトリ(通常は <TeamCity Server home>/logs
内)のプレーンテキストファイルに保存されます。TeamCity の実行中は、ファイルにメッセージが追加されます。
サーバーの実行中、ログは管理 | 診断セクションの Server Logs
タブの Web UI で表示できます。
一般的なロギングの説明
TeamCity は、ロギングに log4j ライブラリ(英語)を使用し、その設定をカスタマイズできます。
デフォルトでは、ログファイルは <TeamCity Server home>/logs
ディレクトリにあります。
最も重要なログファイルは次のとおりです。
| 一般的なサーバーログ |
---|---|
| ユーザー開始イベントおよび主要なビルド関連イベントのログ |
| VCS -related アクティビティのログ |
| clean-up -related ログを含む |
| 通知 - 関連ログ |
| (デフォルトではオフ)クラウド統合 -related ログ |
| (デフォルトではオフ)SQL クエリのログ、詳細を参照 |
| (デフォルトではオフ)NTLM およびその他の HTML 要求の認証に関連するメッセージをログに記録します |
| (デフォルトではオフ)サーバーが XML-RPC 経由でエージェントおよび IDE プラグインに送信したメッセージのログ |
| (デフォルトではオフ)VCS からの個々のファイルコンテンツリクエストに関連するログ |
| (デフォルトではオフ)REST-API 関連のロギング |
| (デフォルトではオフ)通知テンプレート処理関連のログ |
| (デフォルトではオフ)エージェントのプッシュ操作に関連するログ |
| (デフォルトではオフ)サーバーでの個人ビルド処理に関連するログ |
| (デフォルトではオフ)SVN 統合ログ |
| (デフォルトではオフ)TFS 統合ログ |
| (デフォルトではオフ)StarTeam 統合ログ |
| (デフォルトではオフ)ClearCase 統合プラグインログ |
| LDAP - 関連ログ |
| NuGet - 関連ログ |
| (デフォルトではオフ) maintainDB ツールで実行されたバックアップ / 復元 / 移行のログ |
| (デフォルトでオフ)は、maintainDB ツールで実行されたバックアップ / 復元 / 移行中のデータの切り捨てに関する拡張情報を含みます |
| |
| ブラウザーと WebSocket 接続を使用した TeamCity サーバー間の通信に関連するログ |
| TeamCity と設定された課題追跡システム間の通信に関連するログ |
ロギング構成の変更時に他のファイルを作成することもできます。
一部のファイルには .N
拡張子が付いている場合があります。これは、メインファイルのローテーション時に以前のログメッセージがコピーされたファイルです。より多くのファイルを保存するには、 maxBackupIndex
を参照してください。
ロギング関連の診断 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.xml
や debug-vcs.xml
などの他のプリセットファイルの設定を変更しても、設定は自動的に取得されません。変更を強制するには、ログプリセットを <Default>
などの他の値に切り替えてから、debug-all
に戻します。
log4j 構成の最も有用な設定:
ファイルに保存する最小ログレベルを変更するには、priority
要素の value
属性を微調整します。
ログはデフォルトでローテーションされます。デバッグが有効になっている場合、maxBackupIndex
要素の value
属性を増やして、保存されるログファイルの数に影響を与えることは理にかなっています。その間、十分な空きディスク容量があることを確認してください。
maxBackupIndex
およびその他のサポートされる属性の詳細については、Apache のドキュメントのクラス RollingFileAppender(英語) を参照してください。
ログを読む
各メッセージにはタイムスタンプとレベル(ERROR
、WARN
、INFO
、DEBUG
)があります。
例:
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 エージェントに関する包括的な情報を提供します。ページ上のタブの数は、エージェントのセットアップによって異なる場合があります。接続済み / 切断済み接続済みタブと切断済みタブには...