Azure Logic Apps의 워크플로에서 Log Analytics 또는 Application Insights에 연결

적용 대상: Azure Logic Apps(사용량 + 표준)

참고 항목

Azure Monitor Logs 커넥터는 Azure Log Analytics 커넥터Azure Application Insights 커넥터를 대체합니다. 이 커넥터는 다른 커넥터와 동일한 기능을 제공하며 Log Analytics 작업 영역 또는 Application Insights 리소스에 대해 쿼리를 실행하는 기본 방법입니다. 예를 들어 Application Insights 리소스에 연결할 때 애플리케이션 ID 및 API 키를 만들거나 제공할 필요가 없습니다. 인증은 Microsoft Entra ID와 통합됩니다.

Azure Monitor의 Log Analytics 작업 영역 또는 Application Insights 애플리케이션에서 데이터를 검색하는 워크플로를 빌드하려면 Azure Monitor 로그 커넥터를 사용할 수 있습니다.

예를 들어, Office 365 Outlook 계정에서 메일 메시지로 Azure Monitor 로그 데이터를 전송하거나, Azure DevOps에서 버그를 만들거나, Slack 메시지를 게시하는 논리 앱 워크플로를 만들 수 있습니다. 이 커넥터는 작업만 제공하므로 워크플로를 시작하려면 되풀이 트리거를 사용하여 다른 서비스에서 간단한 일정 또는 트리거를 지정할 수 있습니다.

이 가이드에서는 Azure Monitor 로그 쿼리의 결과를 메일로 보내는 논리 앱 워크플로를 빌드하는 방법을 설명합니다.

커넥터 기술 참조

이 커넥터의 작업에 대한 기술 정보는 커넥터의 참조 설명서를 참조하세요.

다음 두 작업 모두 Log Analytics 작업 영역 또는 Application Insights 리소스에 대해 로그 쿼리를 실행할 수 있습니다. 차이점은 데이터가 반환되는 방식에 있습니다.

작업 설명
쿼리를 실행하고 결과를 나열 각 행을 자체 개체로 반환합니다. 나머지 워크플로에서 각 행을 별도로 작업하려는 경우 이 작업을 사용합니다. 일반적으로 이 작업 뒤에는 For each 작업이 옵니다.
쿼리를 실행하고 결과를 시각화 쿼리 결과 집합을 나타내는 JPG 파일을 반환합니다. 이 작업을 통해 예를 들어 결과를 이메일로 전송하여 나머지 워크플로에서 결과 집합을 사용할 수 있습니다. 쿼리가 결과를 반환하는 경우에만 작업이 JPG 파일을 반환합니다.

제한 사항

  • 커넥터에는 사용하는 쿼리 및 결과의 크기에 따라 워크플로가 도달할 수 있는 다음과 같은 제한이 있습니다.

    제한 주의
    최대 쿼리 응답 크기 ~16.7MB 또는 16MiB 커넥터 인프라는 크기 제한이 쿼리 API 제한보다 낮게 설정되도록 지시합니다.
    최대 레코드 수 500,000개 레코드
    최대 커넥터 제한 시간 110초
    최대 쿼리 제한 시간 100초

    이러한 제한에 도달하지 않도록 하려면 데이터를 집계하여 결과 크기를 줄이거나 더 작은 시간 범위에서 더 자주 실행되도록 워크플로 되풀이를 조정해 보세요. 그렇지만 캐싱 때문에 120초보다 짧은 간격으로 자주 쿼리하는 것은 권장되지 않습니다.

  • 로그 페이지와 커넥터에 대한 시각화에는 다른 차트 라이브러리가 사용됩니다. 따라서 커넥터에는 현재 일부 기능이 포함되어 있지 않습니다.

필수 조건

