TeamCity 2020.1ヘルプ

サーバーの状態

The サーバーの状態 report contains results of the server inspection for any configuration issues which impact or could potentially impact the performance. Such issues, the so called server health items, are collectively reported by TeamCity on the サーバーの状態 page in the 管理 area.

The Project Administrator permissions at least are required to see the report.

範囲と重大度

The report enables you to define the analysis scope: you can select to analyze the global configuration or report on project-related items. The scope available to you depends on the level of the プロジェクトを見る permission granted to you. レポートはアーカイブされたプロジェクトでは使用できないことに注意してください。

The Server Health analysis also employs the severity rating, depending on the issue impact on the configuration of the system on the whole or an individual project.

可視性オプション

デフォルトでは、グローバル構成に関連する警告およびエラーレベルの結果は、TeamCityの各ページの上部だけでなくレポートページにも表示されます。

これらに加えて、一部のアイテムがインプレースで表示されます。課題の原因となっているオブジェクトに応じて、サーバーのヘルスアイテムがビルド構成、テンプレート、またはVCSルート設定ページで報告されます。

Only active items are displayed on the TeamCity pages. To remove an item from display, use the hide option next to an item on the report page. For global items, this option is available in every server health message.

非表示のアイテムはTeamCityページから削除され、サーバーヘルスページのアクティブなアイテムに表示されます。説明はグレー表示されます。

表示するアイテムを返すには、表示オプションを使用します。

可視性の変更は、管理エリアの監査ページにリストされます。

課題カテゴリ

管理者がTeamCityの全体的なステータスを簡単に監視できるように、ヘルスアイテムは幅広いサーバー機能をカバーしています。

グローバル構成アイテム

TeamCity displays a notification on the availability of the new TeamCity version and a prompt to upgrade.A warning is displayed if any of the licenses are incompatible with this new version. The notification is visible to system administrators only and they can use the link in the "Some Licenses are incompatible" message to quickly navigate to the ライセンス page, where all incompatible licenses will have a warning icon.

エージェント構成

エージェントが推奨Java 8を実行していない場合、TeamCityは通知を表示します。このレポートは、バージョン1.8より前のJavaで実行されているすべてのエージェントを表示します。

WebSocket接続の課題

WebSocketプロトコルは、イベントのWeb UIを更新し、ビルドの更新と統計カウンターを実行するために使用されます。

WebSocket接続の動作を妨げる問題が発生した場合、警告が表示されます。TeamCityは、レガシー更新モード(バージョン9.0より前のTeamCityで使用されていた通常のHTTPリクエストポーリング)に自動的に切り替わり、このモードでTeamCityを引き続き使用できます。

However, it is recommended to make the following adjustments to benefit from faster web UI updates as well as reduced unnecessary network traffic and latency:

  • プロキシー・サーバー構成

  • BIOコネクタの調整

プロキシー・サーバー構成

If a reverse proxy is used in front of the TeamCity server, it needs to be configured to support the WebSocket protocol.

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

BIOコネクタの調整

If Tomcat is configured to use the BIOコネクタ(英語) , the WebSocket protocol is automatically disabled(英語). It is recommended to change the Tomcat Connector settings to use the NIO connector.

クリティカル・エラー

このカテゴリには、次のエラーが表示されます。

  • プロジェクト構成ファイルのエラー-サーバーがディスクから構成ファイルをロードしている間に、何らかの不整合または破損した構成を検出した場合に発生する

  • errors raised by the disk space watcher

  • TeamCityサーバーメモリー・モニターからの警告

データベース関連の問題

サーバーが現在内部データベースを使用している場合、TeamCityは警告を出します。ストレージエンジンとしてスタンドアロンデータベースを推奨

TeamCityは外部データベースとしてSybaseをサポートしていませんとして、Sybaseを使用している場合、警告メッセージが表示されます。

ビルド構成アイテム

依存関係の問題

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

大きなビルドログを使用した構成

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

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

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

TeamCityは、多くの小さなアーティファクトファイルを公開するビルドを検出し、単一の .zip アーカイブとして公開することを提案します。

VCSルート関連の問題

未使用のVCSルート

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

同様のVCSルート

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

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

同様のVCSルートの使用箇所 (別名インスタンス)

You can define values for VCSルート settings or use parameter references to various parameters defined at different levels.

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

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

接続されていないVCSルートのトリガールール

VCSトリガーまたはスケジュールトリガーのルールが、ビルド構成に関連付けられていないVCSルートを参照している場合、TeamCityは警告を表示します。

冗長トリガー

このレポートは、ビルドトリガーが冗長な場合を示します。例:

  • ABの2つのビルド構成があります

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

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

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

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

有効な静寂期間が指定よりも大きい

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

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

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

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

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

VCSチェックアウト

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

This section of the report will show possible frequent clean checkout, which may be caused by the following two reasons:

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

Build configurations having different VCS設定 but the same custom checkout directory may lead to frequent clean checkouts, slowing down the performance and hindering the consistency of incremental sources updates.

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

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

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

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

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

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

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

統合関連アイテム

  • プロジェクトまたはビルド構成にセキュリティで保護されたパラメーターがあり、GitHubプルリクエストをビルドするように構成されている場合、このレポートは警告を発生させます。

  • VCSルートがGitHubまたはBitbucketを指している場合、対応する課題トラッカーを設定するための提案が表示されます。

エージェントのヘルス

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

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

クラウドエージェント

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

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

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

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

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

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

プロキシサーバーの構成が正しくありません

このレポートには、TeamCity Webインターフェースへのアクセスに使用されるプロキシサーバーの検出された設定ミスが表示されます。

See our recommendations how to set up a proxy server with TeamCity.

推奨設定

TeamCityは、ビルド構成の現在の設定を分析し、VCSトリガーの追加、ビルドステップなどの追加オプションを提案します。サーバーヘルスレポートに加えて、特定のビルド構成の提案が構成設定ページに表示されます。

拡張性

The default Server Health report provided by TeamCity might cover either too many, or not all the items required by you. Depending on your infrastructure, configuration, performance aspects, and so on. that you need to analyze, a custom Server Health report can be needed. TeamCity enables you to write a plugin(英語) which will report on specific items.

最終更新日: 2020年8月03日