다음을 통해 공유


Azure Logic Apps에서 워크플로에 대한 진단 데이터 모니터링 및 수집

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

Azure Logic Apps에서 워크플로를 디버깅하고 진단하기 위한 좀 더 풍부한 데이터를 얻으려면 트리거 이벤트, 실행 이벤트 및 작업 이벤트와 같은 워크플로 런타임 데이터 및 이벤트를 로깅한 후 Log Analytics 작업 영역, Azure Storage 계정, Azure 이벤트 허브, 다른 파트너 대상 또는 Azure Monitor 로그를 설정 및 사용하는 이러한 모든 대상으로 보낼 수 있습니다.

참고 항목

Azure Monitor 리소스 로그는 100% 무손실이 아닙니다. 리소스 로그는 하루에 페타바이트 규모의 데이터를 저렴하게 이동하도록 설계된 저장소 및 전달 아키텍처를 기준으로 합니다. 이 기능에는 플랫폼 전체의 기본 제공 중복성 및 재시도가 포함되지만 트랜잭션 보장은 제공하지 않습니다. 트랜잭션 모니터링은 모니터링되는 서비스의 안정성과 성능을 저하시킬 수 있습니다. 또한 일시적인 로깅 오류는 로그 배달을 확인할 수 없는 경우 업스트림 서비스를 중지해야 합니다. Azure Monitor 팀이 지속적인 데이터 손실 원본을 확인할 수 있을 때마다 팀은 해결 및 방지를 가장 우선적으로 고려합니다. 그러나 Azure에 분산된 일시적이고 반복되지 않는 서비스 문제로 인해 작은 데이터 손실이 여전히 발생할 수 있으며 모든 문제를 잡아낼 수 있는 것은 아닙니다.

이 방법 가이드에서는 사용량 또는 표준 논리 앱 리소스 중 어떤 리소스를 사용하는지에 따라 다음 작업을 완료하는 방법을 보여 줍니다.

필수 조건

Log Analytics 사용

사용량 논리 앱의 경우 먼저 Log Analytics를 사용하도록 설정해야 합니다.

논리 앱 생성 시 Log Analytics를 사용하도록 설정

  1. Azure Portal논리 앱 만들기 창에서 다음 단계를 수행합니다.

    1. 플랜에서 사용량 워크플로에 대한 옵션만 표시되도록 사용량을 선택해야 합니다.

    2. Log Analytics 사용에서 를 선택합니다.

    3. Log Analytics 작업 영역 목록에서 워크플로 실행의 데이터를 보내려는 작업 영역을 선택합니다.

      Azure Portal 및 사용량 논리 앱 만들기 페이지를 보여 주는 스크린샷

  2. 논리 앱 리소스 만들기를 완료합니다.

    완료되면 논리 앱이 Log Analytics 작업 영역과 연결됩니다. 이 단계에서 작업 영역에 Logic Apps 관리 솔루션이 자동으로 설치됩니다.

  3. 워크플로를 실행한 후 워크플로 실행 상태를 확인합니다.

Logic Apps 관리 솔루션 설치

논리 앱 리소스를 만들 때 Log Analytics를 켰으면 이 섹션을 건너뜁니다. Log Analytics 작업 영역에 Logic Apps 관리 솔루션이 이미 설치되어 있습니다. 그렇지 않으면 기존 사용량 논리 앱에 대해 다음 단계를 계속 진행합니다.

  1. Azure Portal 검색 상자에서 Log Analytics 작업 영역을 입력한 다음, 결과에서 Log Analytics 작업 영역을 선택합니다.

    Log Analytics 작업 영역이 선택된 Azure Portal 검색 상자를 보여 주는 스크린샷

  2. Log Analytics 작업 영역 아래에서 작업 영역을 선택합니다.

    Azure Portal, Log Analytics 작업 영역 목록 및 선택한 특정 작업 영역을 보여 주는 스크린샷

  3. 개요 창의 Log Analytics 시작>모니터링 솔루션 구성에서 솔루션 보기를 선택합니다.

    Azure Portal, 작업 영역의 개요 페이지 및 선택한 솔루션 보기를 보여 주는 스크린샷

  4. 개요에서 추가를 선택하여 작업 영역에 새 솔루션을 추가합니다.

  5. Marketplace 페이지가 열리면 검색 상자에 Logic Apps 관리를 입력하고 Logic Apps 관리를 선택합니다.

    Azure Portal, 'Logic Apps 관리'가 입력되고 'Logic Apps 관리'가 선택된 Marketplace 페이지 검색 상자를 보여 주는 스크린샷

  6. Logic Apps 관리 타일의 만들기 목록에서 Logic Apps 관리를 선택합니다.

    Azure Portal, Marketplace 페이지에서 만들기 목록이 열리고 Logic Apps 관리(미리 보기)가 선택된 'Logic Apps 관리' 타일을 보여 주는 스크린샷

  7. Logic Apps 관리(미리 보기) 솔루션 만들기 창에서 솔루션을 설치할 Log Analytics 작업 영역을 선택합니다. 검토 + 만들기를 선택하고 정보를 검토한 다음 만들기를 선택합니다.

    Azure Portal, Logic Apps 관리 만들기(미리 보기) 솔루션 페이지 및 작업 영역 정보를 보여 주는 스크린샷

    Azure에서 Log Analytics 작업 영역이 포함된 Azure 리소스 그룹에 솔루션을 배포하면 솔루션이 개요 아래의 작업 영역 요약 창에 나타납니다.

    Azure Portal, Logic Apps 관리 솔루션이 있는 작업 영역 요약 창을 보여 주는 스크린샷

