サーバーの健全性

メインノードが非アクティブです

メインノードは N 分間非アクティブです。

これが計画された非アクティブ状態 (再起動またはアップグレード) の場合、このメッセージは無視できます。メインノードが再びアクティブになると消えます。 それ以外の場合は、メインノードサーバーにログインして TeamCity プロセスのステータスを確認してください。

TeamCity プロセスが存在しない場合、またはサーバーがダウンしていて短時間で復旧できない場合は、" メイン TeamCity ノード" の責任を現在のノードまたは他のノードに ノード構成 ページで割り当てることができます。

メインサーバーとセカンダリサーバーのバージョンが異なります

セカンダリノードのバージョンが現在のサーバーのバージョンと一致しません。

この場合、 セカンダリノードを更新して、メイン TeamCity サーバーと同じバージョンにする必要があります。

マルチノードセットアップにプロキシサーバーがありません

マルチノードセットアップにプロキシサーバーがありません。

高可用性の TeamCity インストールを設定するには、 リバースプロキシを構成する必要があります。

未割り当ての責任

クラスターノードのいずれにも特定の責任が指定されていない場合、TeamCity が通知します。 たとえば、すべてのノードで "VCS リポジトリのポーリング" の責任がオフになっている場合、TeamCity はリポジトリの変更を確認して新しいビルドを開始できません。 管理 | ノード設定 に移動し、各責任が少なくとも 1 つのノードに割り当てられていることを確認します。

プロキシ構成のバージョン不一致

プロキシ構成で宣言された X-TeamCity-Proxy ヘッダーの値が、その構成が TeamCity サーバーと完全には互換性がないことを示している場合、TeamCity はこの警告を表示します。 このドキュメントを TeamCity サーバーに一致するバージョンに切り替え、プロキシ設定がこれらのサンプル構成と類似していることを確認してください: プロキシ構成。

サーバールート URL が HTTP を使用しています

TeamCity への HTTPS アクセスを構成したが、 サーバー URLがまだ "http://..." アドレスに設定されている場合、このレポートが表示されます。 この警告を閉じるには、サーバー URL を更新してください。

ドメイン分離アーティファクト URL が HTTP を使用しています

TeamCity への HTTPS アクセスを構成したが、 アーティファクト分離 URLがまだ "http://..." アドレスに設定されている場合、このレポートが表示されます。 この警告を閉じるには、アーティファクト分離 URL を更新してください。

プロキシサーバー構成

TeamCity サーバーの前段でリバースプロキシを使用している場合、WebSocket プロトコルをサポートするように 構成する必要があります。

WebSocket 接続をサポートしないブラウザーで使用されるすべての URL は、対応する正常性レポートにリストされます。

BIO コネクターの調整

Tomcat が BIO コネクター(英語)を使用するように構成されている場合、WebSocket プロトコルは 自動的に無効になります(英語)。 NIO コネクターを使用するように Tomcat コネクターの設定を変更することをお勧めします。

依存関係の問題

TeamCity は、欠落しているビルド構成に依存するビルド構成 (たとえば、依存関係が構成された後に削除されたビルド構成) を検出します。

大きなビルドログがある構成

大きな ビルドログ (デフォルトでは 200 MB 超) は、構文解析するには重すぎ、ブラウザーで表示しにくいため、サーバーのパフォーマンスを低下させる可能性があります。

一部のビルド構成でこのインスペクションが頻繁に失敗する場合は、ビルドスクリプトを調整して出力を少なくすることができます。

非効率なアーティファクト公開

TeamCity は、多くの小さなアーティファクトファイルを公開しているビルドを検出し、アップロード/ダウンロード操作を最適化するために、それらを単一の .zip アーカイブとして公開することを提案します。 詳細については、 こちらを参照してください。

重複ファインダーランナー

バージョン 2021.3 以降の ReSharper コマンドラインツールには、DupFinder ツールが含まれなくなりました。 その結果、このツールに依存する 重複ファインダー (ReSharper) ランナーは、最新の TeamCity インストールにバンドルされている CLT バージョンでは動作できません。

このランナーを引き続き使用するには、バージョン 2021.2.3 以前の R# CLT をインストールし、ランナーの詳細設定でこのバージョンを選択します。

未使用の VCS ルート

TeamCity は、プロジェクトで定義された VCS ルートを表示し、未使用のルートの削除を提案します。

類似した VCS ルート

