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
システム管理者ロールを持つユーザーは、管理 | 診断 | サーバー・ログを使用して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 属性を調整します。
ログはデフォルトでローテーションされます。デバッグが有効になっている場合、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サーバーを...
REST API
一般情報一般的な使用箇所、REST認証、スーパーユーザーアクセス、REST APIのバージョン、URLの構造、ロケーター、サポートされているHTTPメソッド、応答フォーマット完全および部分的な回答、ロギング、CORSのサポート、APIクライアントの推奨事項、TeamCityデータエンティティ要求プロ...
TeamCityと課題追跡システムの統合
TeamCityを課題トラッカーと統合して、開発プロジェクトの包括的なビューを提供できます。TeamCityは、バージョン管理の変更に対するコメントに記載されている課題を検出し、TeamCity Web UIの課題トラッカーへのリンクに変換します。統合はプロジェクトレベルで設定されます。プロジェクト...