진단 설정 추가

  1. Azure Portal에서 소비 논리 앱 리소스를 엽니다.

  2. 논리 앱 리소스 메뉴의 모니터링 아래에서 진단 설정을 선택합니다. 진단 설정 페이지에서 진단 설정 추가를 선택합니다.

    Azure Portal, '진단 설정'이 선택되고 '진단 설정 추가'가 선택된 사용량 논리 앱 리소스 메뉴를 보여 주는 스크린샷

  3. 진단 설정 이름의 경우 원하는 설정 이름을 입력합니다.

  4. 로그>범주에서 워크플로 런타임 진단 이벤트를 선택합니다. 메트릭에서 AllMetrics를 선택합니다.

  5. 대상 세부 정보에서 로그를 보낼 위치에 따라 하나 이상의 대상을 선택합니다.

    대상 방향
    Log Analytics 작업 영역으로 보내기 Log Analytics 작업 영역에 대한 Azure 구독 및 작업 영역을 선택합니다.
    스토리지 계정에 보관 Azure Storage 계정에 대한 Azure 구독을 선택하고 스토리지 계정을 선택합니다. 자세한 내용은 Azure Storage 및 Azure Event Hubs에 진단 데이터 보내기를 참조하세요.
    이벤트 허브로 스트림 이벤트 허브 네임스페이스에 대한 Azure 구독, 이벤트 허브 및 이벤트 허브 정책 이름을 선택합니다. 자세한 내용은 Azure Storage 및 Azure Event Hubs로 진단 데이터 보내기Azure Monitor 파트너 통합을 참조하세요.
    파트너 솔루션으로 보내기 Azure 구독 및 대상을 선택합니다. 자세한 내용은 Azure Native ISV Services 개요를 참조하세요.

    다음 예제에서는 대상으로 Log Analytics 작업 영역을 선택합니다.

    Azure Portal, Log Analytics 작업 영역 및 수집할 데이터를 보여 주는 스크린샷

  6. 진단 설정 추가를 완료하려면 저장을 선택합니다.

워크플로 실행 상태 확인

워크플로를 실행한 후 Log Analytics 작업 영역에서 이러한 실행에 대한 데이터를 볼 수 있습니다.

  1. Azure Portal에서 Log Analytics 작업 영역을 엽니다.

  2. 작업 영역 메뉴의 클래식에서 작업 영역 요약을 선택합니다. 개요 페이지에서 Logic Apps 관리를 선택합니다.

    참고 항목

    Logic Apps 관리 타일이 실행 후에 즉시 결과를 표시하지 않는 경우 새로 고침을 선택하거나 잠시 기다린 후 다시 시도하세요.

    Azure Portal, 사용량 논리 앱 워크플로 실행 상태 및 개수가 포함된 Log Analytics 작업 영역을 보여 주는 스크린샷

    요약 페이지에는 이름 또는 실행 상태 따라 그룹화된 워크플로가 표시됩니다. 이 페이지는 워크플로 실행에 대한 작업 또는 트리거의 오류에 대한 세부 정보도 표시합니다.

    사용량 논리 앱 워크플로 실행에 대한 상태 요약을 보여 주는 스크린샷

  3. 특정 워크플로 또는 상태에 대한 모든 실행을 보려면 해당 워크플로 또는 상태에 대한 행을 선택합니다.

    이 예제에서는 특정 워크플로에 대한 모든 실행을 보여 줍니다.

    특정 사용량 논리 앱 워크플로의 실행 및 상태를 보여 주는 스크린샷

    추적된 속성을 추가한 작업의 경우 열 필터를 사용하여 추적된 속성을 검색할 수 있습니다. 속성을 보려면 추적된 속성 열에서 보기를 선택합니다.

    특정 사용량 논리 앱 워크플로의 실행 및 상태를 보여 주는 스크린샷

  4. 결과를 필터링하기 위해 클라이언트와 서버 쪽 필터링을 모두 수행할 수 있습니다.

    • 클라이언트 쪽 필터: 각 열에 대해 원하는 필터를 선택합니다. 예를 들면 다음과 같습니다.

      열 필터를 사용하는 예제 클라이언트 쪽 필터를 보여 주는 스크린샷

    • 서버 쪽 필터: 특정 시간 창을 선택하거나 표시되는 실행 횟수를 제한하려면 페이지 맨 위에 있는 범위 컨트롤을 사용합니다. 기본적으로 1,000개 레코드가 한 번에 나타납니다.

      시간 창을 변경하는 예제 서버 쪽 필터를 보여 주는 스크린샷

  5. 특정 실행에 대한 모든 작업 및 관련 세부 정보를 보려면 해당 논리 앱 워크플로 실행에 대한 행을 선택합니다.

    다음 예제에서는 특정 논리 앱 워크플로 실행에 대한 모든 작업 및 트리거를 보여 줍니다.

    특정 논리 앱 워크플로 실행에 대한 모든 작업 및 세부 정보를 보여 주는 스크린샷