TeamCity は、主要な設定 (たとえば URL、ブランチ設定) が同じ場合、一部の設定 (たとえばユーザー名、パスワード) が異なっていても、 VCS ルートを同一と見なします。

レポートには同一のルートが表示され、マージするかどうかはユーザーに任されます。

類似した VCS ルートの使用箇所 (別名インスタンス)

VCS ルート設定の値を定義したり、 さまざまなレベルで定義されたさまざまなパラメーターへのパラメーター参照を使用したりできます。

参照される VCS ルートパラメーターが定義された値と同じ値に解決されると、そのような場合は同一の VCS ルート使用として報告されます。

一般的な推奨事項は、ルート設定にパラメーター参照を使用して、VCS ルートの量を最適化することです。

未接続の VCS ルートのトリガールール

VCS トリガーまたはスケジュールトリガーのルールが、どのビルド構成にも接続されていない VCS ルートを参照している場合、TeamCity は警告を表示します。

冗長なトリガー

このレポートには、ビルドトリガーが冗長なケースが表示されます。例：

• A と B の 2 つのビルド構成があります

• A スナップショットは B に依存

• 両方とも VCS トリガー、 スナップショット依存関係の変更をトリガーオプションを有効にした A があります。 この場合、 B の VCS トリガーは冗長であり、 A のビルドが数回キューに入れられます。

複数の同一ビルドトリガー

警告は、同じ型のパラメーター値の同じセットを持つ 2 つ以上の有効なトリガーが存在する場合に表示されます。 無効化されたトリガーは考慮されません。

有効な待機期間が指定値より長いです

ビルド構成の VCS トリガーに待機期間がある場合、TeamCity は、最後に検出された変更後、指定された時間待ってからビルドをトリガーします。 この間、このビルド構成に影響するすべての VCS ルートの変更がチェックされます。 他の VCS ルートが静止期間よりも大きい変更間隔のチェックを持っている場合、有効な静止期間は、関連する VCS ルートの変更間隔の最大チェックに等しくなります（依存関係の VCS ルートである可能性があります）。

考えられる修正は、次のいずれかです。

• コミットフックを使用して、変更操作のチェックをトリガーする

• 関連する VCS ルートの変更間隔のチェックよりも大きくなるように、VCS トリガーの待機期間を長くします

• 問題のある VCS ルートの変更間隔のチェックを減らす

頻繁なクリーンチェックアウトの可能性

このレポートのセクションには、頻繁な クリーンチェックアウトの可能性が表示されます。これは次の二つの理由が原因で発生する場合があります：

カスタムチェックアウトディレクトリ

VCS 設定は異なるが カスタムチェックアウトディレクトリが同じであるビルド構成では、クリーンチェックアウトが頻繁に発生し、パフォーマンスが低下し、増分ソース更新の一貫性が損なわれる可能性があります。

ビルドファイルクリーナー (Swabra) 設定

いくつかのビルド構成で ビルドファイルをきれいにする (Swabra) ビルド機能を有効にすると、余分なクリーンチェックアウトが発生する場合があります。 これは、これらの構成からのビルドが同じエージェントで交互に実行され、同じバージョン管理設定または同じカスタムチェックアウトディレクトリが指定されている場合に発生する可能性があります。

頻繁なクリーンチェックアウト (Swabra ケース) サーバーヘルスレポートには、Swabra の設定ごとにグループ化されたこのような誤った設定が表示されます。

最適な推奨チェックアウト

エージェント側のチェックアウトに切り替えることを推奨する大規模なサーバー側パッチのレポートが表示されます。

エージェントでのデフォルト自動チェックアウト

デフォルトのエージェント側チェックアウトができない場合、TeamCity は対応するヘルスレポート項目を表示し、サーバー側チェックアウトを使用します。

一部のエージェントをアップグレードできません

このレポートは、アップグレードに失敗したエージェントを見つけるのに役立ちます。 ビルドエージェントログは、問題の原因を特定できます。

クラウドエージェント

ユーザーがプロファイルからイメージを除去すると、TeamCity によってすでに開始されたインスタンスは自動的に停止されないという警告が表示されます。

未使用のビルドエージェント

レポートは、3 日以上使用されていないエージェントについて表示されます。

• 環境内に 3 つ以上のエージェントがある

• エージェントが 3 日以上登録されている

• これらの 3 日間にビルドがサーバーで実行された場合