작업 항목 통합을 사용하면 Application Insights 환경에서 직접 GitHub 또는 Azure DevOps에서 문제, 버그 또는 작업을 만들 수 있습니다. 템플릿에는 KQL(Kusto 쿼리 언어) 쿼리와 통합 문서 콘텐츠가 포함되어 있으므로 새 작업 항목에 관련 원격 분석이 포함됩니다.
작업 항목 템플릿은 Azure Monitor 통합 문서로, Microsoft.Insights/workbooks
리소스 유형으로 저장됩니다. 다른 통합 문서와 마찬가지로 이러한 통합 문서를 작성하고 자동화합니다.
작업 항목 통합에는 다음 기능이 포함됩니다.
- 템플릿이 리포지토리 아이콘을 사용하여 GitHub 또는 Azure DevOps 를 대상으로 하는지 여부를 나타냅니다.
- 여러 리포지토리 또는 작업 항목에 대해 여러 구성을 지원합니다.
- ARM(Azure Resource Manager) 템플릿을 사용하여 배포합니다.
- Application Insights 데이터를 작업 항목에 추가하는 미리 빌드되고 사용자 지정 가능한 KQL(Kusto Query Language) 쿼리를 포함합니다.
- 사용자 지정 가능한 통합 문서 템플릿을 제공합니다.
Permissions
작업 항목 템플릿을 만들거나 편집하려면 Microsoft.Insights/workbooks/write
또는 모니터링 참가자와 같은 Azure 역할을 사용합니다.
작업 항목 자체를 만들려면 대상 시스템(GitHub 또는 Azure DevOps)에 충분한 권한이 필요합니다. 항목은 포털에서 새 탭을 연 후 해당 시스템에서 만들어집니다.
작업 항목 템플릿 만들기 및 구성
- Application Insights 리소스를 엽니다. 구성에서 작업 항목을 열고 새 템플릿 만들기를 선택합니다.
- 또는 템플릿이 없는 경우 엔드 투 엔드 트랜잭션 세부 정보 에서 시작합니다. 이벤트를 선택하고 작업 항목 만들기를 선택한 다음 통합 문서 템플릿으로 시작을 선택합니다.
-
새 템플릿 만들기를 선택한 후 추적 시스템을 선택하고, 통합 문서의 이름을 지정하고, 추적 시스템에 연결하고, 템플릿 스토리지의 지역을 선택합니다. 기본 리포지토리 URL(예:
https://github.com/myusername/reponame
또는https://dev.azure.com/{org}/{project}
.)을 입력합니다. 선택한 지역은 저장된 통합 문서 리소스의 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의 컨텍스트가 포함됩니다.
템플릿 편집
- 구성에서 작업 항목을 연 다음 업데이트할 통합 문서 옆에 있는 연필 아이콘을 선택합니다.
- 맨 위의 도구 모음에서 편집을 선택합니다.
- 환경 간에 통합 문서 배포를 표준화하려면 ARM(Azure Resource Manager) 템플릿을 사용합니다. 다양한 시나리오에 대해 여러 구성을 만듭니다.
Troubleshooting
- 작업 항목 만들기는 엔드투엔드 트랜잭션 세부 정보에 표시되지 않습니다. 먼저 템플릿을 만들거나 작업 항목 만들기 흐름에서 통합 문서 템플릿으로 시작합니다.
- 온-프레미스 Azure DevOps URL이 거부됩니다. 호스트와 일치하려면 통합 문서의 리포지토리 URL 텍스트 매개 변수 및 유효성 검사 규칙(정규식)을 업데이트합니다.