DORA Metrics のデータ収集

This product is not supported for your selected Datadog site. ().

概要

DORA Metrics は、関連付けられているフィールドとタグを含むイベントを生成します。

イベントタイプ説明
デプロイメントenv、service、および version タグによって一意に識別される単一のコードデプロイメント。

デプロイメントは 失敗としてマーク でき、デプロイメントの頻度、変更失敗率、および失敗したデプロイメントの復旧時間の計算に使用されます。
プルリクエストデプロイメントに含まれるプルリクエスト。作成者、レビュアー、ラベル、およびドラフト作成、レビュー、マージにかかった時間などのメタデータが含まれます。コミットは、関連付けられているプルリクエスト内にネストされます。

プルリクエストは、コードレビューワークフローと PR レベルのサイクルタイムの分析に使用されます。
コミットデプロイメントに含まれる個別のコミットに対して生成されるイベント。メタデータが含まれており、対応するデプロイメントに自動的にリンクされます。コミットは、関連付けられているプルリクエスト内にネストされます。

コミットは、変更リードタイムの計算に使用されます。

注: DORA Metrics のイベントの保持期間は 2 年間です。

デフォルトのタグ

すべてのイベントには、利用可能な場合は以下のタグが含まれます。

  • service
  • team
  • env
  • version
  • source
  • repository_id

タグの使用に関する詳細については、タグの概要 を参照してください。

カスタムタグ

デプロイメントイベントは、DORA Metrics をフィルタリングするためにカスタムタグでエンリッチできます。これらのタグには 2 つの潜在的なソースがあります。

  • カタログ: デプロイメントイベントがカタログ内のサービスに関連付けられている場合、languageタグと サービス定義で定義されたカスタムタグ で自動的にエンリッチされます。
  • DORA Metrics API: ユーザーが提供する最大 100 個のカスタムタグを API のデプロイイベントに追加できます。

DORA Metrics でのカスタムタグの使用に関する詳細については、DORA Metrics の概要 を参照してください。

イベント固有のフィールド

デプロイメントフィールド

フィールド説明
Durationデプロイメントの期間。
Avg Change Lead Timeすべてのコミットの変更リードタイムの平均期間。
Avg Time to PR ReadyすべてのコミットのPR 準備完了までの所要時間の平均期間。
Avg Review Timeすべてのコミットのレビュー時間の平均期間。
Avg Merge Timeすべてのコミットのマージ時間の平均期間。
Avg Time to Deployすべてのコミットのデプロイまでの所要時間の平均期間。
Number of Commitsデプロイメントに含まれるすべてのコミットの数。
Deployment Typeデプロイメントのタイプ (standard、rollback、またはrollforward)。
Change Failureデプロイメントが変更失敗としてマークされているかどうかを示すブール値。
Recovery Time失敗したデプロイメントの finished_at からその修復の finished_at までの期間 (秒単位)。変更失敗としてマークされたデプロイメントでのみ利用可能です。
Remediation Type適用された修復のタイプ (rollbackまたはrollforward)。変更失敗としてマークされたデプロイメントでのみ利用可能です。

プルリクエストフィールド

フィールド説明
PR Cycle Time最初のコミットからマージまでの合計期間。
Time to PR Ready最初のコミットから PR がレビュー準備完了とマークされるまでの期間。
Review TimePR がレビュー準備完了とマークされてから承認されるまでの期間。
Merge TimePR が承認されてからマージされるまでの期間。
Time to Deployマージからデプロイメント開始までの期間。
Deploy Timeデプロイメント開始からデプロイメント終了までの期間。
Number of Commitsプルリクエストに含まれるコミットの数。
Number of Reviewersプルリクエストをレビューしたレビュアーの数。
Number of Files Changedプルリクエストで変更されたファイルの数。GitHub でのみ利用可能です。
Number of Lines Addedプルリクエストで追加された行の数。GitHub でのみ利用可能です。
Number of Lines Deletedプルリクエストで削除された行の数。GitHub でのみ利用可能です。
Total Number of Lines Changedプルリクエストで追加および削除された行の合計数。GitHub でのみ利用可能です。
Time to First Human Reviewプルリクエストが人間による最初のレビューを受けるまでの期間。GitHub でのみ利用可能です。
Number of Commentsプルリクエストに対するコメントの数。GitHub でのみ利用可能です。
Number of Human Commentsプルリクエストに対する人間によるコメント数。GitHub でのみ利用可能です。
Fully Automatedプルリクエストが人間の関与なしに作成およびマージされたかどうかを示すブール値。
Creator Bot Typeプルリクエストを作成したボットの種類。
Creator Bot Nameプルリクエストを作成したボットの名前。
Time CI Failingプルリクエスト内のすべてのコミットで CI が失敗状態であった合計期間。CI Visibility が必要です。
Test Session Durationプルリクエストのヘッドコミットまたはマージコミットのテストセッションの合計期間。Test Optimization が必要です。
Test Session Duration After Approvalプルリクエスト承認後のそのプルリクエストのヘッドコミットまたはマージコミットのテストセッションの合計期間。Test Optimization が必要です。
Time to Passプルリクエストのヘッドコミットまたはマージコミットに対する最初の CI 試行から最初のパイプライン実行成功までの期間。CI Visibility が必要です。
Time to Pass After Approvalプルリクエスト承認後の、プルリクエストのヘッドコミットまたはマージコミットに対する最初の CI 試行から最初のパイプライン実行成功までの期間。CI Visibility が必要です。
Patch Coverageプルリクエストのヘッドコミットまたはマージコミットにおいて、テストによってカバーされている新規または変更された行の割合。Code Coverage が必要です。

コミットフィールド

フィールド説明
Change Lead Timeコミットが本番環境に反映されるまでの所要期間。
Time to PR Readyコミット作成から PR がレビュー準備完了とマークされるまでの期間。
Review TimePR がレビュー準備完了とマークされてから承認されるまでの期間。
Merge TimePR が承認されてからマージされるまでの期間。
Time to Deployマージからデプロイメント開始までの期間。
Deploy Timeデプロイメント開始からデプロイメント終了までの期間。
Has Failed Jobsコミットに対して CI ジョブの実行が失敗したかどうかを示すブール値 (再試行後に成功した失敗も含む)。CI Visibility が必要です。
Has Failed Testsコミット内の非不安定テストが原因でテスト実行が失敗したかどうかを示すブール値。Test Optimization が必要です。
Has New Flaky Testsコミットのテストセッションで新しい不安定なテストが検出されたかどうかを示すブール値。Test Optimization が必要です。

参考資料

役立つドキュメント、リンク、記事:

DORA Metrics についてドキュメント more more DORA Metrics のデータソースのセットアップドキュメント more more メトリクスについてドキュメント more more タグの概要ドキュメント more more