ビルドログ

ビルドログを表示する

完全なログの詳細を表示するには、ビルド結果ページに移動し、ビルドログタブに切り替えます。

このタブには次の UI 要素が表示されます。

• すべて展開 / すべて折りたたむ — ネストされたすべてのログメッセージを展開および折りたたみます。

• すべてのメッセージ / エラー / 重要なメッセージ / 詳細 — このセレクターを使用すると、ビルドログメッセージを種類別にフィルタリングできます。より分かりにくく曖昧なビルドエラーをデバッグする場合は、「詳細」を選択すると、フィルタリングされていない最も詳細なログが表示されます。

• 表示 - ビルドログパネルでログ行を折り返すオプションや、絶対時間ではなくビルド開始時間を基準としたタイムスタンプを表示するオプションが含まれます。

• ログのダウンロード - 選択した形式で完全なビルドログをダウンロードできます。

• 全画面表示にする — ブラウザーのサイズに合ったモーダルパネルでビルドログを開きます。

ログ分析ツールとの統合

TeamCity ビルドによって生成されたログをサードパーティのログ分析ツールで取り込みたい場合は、次の URL をターゲットとする統合を設定します。

• http(s)://<SERVER_URL>/downloadBuildLog.html?buildId=<ID> — ログ分析ツールがアクセストークンを使用して TeamCity で認証する場合。

• http(s)://<SERVER_URL>/httpAuth/downloadBuildLog.html?buildId=<ID> — ツールが標準のユーザー名 / パスワード資格情報を使用して認証する場合。

例: 次の URL へのリクエストにより、内部 ID が「4102」であるビルドのログがダウンロードされます。

ビルド ID は、ビルド番号とは異なる一意の値であることに注意してください。ビルド ID は、ビルド結果ページの URL (?buildTab=... パラメーターの前の整数値) から取得できます。

REST API 経由でビルド ID を取得するには、/app/rest/builds エンドポイントにリクエストを送信します。さまざまなロケーターを使用して、特定のビルドを検索できます。例: 次のリクエストは、特定のビルド構成に属するビルドを返します。

ログ出力のカスタマイズ

サービスメッセージを使用してログ出力を変更できます。これには、ログエントリをブロックにグループ化すること、並列メッセージフローを処理すること、ログメッセージの重大度を変更することなどが含まれます。

ログサイズを構築

ビルドログを小さく保ち、ビルドスクリプトを調整して出力に出力しすぎないようにすることをお勧めします。大きなビルドログはブラウザーで表示するのが難しく、ビルドの実行中にエージェントからサーバーにビルドメッセージをパイプ処理する TeamCity インフラストラクチャをロードしています。

ビルドの進行状況とビルドの失敗を理解するために必要なメッセージのみを出力に出力することをお勧めします。残りの情報はログファイルにストリーミングし、そのファイルはビルドアーティファクトとして公開する必要があります。「良い」ビルドログサイズは最大でもメガバイトです。

ビルドログでの ANSI スタイルのカラーリング

TeamCity ビルドログは、クリック可能なハイパーリンクをレンダリングし、デフォルトで ANSI スタイルのエスケープカラーコードをサポートします。ツールが色付きのコンソール出力を生成する場合、TeamCity のビルドログに表示されます。サポートされているシーケンスの完全なリスト(英語)については、関連する機能リクエストを参照してください。

色付けを無効にするには、teamcity.buildLog.ansiColoring.enabled=false 内部プロパティを設定します。