次の方法で共有

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

  • [アーティクル]

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

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 のサポート

Note

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

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

前提条件

Azure DevOps Server 2019.1 以降の場合:

  • Azure DevOps Server を インストールして構成します。
  • プロジェクト コレクションを作成します。
  • アクセス許可: Analytics を有効、一時停止、無効化、または再開するには、コレクション レベルの情報の編集権限を持つ Project Collection Administrators グループのメンバーになります。

Azure DevOps Server 2019 の場合:

分析を有効化する

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

Note

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

  1. Web ブラウザーで、(1) プロジェクト コレクション、(2) コレクション設定または管理者設定、(3) 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. [分析の設定] ページで、[分析の再開] を選択します。

    分析を有効化する

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

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

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

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

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

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 拡張機能は、オンプレミスのインストーラー内に付属しています。 拡張機能をインストールすると、機能が有効になります。 拡張機能ファイルを手動でダウンロードしてインストールする必要はありません。

ヒント

Analytics 拡張機能は Azure DevOps Server のローカル ギャラリーに表示されるため、Azure DevOps Marketplace からダウンロードする必要はありません。

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

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

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

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

    Note

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

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

    分析拡張機能カード

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

既知の問題

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

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