Power BI Data Connector を使用して Analytics を接続する

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

Power BI Data Connector を使用して Power BI と Azure DevOps の間にシームレスな接続を確立する方法について説明します。 この統合により、Azure DevOps データから貴重な分析情報を抽出し、 分析ビューを使用して Power BI 内に説得力のあるレポートとダッシュボードを作成できます。

Power BI Data Connector では、Azure DevOps Analytics に直接接続できるため、次のタスクを実行できます。

• Power BI Desktop に分析ビューをインポートする
• リアルタイムの Azure DevOps データを使用してカスタム レポートを作成する
• 利害関係者向けの対話型ダッシュボードを構築する
• プロジェクトメトリックとチームのパフォーマンスを追跡する
• 作業項目の傾向とスプリントの進行状況を視覚化する

前提条件

Power BI を Azure DevOps Analytics に接続する前に、次の要件を満たしていることを確認してください。

Analytics ビューに接続する

Analytics ビューに接続するには、次の手順に従います。

1. Power BI Desktop を開きます。

2. サービスにサインインします。 初回アクセスでは、サインインして資格情報を認証する必要があります。 Power BI Desktop では資格情報が保存されるため、サインインする必要があるのは 1 回だけです。

   注

   Azure DevOps では、Open Authorization (OAuth) を使用するテナント間シナリオはサポートされていません。 代わりに、サービス プリンシパルとマネージド ID を使用。

3. [接続] を選択します。

   

4. [ データの取得>オンライン サービス] を選択し、クラウド サービスの 場合は Azure DevOps (Boards のみ) 、オンプレミス サーバーの場合は Azure DevOps Server (Boards のみ) を選択します。 [接続] を選択します。 分析ビューでは、作業項目とテスト ケースに対するクエリのみがサポートされます。

   

