作業項目の統合

  • [アーティクル]

作業項目の統合機能を使用すると、関連する Application Insights データが埋め込まれている作業項目を GitHub または Azure DevOps で簡単に作成できます。

新しい作業項目の統合では、クラシックを介して次の機能が提供されます。

  • 担当者、プロジェクト、マイルストーンなどの高度なフィールド。
  • リポジトリ アイコンを使用した、GitHub & Azure DevOps ブックの区別。
  • 任意の数のリポジトリまたは作業項目に対する複数の構成。
  • Azure Resource Manager テンプレートによるデプロイ。
  • 事前定義された、カスタマイズ可能なキーワード クエリ言語 (KQL) クエリを使用して、作業項目に Application Insights データを追加します。
  • カスタマイズ可能なブック テンプレート。

作業項目テンプレートの作成と構成

  1. 作業項目テンプレートを作成するには、Application Insights リソースに移動し、左側の [構成] の下にある [作業項目] を選択してから、上部にある [テンプレートの新規作成] を選択します。

    Screenshot of the Work Items tab with create a new template selected.

    現在テンプレートが存在しない場合は、[end-to-end transaction details (エンド ツー エンド トランザクションの詳細)] タブから作業項目テンプレートを作成することもできます。 イベントを選択し、右側の [作業項目を作成する] 、 [ブック テンプレートから始める] の順に選択します。

    Screenshot of end-to-end transaction details tab with create a work item, start with a workbook template selected.

  2. [テンプレートの新規作成] を選択した後、追跡システムを選択し、ブックに名前を設定し、選択した追跡システムにリンクして、このテンプレートを格納するリージョンを選択できます (既定は Application Insights リソースがあるリージョンです)。 URL パラメーターは、 https://github.com/myusername/reponame や https://mydevops.visualstudio.com/myproject など、リポジトリの既定の URL です。

    Screenshot of create a new work item workbook template.

    テンプレート自体から、特定の作業項目のプロパティを直接設定できます。 これには、バージョン コントロール プロバイダーに基づき、担当者、イテレーション パス、プロジェクトなどが含まれます。

作業項目の作成

[Performance](パフォーマンス)、[Failures](障害)、[Availability](可用性)、その他のタブからアクセスできる [エンド ツー エンド トランザクションの詳細] で新しいテンプレートにアクセスできます。

  1. 作業項目を作成するには、[エンドツーエンドのトランザクションの詳細] に移動してイベントを選択し、 [作業項目の作成] を選択して、作業項目テンプレートを選択します。

    Screenshot of end to end transaction details tab with create work item selected.

  2. ブラウザーで新しいタブが開き、選択した追跡システムが表示されます。 Azure DevOps では、バグまたはタスクを作成できます。GitHub では、リポジトリに新しい問題を作成できます。 Application Insights によって提供されるコンテキスト情報を使用して、新しい作業項目が自動的に作成されます。

    Screenshot of automatically created GitHub issue

    Screenshot of automatically create bug in Azure DevOps.

テンプレートの編集

テンプレートを編集するには、 [構成] の下にある [作業項目] タブにアクセスし、更新するブックの横にある鉛筆アイコンを選択します。

Screenshot of work item tab with the edit pencil icon selected.

上部にある [編集] edit icon を選択して、テンプレートの編集を開始します。 作業項目テンプレートは Azure Monitor ブックに基づいています。 作業項目情報は、キーワード クエリ言語を使用して生成されます。 クエリを変更して、チームに必要なコンテキストをさらに追加できます。 編集が完了したら、上部のツールバーにある [保存] アイコン save icon を選択してブックを保存します。

Screenshot of the work item template workbook in edit mode.

複数の作業項目構成を作成し、各シナリオに合わせてカスタム ブックを作成できます。 また、環境全体で標準の実装を実現する Azure Resource Manager によって、ブックをデプロイすることもできます。

クラシック作業項目の統合

  1. [構成] の下の Application Insights リソースで、 [作業項目] を選択します。

  2. [Switch to Classic (クラシックに切り替え)] を選択し、フィールドに情報を入力して承認します。

    Screenshot of how to configure classic work items.

  3. [end-to-end transaction details (エンドツーエンドのトランザクションの詳細)] からイベントを選択し、 [Create work item (Classic) (作業項目の作成 (クラシック))] を選択して作業項目を作成します。

新しい作業項目の統合への移行

移行するには、従来の作業項目の構成を削除し、統合を再作成するために作業項目テンプレートを作成し構成します。

削除するには、Application Insights リソースの [構成] で [作業項目] を選択し、上部にある [Switch to Classic (クラシックに切り替え)] と、*[削除する] を選択します。

次のステップ

可用性テスト