作業項目の統合を使用すると、Application Insights エクスペリエンスから直接、GitHub または Azure DevOps で問題、バグ、またはタスクを作成できます。 テンプレートには Kusto クエリ言語 (KQL) クエリと ブック コンテンツが埋め込まれているため、新しい作業項目には関連するテレメトリが含まれます。
作業項目テンプレートは、としてMicrosoft.Insights/workbooksに保存されたものです。 これらのワークブックの内容を書いて、自動化する作業は他のブックの場合と同様です。
作業項目の統合には、次の機能が含まれています。
- リポジトリ アイコンを使用して、テンプレートが GitHub または Azure DevOps を対象にしているかどうかを示します。
- 任意の数のリポジトリまたは作業項目に対して複数の構成をサポートします。
- Azure Resource Manager (ARM) テンプレートを使用してデプロイします。
- Application Insights データを作業項目に追加する、事前構築済みのカスタマイズ可能な Kusto クエリ言語 (KQL) クエリを含めます。
- カスタマイズ可能な ワークブック テンプレートを提供します。
Permissions
作業項目テンプレートを作成または編集するには、Microsoft.Insights/workbooks/writeや監視共同作成者などので Azure ロールを使用します。
作業項目自体を作成するには、ターゲット システム (GitHub または Azure DevOps) で十分なアクセス許可が必要です。 この項目は、ポータルで新しいタブが開いた後に、そのシステムに作成されます。
作業項目テンプレートを作成して構成する
- Application Insights リソースを開きます。 [ 構成] で 作業項目を開き、[ 新しいテンプレートの作成] を選択します。
- または、テンプレートが存在しない場合 は、エンドツーエンドのトランザクションの詳細 から開始します。 イベントを選択し、[ 作業項目の作成] を選択し、[ ブック テンプレートで開始] を選択します。
- [ 新しいテンプレートの作成] を選択した後、追跡システムを選択し、ブックに名前を付け、追跡システムにリンクして、テンプレート ストレージのリージョンを選択します。
https://github.com/myusername/reponameやhttps://dev.azure.com/{org}/{project}など、既定のリポジトリ URL を入力します。 選択したリージョンは、保存されたブック リソースの Azure の場所です。 Application Insights データの格納場所やクエリ先は変更されません。 - テンプレートで既定の作業項目プロパティを設定します。 プロパティには、担当者、イテレーション パス、プロジェクトが含まれます。 使用できるプロパティは、追跡システムによって異なります。
注
オンプレミスの Azure DevOps 環境では、テンプレートの作成時に https://dev.azure.com/test/test などのプレースホルダー URL を使用します。 作成後、生成された Azure ブックを開き、リポジトリの URL テキスト パラメーターを編集し、Azure DevOps Server ホストに一致する検証規則 (正規表現) を追加します (例: ^https://devops\.contoso\.corp/.*$)。
作業項目の作成
[パフォーマンス]、[エラー]、[可用性]、およびその他のタブから入手できる、エンドツーエンドのトランザクションの詳細のテンプレートを使用します。
注
初めて [作業項目の作成] を選択すると、Application Insights を Azure DevOps の組織とプロジェクトにリンクするように求められます。
- エンドツーエンドのトランザクションの詳細を開き、イベントを選択して、[作業項目の作成] を選択します。
- テンプレートを選択します。 テンプレートが存在しない場合は、[ ブック テンプレートで開始] を選択して作成します。
- [ 新しい作業項目] ウィンドウに入力します。 Application Insights では、選択したイベントのコンテキスト データ (例外の詳細、操作名、トランザクションへのリンクなど) が事前に設定されます。 必要な追加情報を追加し、保存します。
- 追跡システムに新しいブラウザー タブが開きます。 Azure DevOps で、バグまたはタスクを作成します。 GitHub で、リポジトリに問題を作成します。 作業項目には、Application Insights のコンテキストが含まれます。
テンプレートを編集する
- [構成] の [作業項目] を開き、更新するブックの横にある鉛筆アイコンを選択します。
- 上部のツール バーの [編集] を選択します。
- 環境間でのブックのデプロイを標準化するには、 Azure Resource Manager (ARM) テンプレートを使用します。 さまざまなシナリオに対して複数の構成を作成します。
トラブルシューティング
専用のトラブルシューティングに関する記事をご覧ください。