다음을 통해 공유


작업 항목 통합

작업 항목 통합을 사용하면 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)에 충분한 권한이 필요합니다. 항목은 포털에서 새 탭을 연 후 해당 시스템에서 만들어집니다.

작업 항목 템플릿 만들기 및 구성

  1. Application Insights 리소스를 엽니다. 구성에서 작업 항목을 열고 새 템플릿 만들기를 선택합니다.
  2. 또는 템플릿이 없는 경우 엔드 투 엔드 트랜잭션 세부 정보 에서 시작합니다. 이벤트를 선택하고 작업 항목 만들기를 선택한 다음 통합 문서 템플릿으로 시작을 선택합니다.
  3. 새 템플릿 만들기를 선택한 후 추적 시스템을 선택하고, 통합 문서의 이름을 지정하고, 추적 시스템에 연결하고, 템플릿 스토리지의 지역을 선택합니다. 기본 리포지토리 URL(예: https://github.com/myusername/reponame 또는 https://dev.azure.com/{org}/{project}.)을 입력합니다. 선택한 지역은 저장된 통합 문서 리소스의 Azure 위치입니다. Application Insights 데이터가 저장되거나 쿼리되는 위치는 변경되지 않습니다.
  4. 템플릿에서 기본 작업 항목 속성을 설정합니다. 속성에는 담당자, 반복 경로, 프로젝트가 포함됩니다. 사용 가능한 속성은 추적 시스템에 따라 달라집니다.

비고

온-프레미스 Azure DevOps 환경의 경우 템플릿을 만들 때와 같은 https://dev.azure.com/test/test 자리 표시자 URL을 사용합니다. 만든 후 생성된 Azure 통합 문서를 열고, 리포지토리 URL 텍스트 매개 변수를 편집하고, Azure DevOps Server 호스트와 일치하는 유효성 검사 규칙(정규식)을 추가합니다 ^https://devops\.contoso\.corp/.*$.

작업 항목 만들기

성능, 실패,가용성 및 기타 탭에서 사용할 수 있는 엔드 투 엔드 트랜잭션 세부 정보의 템플릿을 사용합니다.

비고

작업 항목 만들기를 처음 선택하면 Application Insights를 Azure DevOps 조직 및 프로젝트에 연결하라는 메시지가 표시됩니다.

작업 항목을 만드는 단추가 있는 엔드투엔드 트랜잭션 세부 정보 보기의 스크린샷.

  1. 엔드투엔드 트랜잭션 세부 정보를 열고 이벤트를 선택한 다음 작업 항목 만들기를 선택합니다.
  2. 템플릿을 선택합니다. 템플릿이 없는 경우 통합 문서 템플릿으로 시작을 선택하여 템플릿을 만듭니다.
  3. 새 작업 항목 창을 완료합니다. Application Insights는 선택한 이벤트(예: 예외 세부 정보, 작업 이름 및 트랜잭션에 대한 링크)의 컨텍스트 데이터를 미리 채웁니다. 필요한 추가 정보를 추가한 다음 저장합니다.
  4. 추적 시스템에서 새 브라우저 탭이 열립니다. Azure DevOps에서 버그 또는 작업을 만듭니다. GitHub에서 리포지토리에서 문제를 만듭니다. 작업 항목에는 Application Insights의 컨텍스트가 포함됩니다.

템플릿 편집

  1. 구성에서 작업 항목을 연 다음 업데이트할 통합 문서 옆에 있는 연필 아이콘을 선택합니다.
  2. 맨 위의 도구 모음에서 편집을 선택합니다.
  3. 환경 간에 통합 문서 배포를 표준화하려면 ARM(Azure Resource Manager) 템플릿을 사용합니다. 다양한 시나리오에 대해 여러 구성을 만듭니다.

Troubleshooting

  • 작업 항목 만들기엔드투엔드 트랜잭션 세부 정보에 표시되지 않습니다. 먼저 템플릿을 만들거나 작업 항목 만들기 흐름에서 통합 문서 템플릿으로 시작합니다.
  • 온-프레미스 Azure DevOps URL이 거부됩니다. 호스트와 일치하려면 통합 문서의 리포지토리 URL 텍스트 매개 변수 및 유효성 검사 규칙(정규식)을 업데이트합니다.