サーバーの状態

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

メインノードは 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 ルートの変更間隔のチェックを減らす

頻繁なクリーンチェックアウト

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

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

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

ビルドファイルクリーナー（Swabra）の設定

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

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

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

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

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

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

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

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

クラウドエージェント

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

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

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

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

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

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