Share via

Analytics サービスをインストールまたは有効にする

  • [アーティクル]

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Azure DevOps Server 2020 以降のバージョンの場合、Analytics サービスは一般提供されています。 サーバーに追加されたすべての新しいプロジェクト コレクションに対して自動的に有効になります。 以前のバージョンからアップグレードされたプロジェクト コレクションの場合は、 手動で有効にする必要がある場合があります。 Analytics レポートを生成するプロジェクト コレクションごとに Analytics を有効にします。

Azure DevOps Server 2019 の分析はプレビュー段階です。 Azure DevOps Server 2019 では、Analytics を使用するプロジェクト コレクションごとに、ローカル マーケットプレースから Analytics 拡張機能をインストールします。 Azure DevOps Server 2019.1 では、Analytics を使用するプロジェクト コレクションごとに Analytics を有効にします。 Analytics でサポートされている

Note

Analytics Marketplace 拡張機能と Analytics は、TFS 2018 以前のバージョンでは サポートされていません 。

Analytics では、プロジェクト コレクションで定義されているすべてのプロジェクトの Analytics ウィジェットへのアクセスがサポートされています。 詳細については、「 Analytics とは」と「Analyticsに基づくウィジェット」を参照してください。 Analytics で使用できるデータは、「 Analytics から利用できるデータ」に要約されています。

前提条件

Azure DevOps Server 2019.1 の場合:

Azure DevOps Server 2019 の場合:

分析を有効にする

Azure DevOps Server 2019.1 にアップグレードした場合は、次の手順でプロジェクト コレクションに対して Analytics を有効にすることができます。 それ以外の場合は、Azure DevOps Server 2019 については、「Install Analytics」を参照してください。

Note

新しく作成されたすべてのプロジェクト コレクションに対して分析が自動的に有効になります。

  1. Web ブラウザーで、(1) プロジェクト コレクション、(2) コレクション設定または管理設定、および (3) Analytics を選択します。

    コレクション>管理設定>Analytics を開く

  2. [ 分析を有効にする] を選択します。

    分析を有効にする

    有効にすると、Analytics ステージング ジョブによって Analytics データ テーブルの設定が開始されます。 コレクションのサイズによっては、このプロセスに時間がかかる場合があります。 データ テーブルの詳細については、「 Analytics データ モデル」を参照してください。

Analytics を一時停止または無効にする

Azure DevOps Server 2019.1 にアップグレードした場合は、次の手順でプロジェクト コレクションの Analytics を一時停止または無効にすることができます。 それ以外の場合、Azure DevOps Server 2019 の場合、同等のアクションは Analytics 拡張機能を無効にするかアンインストールすることです。

一時停止または無効化できるのは、以前に有効にした Analytics のみです。

  1. [分析設定] ページ で 、[ 分析の一時停止 ] または [分析の無効化] を選択します。

    分析を一時停止または無効にする

  2. サービスを一時停止または無効にすることを確認します。

    [一時停止] ダイアログを確認します。無効の確認

Resume Analytics

Azure DevOps Server 2019.1 では、プロジェクト コレクションに対して一時停止した後に Analytics を再開できます。 サービスを再開すると、ステージング ジョブが再度有効になります。これにより、データ テーブルが更新され、一時停止後に更新されて最新の状態になります。

  1. [分析の設定] ページ で 、[ Resume Analytics]\(分析の再開\) を選択します。

    分析を有効にする

  2. サービスを再開することを確認します。

    [再開の確認] ダイアログ。

    有効にすると、Analytics ステージング ジョブによって Analytics データ テーブルの設定が開始されます。 コレクションのサイズによっては、このプロセスに時間がかかる場合があります。

Analytics を一時停止または無効にするとどうなりますか?

Analytics 拡張機能 (2019) を一時停止または無効化すると、次の機能が無効になります。

Analytics を一時停止すると、データは保持されますが、ステージング ジョブによるデータの更新は停止されます。 後でサービスを再開すると、データが更新されます。

Analytics を無効にするか、Analytics 拡張機能 (2019) を削除すると、すべての Analytics ステージング ジョブがオフになり、Analytics テーブルに格納されている Analytics データが削除されます。 過去の傾向をキャプチャするすべての分析データが失われます。 コレクションに格納されている他のデータは削除されません。 この操作を元に戻すことはできません。 履歴データとトレンド データが削除されると、復元することはできません。 Analytics を再度有効にしても、履歴データは復元されません。

分析を無効または削除すると、次のアクションが発生します。

  • ステージング ジョブは実行されません。また、Analytics テーブルには更新された情報はありません。
  • テーブル データは削除され、Analytics が再び有効になっている場合は、すべてのデータを最初から再設定する必要があります。

Note

Azure DevOps Server 2019.1 で Analytics を無効にすることは、Azure DevOps Server 2019 の Analytics 拡張機能をアンインストールするのと同じです。