Azure Monitor 로그 작업 추가

  1. Azure Portal의 디자이너에서 표준 논리 앱과 워크플로를 엽니다.

  2. Azure Monitor 로그 작업을 추가하려는 워크플로에서 이 일반 단계에 따라 Azure Monitor 로그 작업을 추가합니다.

    이 예제에서는 쿼리 실행 및 결과 시각화라는 작업을 계속합니다.

  3. 연결 상자에서 다음 정보를 제공합니다.

    속성 설명
    연결 이름 연결의 이름
    인증 유형 연결에 사용할 인증 유형입니다. 자세한 내용은 아웃바운드 호출에 인증 추가를 참조하세요.
    테넌트 ID Microsoft Entra 테넌트. 참고: 현재 연결과 관련된 계정은 나중에 메일을 보내는 데 사용됩니다.
  4. 완료되면 선택한 인증 유형에 따라 로그인 또는 새로 만들기를 선택합니다.

  5. 쿼리 실행 및 결과 시각화 작업 상자에서 다음 정보를 제공합니다.

    속성 필요함 Description
    구독 <Azure-subscription> Log Analytics 작업 영역 또는 Application Insights 애플리케이션에 대한 Azure 구독
    리소스 그룹 <Azure-resource-group> Log Analytics 작업 영역 또는 Application Insights 애플리케이션에 대한 Azure 리소스 그룹
    리소스 종류 Log Analytics 작업 영역 또는 Application Insights 워크플로에서 연결할 리소스 종류. 이 예제에서는 Log Analytics 작업 영역을 선택하여 계속합니다.
    리소스 이름 <Azure-resource-name> Log Analytics 작업 영역 또는 Application Insights 리소스의 이름
  6. 쿼리 상자에 다음 Kusto 쿼리를 입력하여 다음 원본에서 지정된 로그 데이터를 검색합니다.

    참고 항목

    고유한 쿼리를 만들 경우 Azure Monitor 로그 작업에 추가하기 전에 Log Analytics에서 올바르게 작동하는지 확인합니다.

    • Log Analytics 작업 영역

      다음 예제 쿼리는 마지막 날 내에 발생한 오류를 선택하고, 총 수를 보고하고, 오름차순으로 정렬합니다.

      Event
      | where EventLevelName == "Error" 
      | where TimeGenerated > ago(1day)
      | summarize TotalErrors=count() by Computer
      | sort by Computer asc
      
    • Application Insights 리소스

      다음 예제에서 쿼리는 전날 실패한 요청을 선택하고 operation_Id 식별자에 따라 작업의 일부로 발생한 예외와의 상관 관계를 지정합니다. 그런 다음, 쿼리는 autocluster() 알고리즘을 사용하여 결과를 세그먼트화합니다.

      requests
      | where timestamp > ago(1d)
      | where success == "False"
      | project name, operation_Id
      | join ( exceptions
          | project problemId, outerMessage, operation_Id
      ) on operation_Id
      | evaluate autocluster()
      
  7. 시간 범위에 대해 쿼리에서 설정을 선택합니다.

    다음 표에서는 시간 범위에 대해 설명합니다.

    시간 범위 설명
    Exact 시작 시간과 종료 시간을 동적으로 제공합니다.
    상대 지난 1시간, 지난 12시간 등 상대 값을 설정합니다.
    쿼리에서 설정 TimeGenerated 필터가 쿼리에 포함될 때 적용됩니다.
  8. 차트 종류에 대해 HTML 테이블을 선택합니다.

  9. 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.

이메일 작업 추가

  1. Office 365 Outlook 작업을 추가하려는 워크플로에서 이 일반 단계에 따라 이메일 보내기(V2)라는 Office 365 Outlook 작업을 추가합니다.

  2. 받는 사람 상자에 받는 사람의 이메일 주소를 입력합니다. 이 예제에서는 사용자의 고유한 메일 주소를 사용합니다.

  3. 제목 상자에 메일의 제목(예: 일별 상위 오류 또는 실패를 입력합니다.

  4. 본문 상자 내부를 클릭한 다음, 워크플로의 이전 단계에서 출력을 선택할 수 있도록 동적 콘텐츠 옵션(번개 아이콘)을 선택합니다.

  5. 동적 콘텐츠 목록의 쿼리 실행 및 결과 시각화 아래에서 이전에 Log Analytics 작업에 입력한 쿼리 결과를 나타내는 본문을 선택합니다.

  6. 고급 매개 변수 목록에서 첨부 파일을 선택합니다.

    이제 메일 보내기 작업에는 첨부 파일 이름첨부 파일 콘텐츠 속성이 있는 첨부 파일 섹션이 포함됩니다.

  7. 추가된 속성의 경우 다음 단계를 수행합니다.

    1. 첨부 파일 이름 상자에서 동적 콘텐츠 목록을 엽니다. 쿼리 실행 및 결과 시각화에서 첨부 파일 이름을 선택합니다.

    2. 첨부 파일 콘텐츠 상자에서 동적 콘텐츠 목록을 엽니다. 쿼리 실행 및 결과 시각화에서 첨부 파일 콘텐츠를 선택합니다.

  8. 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.

워크플로 테스트

  1. 워크플로 메뉴에서 개요를 선택합니다.

  2. 개요 도구 모음에서 실행>실행을 선택합니다.

  3. 워크플로가 완료되면 메일을 검사합니다.

    참고 항목

    이 워크플로는 쿼리 결과 집합을 나타내는 JPG 파일이 포함된 메일을 생성합니다. 쿼리가 결과를 반환하지 않으면 워크플로에서 JPG 파일을 만들지 않습니다.

    Log Analytics 작업 영역 예제의 경우 받은 메일에는 다음 예제와 유사한 본문이 있습니다.

    Screenshot shows data report from a Log Analytics workspace in an example email.

    Application Insights 리소스의 경우 받은 메일에는 다음 예제와 유사한 본문이 있습니다.

    Screenshot shows data report from an Application Insights resource in an example email.

다음 단계