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

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

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

Azure DevOps Server 2019 の場合:

• Azure DevOps Server を インストールして構成します。
• プロジェクト コレクションを作成します。
• アクセス許可:
  • コレクション レベルの情報の編集権限を持つ Project Collection Administrators グループのメンバーである。 アクセス許可がない場合は、代わりに拡張機能を要求できます。
  • 拡張機能をアップロードするには、インスタンス レベルの情報の編集アクセス許可を持つ Azure DevOps Server Administrators グループのメンバーになります。

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

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

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

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

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

1. Web ブラウザーで、(1) プロジェクト コレクション、(2) 管理者設定、(3) 拡張機能の順に選択します。

   

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

   

   Note

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

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

   

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

   

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

   

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

   

   必要に応じて、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 に移動すると、接続していない場合はエラーが表示されません。 クラウド サービス コンテキストに切り替わるだけです。

既知の問題

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

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