データ テーブルの詳細については、「 Analytics データ モデル」を参照してください。

Analytics 拡張機能をインストールする

Azure DevOps Server 2019.1 にアップグレードしていない場合は、Analytics 拡張機能をインストールして、プロジェクト コレクションの Analytics ウィジェットとレポートにアクセスできます。 Analytics 拡張機能は、オンプレミスのインストーラー内に出荷されます。 拡張機能をインストールすると、機能が有効になります。 拡張機能ファイルを手動でダウンロードしてインストールする必要はありません。

ヒント

分析拡張機能は、Azure DevOps Marketplace からダウンロードする必要がないように、Azure DevOps Serverのローカル ギャラリーに表示されます。

  1. Web ブラウザーで、(1) プロジェクト コレクション、(2) 管理設定、および (3) [拡張機能] を選択します。

    コレクション>管理設定>拡張機能を開く

  2. [ ローカル拡張機能の参照] を選択します。

    ローカル マーケットプレースを参照する

    Note

    ローカル マーケットプレースからの拡張機能のインストールは、ホストされているマーケットプレースからのインストールと同じです。 唯一の違いは、ホストされているマーケットプレースに拡張機能の評価とユーザー コメントが表示されていることです。

  3. ローカル Marketplace が新しいブラウザー タブで開きます。[Analytics 拡張機能] カードを選択します。

    Analytics 拡張機能のカード

  4. [Get it free](無料で入手) を選択します。

    Analytics Marketplace 拡張機能のスクリーンショット。[無料で入手] を選択します。

  5. プロジェクト コレクションを選択し、[インストール] を選択 します。

    プロジェクト コレクションを選択する

  6. インストールが完了すると、次のようなイメージが表示されます。 [ コレクションに進む] を 選択して、コレクションの Web ポータルに戻ります。

    Analytics Marketplace 拡張機能がインストールされている [コレクションに進む] のスクリーンショット。

    必要に応じて、Analytics 拡張機能を他のプロジェクト コレクションにインストールする場合は、ブラウザーの [戻る] ボタンを選択します。

Analytics 拡張機能を無効またはアンインストールする

Analytics 拡張機能を無効にすることを選択すると、ジョブの実行が停止されます。 分析データは同期されなくなり、関連する機能は使用できなくなります。 ただし、データは削除されません。 Analytics 拡張機能をアンインストールすると、Analytics データベース テーブルからデータが削除されます。 拡張機能を再インストールすると、データは最初から再入力されます。

  1. 拡張機能メニューを開き、[ 拡張機能の管理] を選択します。

    [拡張機能の管理] タブのスクリーンショット。

  2. [ 管理 ] タブで、拡張機能のショートカット メニューを開きます。

  3. 必要 に応じて、[無効にする] または [アンインストール ] を選択します。

デプロイから削除された場合に Analytics 拡張機能を復元する

デプロイから Analytics 拡張機能を削除した場合は、オンライン マーケットプレースから拡張機能をインストールして復元できます。 サーバーのセットアップにより、オンライン マーケットプレースを使用できない場合があります。 たとえば、ファイアウォールによって一部の送信接続がブロックされる場合があります。 その場合でも、次の手順を使用してローカル マーケットプレースに復元できます。

  1. 「Analytics 拡張機能をインストールする」セクションに記載されている手順に従って、コレクション設定を開きます。

    [ 拡張機能] を選択し、[ ローカル拡張機能の参照] を選択します。

  2. ページの下部までスクロールし、[ 拡張機能の管理] を選択します。

    拡張機能の管理

  3. [ 拡張機能のアップロード ] を選択し、[ クリックしてアップロードする] を選択します。 Microsoft.TeamFoundation.Extension.Analytics.vsix ファイルを含むフォルダーを参照します。

    拡張機能のアップロード

    .vsix ファイルは、次のパスにあるアプリケーション層フォルダーのインストールにあります。

    C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsix

    拡張機能をアップロードすると、ローカル マーケットプレースに復元されます。 そこから、コレクションにインストールできます。

サーバーが切断されているかどうかを確認する方法

サーバーがインターネットから切断されている場合は、ローカル マーケットプレースから Analytics をインストールする必要があります。

Azure DevOps Serverが切断状態であるかどうかを判断できます。 ホストされているマーケットプレースを参照するときに、接続されているアイコンとサーバー名が上部に表示されるかどうかを確認します。

サーバーが接続されているかどうかを判断する

オンプレミス サーバーから Marketplace に移動すると、接続していない場合はエラーが表示されません。 クラウド サービス コンテキストに切り替わるだけです。

既知の問題

たとえば、パブリック URL を使用して拡張機能をインストールすると、 https://OnPrem.MyCompany.comTLS/SSL エラーなどのコールバック エラーが発生する可能性があります。

この問題を解決するには、アプリケーション層をホストするマシンから拡張機能をインストールし、ローカル コンピューターの URL (例: https://myMachineName) をポイントします。