5. データに接続する基本的なパラメーターを指定します。

   

   

   • [コレクション URL: Azure DevOps Server インスタンスがホストされている URL を入力します。 URL の例が https://fabrikam-server/AzureDevOpsServer/fabrikam-collection。
   • チーム プロジェクト: プロジェクト名のみを入力します。 たとえば、Azure DevOps Server インスタンスの URL が場合はhttps://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber」と入力します。

   重要

   チーム名とプロジェクト名を混同しないでください。これはよくある間違いです。 たとえば、使用する URL が https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Deviceの場合、 Fabrikam-Fiber-Git はプロジェクト名、 Device はチーム名です。

   正常にサインインすると、Power BI は、指定されたプロジェクトにアクセスするために必要なアクセス許可が資格情報に付与されていることを確認します。 一般的な問題の解決策については、「 トラブルシューティング」を参照してください。

[分析] ビューを選択する

分析ビューを選択するには、次の手順に従います。

1. [ 共有ビュー] を展開します。 Data Connector には、使用可能な Analytics ビューの一覧が表示されます。 各ビューは、Power BI にプルできる一連のデータを表します。 カスタム Analytics ビューを作成することもできます。

   次の図は、既定の Analytics ビューを示しています。 ビューの一覧は、プロジェクトの作成に使用されるプロセス モデルによって異なる場合があります。 Today に追加されたビューを除く、一覧表示されているすべてのビューは、履歴傾向データを提供します。

   

2. [ 作業項目 - 過去 30 日間 ] ビューを選択し、プレビューが読み込まれるのを待ちます。 このビューでは、フィルターを使用して、プロジェクト内のすべての作業項目の過去 30 日間の履歴を表示します。

   注

   ビューを作成時に検証すると、ビューがロードされます。 ビューが読み込まれない場合は、データセットが大きすぎることが原因である可能性が最も高くなります。 Web ポータルの [Analytics ビュー ] ページに戻り、ビューを開いて編集します。 フィルターを調整して、データセットのサイズを小さくします。

   

   注

   • ナビゲーターで選択したビューに表示されるプレビューは、選択したフィールドの数とデータセットのサイズに応じて切り捨てられます。 データはプレビューでのみ切り捨てられ、完全なデータ更新には影響しません。
   • Analytics ビュー サーバーで Power BI を使用して定義されたフィルターは適用されません。 Power BI に適用されるすべてのフィルターは、エンド ユーザーに表示されるデータを制限しますが、Analytics から取得されるデータの量は減らしません。 フィルターがデータセットのサイズを小さくすることを目的としている場合は、ビューを カスタマイズして適用します。

3. [ ストーリー - 過去 30 日間 ] ビューの横にあるチェック ボックスをオンにし、[ 読み込み] を選択します。 データが読み込まれるのを待ちます。 テーブル名の下に表示されるステータス メッセージで進行状況を監視します。 一般的な問題の解決策については、「 トラブルシューティング」を参照してください。

   

4. データ モデルを確認します。 モデルの読み込み中に、Power BI Data Connector の dataset 設計を確認します。

レポートとダッシュボードを作成する

Analytics データを正常に読み込んだ後、さまざまなレポートと視覚化を作成できます。

レポート作成の概要

1. データを探索する: インポートされたフィールドを確認し、データ構造を理解する
2. 視覚化を計画する: 追跡する主要なメトリックと KPI を特定する
3. 初期レポートの作成: 単純なグラフから始めて、徐々に複雑さを増す
4. テストと反復: 関係者とレポートを検証し、必要に応じて調整します

一般的なレポートの種類

• 作業項目の傾向: 時間の経過に伴うバグ レポート、ユーザー ストーリー、機能の進行状況を追跡する
• スプリント バーンダウン グラフ: スプリントの進行状況とチームの速度を監視する
• チーム のパフォーマンス メトリック: スループット、サイクル時間、完了率を分析する
• バックログ分析: 作業の分布と優先順位の調整を視覚化する

詳細な例とテンプレートについては、「 Analytics ビューに基づくレポートの例」を参照してください。

ベスト プラクティス

Power BI と Analytics の統合を最大限に活用するには:

パフォーマンスの最適化

• 必要なデータのみを含むように Analytics ビューをフィルター処理する
• 適切な日付範囲を使用してデータ量を制限する
• 定期的にデータを更新するが、過剰な更新頻度を避ける
• レポートのニーズに合ったデータ更新スケジュールを検討する

レポートのデザイン

• 単純な作業を開始し、複雑さを徐々に追加する
• レポート間で一貫した書式設定とブランド化を使用する
• メトリックのコンテキストと説明を含める
• さまざまなユーザー ペルソナを使用してテストし、使いやすさを確認する

データ ガバナンス

• 分析ビューとその目的を文書化する
• データ更新ポリシーと所有権を確立する
• レポートの使用状況とパフォーマンスを監視する
• セキュリティとアクセス制御を維持する

トラブルシューティング

一般的なエラー シナリオ

クエリ結果が最大サイズを超えています

エラー メッセージ: "クエリ結果が最大サイズを超えています。 追加のフィルターを適用してレコードの数を減らす"

原因: Analytics ビューから返されるレコード数が 250,000 を超えています。

ソリューション：

1. Analytics ビューの時間範囲を減らす
2. 追加のフィルターを適用して作業項目の種類または状態を制限する
3. 1 つの大きなビューではなく、複数の小さいビューを使用する
4. より高いレベルでデータを集計することを検討する

アクセス拒否または認証エラー

エラー メッセージ: "ユーザーが承認されていません" または認証エラー

考えられる原因と解決策:

• プロジェクトのアクセス許可を確認する: Azure DevOps プロジェクトへのアクセス権があることを確認する
• 分析のアクセス許可を検証する: Analytics アクセス権があることを確認する
• 資格情報の確認: 管理者と連携して資格情報の問題を確認する
• Microsoft Entra 認証: アカウントが正しく構成されていることを確認する

Analytics アクセスは禁止されています

エラー メッセージ: "リソースへのアクセスは禁止されています"

解決策: プロジェクト管理者に問い合わせて 、分析の表示 アクセス許可を付与してください。 詳細については、 Analytics のセキュリティ に関するページを参照してください。

プロジェクトが見つかりません

エラー メッセージ: "Project 'X' が存在しないか、アクセス許可がありません"

一般的な原因:

• プロジェクト名が正しくありません:チーム名ではなく、プロジェクト名を使用していることを確認してください
• URL の混乱: https://dev.azure.com/fabrikam/MyProject/MyTeamの場合は、"MyTeam" ではなく "MyProject" を使用します
• アクセス許可がありません: 指定したプロジェクトへのアクセス権があることを確認します

エラー メッセージの読み取り

Power BI Data Connector の問題をトラブルシューティングするときは、次のタスクを実行します。

1. 根本原因を探す: エラー メッセージで [DataSource.Error] を 検索します
2. ラッパー テキストを無視する: コア エラーの説明に注目する
3. 推奨されるアクションを確認する: エラー メッセージには、多くの場合、解決手順が含まれます
4. 前提条件の確認: すべての要件が満たされていることを確認する

関連するコンテンツ

• Power BI の統合について
• Analytics ビューデータセットの設計について説明します
• Analytics ビューに基づいてレポートの例を生成する