Azure Storage 및 Azure Event Hubs에 진단 데이터 보내기

Azure Monitor 로그와 함께 수집된 데이터를 다른 대상으로 보낼 수 있습니다. 예를 들면 다음과 같습니다.

그런 다음, Azure Stream AnalyticsPower BI 등의 다른 서비스에서 얻은 원격 분석 및 분석을 사용하여 실시간으로 모니터링할 수 있습니다.

참고 항목

보존 기간은 스토리지 계정을 사용하는 경우에만 적용됩니다.

Azure Portal, 사용량 논리 앱 리소스, 스토리지 계정 및 이벤트 허브 옵션이 있는 진단 설정을 보여 주는 스크린샷

원격 분석에 사용자 지정 속성 포함

워크플로에서 트리거 및 작업에는 다음 사용자 지정 속성을 추가하여 해당 값이 Log Analytics 작업 영역에서 내보낸 원격 분석과 함께 표시되도록 하는 기능이 있습니다.

사용자 지정 추적 ID

대부분의 트리거에는 식을 사용하여 추적 ID를 지정할 수 있는 사용자 지정 추적 ID 속성이 있습니다. 이 식을 사용하여 수신된 메시지 페이로드에서 데이터를 얻거나 고유한 값을 생성할 수 있습니다. 예를 들면 다음과 같습니다.

이 사용자 지정 추적 ID를 지정하지 않으면 Azure는 자동으로 이 ID를 생성하고 워크플로 실행 전반에서 부모 워크플로로부터 호출되는 중첩된 워크플로를 비롯한 이벤트 간의 상관 관계를 파악합니다. 트리거 요청에서 사용자 지정 ID 값과 함께 x-ms-client-tracking-id 헤더를 전달하여 트리거에서 직접 이 ID를 지정할 수 있습니다. 요청 트리거, HTTP 트리거 또는 Webhook 기반 트리거를 사용할 수 있습니다.

추적된 속성

작업에는 특정 입력 또는 출력을 추적하기 위해 식 또는 하드 코딩된 값을 입력하여 사용자 지정 속성 이름 및 값을 지정할 수 있는 추적된 속성 섹션이 있습니다. 예를 들면 다음과 같습니다.

추적된 속성으로 단일 작업의 입력 및 출력만 추적할 수 있지만 이벤트의 correlation 속성을 사용하여 워크플로 실행에 있는 작업 간의 상관 관계를 파악할 수 있습니다.

추적된 속성은 자체 트리거 또는 작업에 대한 매개 변수, 입력 및 출력만 참조할 수 있습니다.

추적된 속성은 보안 입력, 보안 출력 또는 둘 다 있는 트리거 또는 작업에서 허용되지 않습니다. 또한 보안 입력, 보안 출력 또는 둘 다 있는 다른 트리거 또는 작업을 참조할 수 없습니다.

다음 예제에서는 Log Analytics 작업 영역에서 사용자 지정 속성이 표시되는 위치를 보여 줍니다.

  1. Log Analytics 작업 영역 메뉴의 클래식에서 작업 영역 요약을 선택합니다. 개요 페이지에서 Logic Apps 관리를 선택합니다.

  2. 검토하려는 워크플로의 행을 선택합니다.

  3. 실행 페이지의 논리 앱 실행 테이블에서 추적 ID 열과 추적된 속성 열을 찾습니다.

    특정 사용량 워크플로의 실행 및 상태를 보여 주는 스크린샷

  4. 추적된 속성을 검색하려면 열 필터를 사용합니다. 속성을 보려면 보기를 선택합니다.

    특정 사용량 워크플로의 실행 및 상태를 보여 주는 스크린샷

다음 단계