Azure DevOps で Analytics にアクセスするためのアクセス許可と前提条件
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Analytics を使用してレポートを作成するには、この記事の概要に示すように、いくつかの前提条件を満たす必要があります。
既定では、すべてのプロジェクト メンバーには、プロジェクト Readers グループに追加されたメンバーを含む、メンバーであるプロジェクトの Analytics データへのアクセス権が付与されます。 Stakeholder アクセス権を持つユーザーは、Analytics ビューを表示または編集するアクセス権を持っていません。
サービスと機能の有効化
一般に、Analytics は常にオンであり、組織またはコレクションのメンバーがデータを表示してレポートを作成できます。
Analytics サービス
Azure DevOps Services の場合、Analytics は常にオンになっています。 無効にしたり、一時停止したりすることはできません。
Azure DevOps Server 2020 以降のオンプレミス バージョンの場合、Analytics は、作成した各プロジェクト コレクションと共に自動的にインストールされます。
Azure DevOps Server 2019 の場合は、最初に作成する各プロジェクト コレクションに Analytics をインストールする必要があります。
サービスを一時停止して再起動できます。 一時停止すると、新しいデータは Analytics に追加されません。
詳細については、「 Analytics サービスのインストールまたは有効化を参照してください。
Azure DevOps Services
Azure DevOps サービスを実行するには、それを有効にする必要があります。 無効にされたサービスのデータはキャプチャできません。 サービスは、プロジェクトごとにプロジェクトで有効または無効にすることができます。
すべてのサービスが有効になっていることを確認するには、「 サービスを有効または無効にするを参照してください。
Analytics ビュー
Web ポータルのハブである分析ビューでは、分析データに基づいて Power BI レポートのフィルター条件を簡単に指定できます。 詳しくは、Analytics サービスに関する記事を参照してください。
Analytics ビューにアクセスするには有効にする必要があります。 組織の所有者またはプロジェクト コレクション管理者グループのメンバーは、組織内のすべてのユーザーに対して有効にすることができます。 または、各プロジェクト メンバーが自分で有効にすることができます。
方法については、「機能の 管理または有効化」を参照してください。
アクセス許可
プロジェクト レベル サービス と共有 Analytics ビュー オブジェクト レベルで設定します。
次の表は、設定できるアクセス許可と、プロジェクト セキュリティ グループに対する既定の割り当てをまとめたものです。
権限 | Readers | 共同作成者 | プロジェクト管理者 |
---|---|---|---|
分析の表示 | ✔️ | ✔️ | ✔️ |
共有 Analytics ビューを表示する | ✔️ | ✔️ | |
プライベートまたは共有の Analytics ビューを追加する | ✔️ | ✔️ | |
共有 Analytics ビューを編集および削除する | ✔️ |
データ追跡の前提条件
意味のあるデータをキャプチャするには、ソフトウェア チームが意味のあるアクションを実行する必要があります。 次のセクションでは、レポートするデータの種類に基づいて一般的な推奨事項を示します。
Note
ブランチ、パイプライン、およびテスト エンティティ セットは、Analytics v3.0-preview 以降のバージョンでサポートされています。 パイプライン ジョブ、タスク エージェント要求、タスク エージェント プール サイズをサポートするスナップショット エンティティ セットが、Analytics v4.0-preview バージョンで追加されました。 関心のあるエンティティ セットをサポートする Analytics バージョンを指定してください。
データをフィルター処理またはグループ化できるプロパティと列挙リスト値を理解するには、対応するエンティティ型の分析メタデータを展開します。
Azure Boards と作業の追跡
クエリを実行できる使用可能なエンティティ セットのレビューについては、「Azure Boards Analytics のMetadata リファレンスを参照してください。
作業の追跡をレポートするには、チームが複数のタスクを実行して、意味のあるデータを確実に利用できるようにする必要があります。 Analytics のクエリとレポートを定義する前に、次のタスクを確認してください。
- アクティブなバグやバグの傾向を報告するには、バグを定義し、バグ State を修正、検証、および閉じた状態で更新します。
- バックログ作業またはその他の作業項目の種類をレポートするには、それらの作業項目を定義し、 State が新規から終了に移行するときにその作業項目を更新してください。 レポート内のデータをフィルター処理またはグループ化するために使用するフィールドまたはタグを検討し、明確に定義され、一貫性があることを確認します。
- ロールアップ レポートをサポートするには、製品バックログ項目とタスク/バグの間に親子リンクが存在することを確認するか、機能またはポートフォリオ バックログ作業項目とその子項目の間に親子リンクが存在することを確認します。 詳細については、「 バックログを整理し、子作業項目を親にマップするを参照してください。
- バーンダウンレポートやバーンアップ レポート ( Sprint burndown や Release burndown など) を作成するにはレポート内のデータをフィルター処理してグループ化する方法を確認してください。 バーンダウン/バーンアップ レポートは、
WorkItemsSnapshot
エンティティ セットを参照します。 スナップショット エンティティ セットは、毎日のスナップショットとしてモデル化されます。 データは、割り当てられた日付の時点で行われた割り当てに基づいて集計されます。 つまり、フィールドまたはタグの割り当てに基づいてバーンダウン/バーンアップ レポートをフィルター処理するには、レポート対象の期間より前にフィールドまたはタグを割り当てる必要があります。 それ以外の場合、フィールド/タグは、適用日までレポートに登録されません。 - Requirements 追跡をサポートするにはテスト ケースを定義し、各テスト ケースからユーザー ストーリー、製品バックログ項目、または要件への Tested By リンクを作成します。 Tested By リンクを使用して、テスト ケースを定義し、テスト ケースを親 PBI にリンクします。 「テストを作成する」を参照してください。
- (推奨)レポート内でのフィルター処理とグループ化をサポートするには、すべての作業項目に Area Path と Iteration Path を割り当てます。 反復パスとエリア パスを定義する方法については、「 エリア パスを定義し、チームに割り当てる または Define イテレーション パス (スプリント)、およびチームイテレーションを構成するを参照してください。
Note
作業項目の種類に追加されたすべてのユーザー設定フィールドは、レポートで使用できます。 ユーザー設定フィールドには、表示名からすべてのスペースが削除された Custom_DisplayNameOfFieldラベルが付けられます。
テスト計画
テスト計画の進行状況とテスト ケースの準備状況を確認するには、チームが次のアクティビティを実行する必要があります。
- テスト ケース、テスト 計画、テスト スイートを定義し、現在の状態を指定します。 詳細については、「テスト 計画とテスト スイートの作成およびテスト ケースの作成を参照してください。
- テスト オブジェクトの State を、 Design から Ready から Closed に更新します。
- 手動テストの場合は、テスト ケースの各検証手順の結果を合格または失敗としてマークします。
ヒント
テスト 担当者は、テスト ステップが検証テスト ステップの場合、状態をマークする必要があります。 テストの全体的な結果には、マークされたすべてのテスト ステップの状態が反映されます。 そのため、テスト ステップが失敗としてマークされているか、マークされていない場合、テストの状態は失敗になります。
- 自動テストの場合、各テストは合格または失敗として自動的にマークされます。
- (推奨)レポート内でのフィルター処理とグループ化をサポートするには、テスト ケース、テスト スイート、テスト 計画に Area Path と Iteration Path を割り当てます。
Pipelines
パイプラインに関するレポートを作成するには、チームは YAML を使用してパイプラインを定義し、パイプラインを定期的に実行する必要があります。 詳細については、新しい Azure Pipelines ユーザーの キーの概念を参照してください。
さらに、次のアクションを検討してください。
- レポートするデータを検討し、適切なエンティティ セットを選択します。 クエリに使用できるエンティティ セットの確認については、Azure Pipelines Analytics の Metadata リファレンスを参照してください。
- レポートするパイプラインと、レポートの日付範囲を検討します。 クエリのベスト プラクティスを満たすようにデータをフィルター処理しパフォーマンスの問題を最小限に抑える必要があります。
パイプラインとテスト
パイプラインとテストの結果をレポートするには、必ずパイプライン定義にテスト タスクを追加してください。 詳細については、「 Build and release tasks-Test」を参照してください。
作業を開始したばかりの場合は、この Learn モジュールを確認することを検討してください。 Azure Pipelines を使用してビルド パイプラインで品質テストを実行します。