This product is not supported for your selected
Datadog site. (
).
概要
Repositories ページ を使用すると、リポジトリ内のテスト傾向を把握したり、個々のコミットを調査して問題をデバッグしたりできます。
テスト パフォーマンスと傾向
Repositories ビュー では、各リポジトリのデフォルト ブランチに対するヘルス メトリクスが集計表示されます。このビューは、組織内のリポジトリ全体にわたるテスト パフォーマンスと傾向を俯瞰するのに役立ちます。
Repositories ページでできること:
- 各リポジトリに存在する不安定なテストの総数を確認する。
- テストの信頼性が時間の経過とともに高まっているか、それとも低下しているかを追跡する。
- 各リポジトリの最新コミットにおけるテスト ステータスを確認する。
- 各リポジトリに関連付けられている テスト サービスとは、プロジェクトやリポジトリに関連付けられたテストのグループのことです。テスト サービスには、コードに対する個々のテストがすべて含まれており、オプションでテスト スイートにまとめることもできます。テスト スイートは、テストのフォルダーのようなものです。Glossary の数を確認する。
自分がコミットしたリポジトリだけに絞り込むには、My Repositories を切り替え、GitHub アカウントに関連付けられているメール アドレスを入力します。複数のメール アドレスを入力できます。後からアドレスを変更する場合は、Edit Authors をクリックします。
リポジトリを調査する
リポジトリを選択すると、そのテスト パフォーマンスをより細かい粒度で確認できます。Branch、Test Service、Env のドロップダウンを使用して、目的のデータに絞り込んでください。ワイルドカード (*) フィルターを選ぶと、そのカテゴリ全体を集計したビューになります。
特定リポジトリのページでは、次の項目にアクセスできます:
- Latest Commit: 最新コミットのテスト ステータスとパフォーマンス。
- Commits: 最近のコミットと、それぞれのテスト統計の一覧。
- Test Services: リポジトリに追加したテスト サービスの概要。
- Flaky Tests: リポジトリ内の 不安定なテスト に関するインサイト。
- Test Regressions: テスト実行は、その所要時間がデフォルトブランチにおける同一テストの平均の 5 倍で、かつ同一テストの最大所要時間を上回る場合にリグレッションとしてマークされます。さらに、そのテスト実行がリグレッションと見なされるには、所要時間が 500 ミリ秒以上である必要があります。Glossary に関するインサイト。
- Test Performance: テストが時間の経過とともに高速化したか、または低速化したかを確認する。
- Common Error Types: リポジトリでよく発生するエラー種別を確認する。
- All Test Runs: リポジトリ内のすべてのテスト実行を探索する。
リポジトリ設定
Test Optimization settings ページでは、各リポジトリで有効になっている機能と、適用したオーバーライドの概要を確認できます。リポジトリを選択し、次の機能を設定してください:
テスト サービスのオーバーライド
固有の設定が必要なテスト サービスがある場合、デフォルトのリポジトリ設定をオーバーライドできます。
オーバーライドを作成する手順:
- Test Optimization settings ページで、テスト サービスを持つリポジトリを選択します。
- Edit Custom Settings をクリックします。
- オーバーライドを適用したいテスト サービスを選択し、展開して利用可能な設定を表示します。
- 目的の設定を切り替えます。
各リポジトリで有効になっているオーバーライド数は、settings ページから確認できます。
コミットのデバッグ
Branches ビュー を使用して、個々のコミットによって持ち込まれた問題を調査し、デバッグします。
Branches ビューのテーブルには、各ブランチの最新更新が表示されます。ブランチごとに、次の情報が含まれます:
- 関連するリポジトリ、ブランチ、テスト サービス、環境
- failed / new flaky / skipped / passed の各テスト数のカウンター
- リグレッション数のカウンター
- テスト実行の総時間
- ブランチが最後に更新された日時
自分がコミットしたブランチだけに絞り込むには、My Branches を切り替え、GitHub アカウントに関連付けられているメール アドレスを入力します。複数のメール アドレスを入力できます。後からアドレスを変更する場合は、Edit Authors をクリックします。
デバッグ
コミットをデバッグするには、ブランチを選択して Commit Overview ページを開きます。コミット概要には、そのコミットが導入されたプル リクエスト、変更されたファイル、テスト ステータス、テスト パフォーマンスなどの詳細が一覧表示されます。
このページから、次の項目にもアクセスできます:
- Failed Tests: 失敗したテストの一覧。テストを選択すると、詳細とトレースを確認できます。
- New Flaky Tests: コミットで新たに発生した不安定なテストの一覧。
- Test Regressions: コミットによって導入された テスト実行は、その所要時間がデフォルトブランチにおける同一テストの平均の 5 倍で、かつ同一テストの最大所要時間を上回る場合にリグレッションとしてマークされます。さらに、そのテスト実行がリグレッションと見なされるには、所要時間が 500 ミリ秒以上である必要があります。Glossary に関するインサイト。
- Test Performance: コミットがテスト パフォーマンスに与える影響を確認します。
- Related Pipeline Executions: 当該コミットの CI パイプライン実行を確認します。
- All Test Runs: 当該コミットのすべてのテスト実行を探索します。
参考資料
