KQL 쿼리 세트에서 Activator 경고 만들기

KQL 쿼리 세트에 대한 경고 설정

1. KQL 쿼리 세트가 포함된 작업 영역을 엽니다.

2. KQL 쿼리셋으로 이동하여 이를 선택해 열리게 합니다.

3. 시각화를 반환하는 쿼리를 실행합니다.

4. 쿼리가 결과를 반환하면 위쪽 리본에서 경고 설정을 선택합니다.

   

경고 조건 정의

표시되는 규칙 추가 쪽 창에서 다음 단계에 따라 경고 조건을 정의합니다.

1. 세부 정보 섹션에서 활성화자 경고 규칙의 이름을 제공합니다.

   

2. 모니터 섹션에서 쿼리 실행 빈도를 설정합니다. 기본값은 5분입니다.

   

3. 조건 섹션에서 다음과 같이 경고 조건을 지정합니다.

   

   • 시각화에 차원이 없는 경우 모니터링할 특정 필드를 선택하여 데이터 스트림의 변경 내용을 모니터링하는 조건이 있을 때 각 이벤트에 대해 On을 선택할 수 있습니다.
   • When 드롭다운에서 평가할 값을 설정합니다.
   • 조건 드롭다운에서 평가할 조건을 설정합니다. 자세한 내용은 조건을 참조하세요.
   • 발생 필드에서 경고가 트리거되기 전에 조건을 충족해야 하는 횟수를 설정합니다.

4. 작업 섹션에서 다음 작업 중 하나를 선택합니다.

   • 이메일 알림 보내기:

     1. 선택 작업의 경우 전자 메일 보내기를 선택합니다.
     2. 받는 사람의 전자 메일 주소를 입력하거나 드롭다운 목록을 사용하여 값이 전자 메일 주소인 속성을 선택합니다. 기본적으로 전자 메일 주소는 여기에 채워집니다.
     3. 제목에 전자 메일 알림의 제목을 입력합니다.
     4. 헤드라인의 경우 이메일 알림의 제목을 입력합니다.
     5. 메모의 경우 전자 메일 알림에 대한 메모를 입력합니다.

        비고

        제목, 제목 또는 노트를 입력할 때 입력 @ 하거나 텍스트 상자 옆에 있는 단추를 선택하여 데이터의 속성을 참조할 수 있습니다. 예: @BikepointID.

     6. 컨텍스트의 경우 메일 알림에 포함할 드롭다운 목록에서 값을 선택합니다.

     

   • Microsoft Teams 알림 보내기: Microsoft Teams 메시지를 자신에게 보냅니다. 제목 및 메시지 콘텐츠를 사용자 지정할 수 있습니다.

     1. 선택 작업의 경우 Teams -->Message to indviduals 또는 Group Chat message 또는 Channel post를 선택합니다.
     2. 선택에 따라 다음 단계 중 하나를 수행합니다.
        • 개인에게 메시지 옵션을 선택한 경우 받는 사람의 전자 메일 주소를 입력하거나 드롭다운 목록을 사용하여 값이 전자 메일 주소인 속성을 선택합니다. 조건이 충족되면 지정된 개인에게 전자 메일이 전송됩니다.
        • 그룹 채팅 메시지 옵션을 선택한 경우 드롭다운 목록에서 그룹 채팅을 선택합니다. 조건이 충족되면 그룹 채팅에 메시지가 게시됩니다.
        • 채널 게시 옵션을 선택한 경우 드롭다운 목록에서 팀 및 채널을 선택합니다. 조건이 충족되면 선택한 채널에 메시지가 게시됩니다.
     3. 헤드라인의 경우 Teams 알림의 헤드라인을 입력합니다.
     4. 노트의 경우 Teams 알림에 대한 메모를 입력합니다.

        비고

        제목, 제목 또는 노트를 입력할 때 입력 @ 하거나 텍스트 상자 옆에 있는 단추를 선택하여 데이터의 속성을 참조할 수 있습니다. 예: @BikepointID.

     5. 컨텍스트의 경우 Teams 알림에 포함할 드롭다운 목록에서 값을 선택합니다.

     

   • 패브릭 작업 실행: 조건이 충족되면 패브릭 파이프라인, Spark 작업 또는 Notebook을 시작하도록 경고를 구성하려면 다음 단계를 수행합니다.

     1. 선택 작업의 경우 파이프라인 실행, Spark 작업 실행, Notebook 실행 또는 함수 실행(미리 보기)을 선택합니다.
     2. '실행할 패브릭 항목 선택' 목록에서 실행할 패브릭 항목(파이프라인, 노트북, 스파크 작업, 함수)을 선택합니다.
     3. 매개 변수 추가를 선택하고 Fabric 항목의 매개 변수 이름과 해당 매개 변수의 값을 지정합니다. 둘 이상의 매개 변수를 추가할 수 있습니다. 입력 @ 하거나 텍스트 상자 옆에 있는 단추를 선택하여 경고 데이터에서 매개 변수를 전달할 수 있습니다. 예: @BikepointID.

   • 사용자 지정 작업: 조건이 충족되면 사용자 지정 작업을 호출하도록 경고를 구성하려면 다음 단계를 수행합니다.

     1. 선택 작업의 경우 사용자 지정 작업 만들기를 선택합니다.

        

     2. 작업 섹션에서 설명한 대로 먼저 규칙을 만든 다음, 사용자 지정 작업 트리거(Power Automate 흐름)의 단계에 따라 사용자 지정 작업 설정을 완료합니다.

     3. 사용자 지정 작업을 만든 후 규칙의 정의 창에서 작업 드롭다운 목록에서 만든 사용자 지정 작업을 선택합니다.

5. 저장 위치에서 Activator 경고를 저장할 위치를 지정합니다. 기존 작업 영역을 선택하고 기존 활성화기 또는 새 작업 영역에 저장합니다.

   

6. 만들기를 선택하여 활성화자 규칙을 만듭니다.

KQL 쿼리 세트에 대한 경고 설정

1. KQL 쿼리 세트가 포함된 작업 영역을 엽니다.
2. KQL 쿼리셋으로 이동하여 이를 선택해 열리게 합니다.
3. 쿼리를 실행합니다. 활성화자는 이후 단계에서 설정한 시간 빈도에 따라 이 쿼리의 결과를 확인하고 결과 집합에 반환된 각 레코드에 대한 경고를 보냅니다. 예를 들어 예약된 쿼리가 5개의 레코드를 반환하는 경우 Activator는 5개의 경고를 보냅니다.
4. 쿼리 실행이 완료되면 위쪽 리본에서 경고 설정을 선택합니다.

예제 1 - 개수가 임계값보다 큰 경우 단일 결과

예를 들어 다음 쿼리는 지난 5분 동안 테이블에 임계값보다 많은 레코드가 있는 경우 경고를 반환합니다. 쿼리의 마지막 두 줄은 필터와 일치하는 레코드 수가 생성되는 키이며, 개수가 임계값보다 큰 경우에만 결과가 반환됩니다.

SampleTable 
| where ingestion_time() > ago (5min)
// Add any other optional filters
| count 
| where Count > threshold

예제 2 - 여러 값의 배열을 사용하여 단일 결과 만들기

다음 예제에서 쿼리는 모든 지역의 자전거 수가 지정된 임계값을 초과하는 경우 경고를 반환합니다. 숫자가 임계값을 초과하는 모든 지역에 대해 단일 경고를 가져오기 위해 쿼리는 make_list() 연산자를 사용하여 수행되는 단일 레코드(즉, 단일 경고)를 반환하도록 빌드됩니다. 임계값에 도달한 지역 목록을 포함하도록 경고를 편집하려면 선택 사항: 활성화기에서 규칙 편집을 참조하세요.

TableForReflex
| where ingestion_time() > ago (5min)
| summarize NeighborhoodCount = count() by Neighbourhood
| where NeighborhoodCount > threshold
| summarize NeighbourhoodList = make_list(Neighbourhood)

경고 조건 정의

표시되는 규칙 추가 쪽 창에서 다음 단계에 따라 경고 조건을 정의합니다.

1. 세부 정보 섹션에서 활성화자 경고 규칙의 이름을 제공합니다.

   

2. 모니터 섹션에서 쿼리 실행 빈도를 설정합니다. 기본값은 5분입니다.

   

3. 조건 섹션에서 다음과 같이 경고 조건을 지정합니다.

   

   • 시각화에 차원이 없는 경우 모니터링할 특정 필드를 선택하여 데이터 스트림의 변경 내용을 모니터링하는 조건이 있을 때 각 이벤트에 대해 On을 선택할 수 있습니다.
   • When 드롭다운에서 평가할 값을 설정합니다.
   • 조건 드롭다운에서 평가할 조건을 설정합니다. 자세한 내용은 조건을 참조하세요.
   • 발생 필드에서 경고가 트리거되기 전에 조건을 충족해야 하는 횟수를 설정합니다.

4. 작업 섹션에서 다음 작업 중 하나를 선택합니다.

   • 이메일 알림 보내기:

     1. 선택 작업의 경우 전자 메일 보내기를 선택합니다.
     2. 받는 사람의 전자 메일 주소를 입력하거나 드롭다운 목록을 사용하여 값이 전자 메일 주소인 속성을 선택합니다. 기본적으로 전자 메일 주소는 여기에 채워집니다.
     3. 제목에 전자 메일 알림의 제목을 입력합니다.
     4. 헤드라인의 경우 이메일 알림의 제목을 입력합니다.
     5. 메모의 경우 전자 메일 알림에 대한 메모를 입력합니다.

        비고

        제목, 제목 또는 노트를 입력할 때 입력 @ 하거나 텍스트 상자 옆에 있는 단추를 선택하여 데이터의 속성을 참조할 수 있습니다. 예: @BikepointID.

     6. 컨텍스트의 경우 메일 알림에 포함할 드롭다운 목록에서 값을 선택합니다.

     

   • Microsoft Teams 알림 보내기: Microsoft Teams 메시지를 자신에게 보냅니다. 제목 및 메시지 콘텐츠를 사용자 지정할 수 있습니다.

     1. 선택 작업의 경우 Teams -->Message to indviduals 또는 Group Chat message 또는 Channel post를 선택합니다.
     2. 선택에 따라 다음 단계 중 하나를 수행합니다.
        • 개인에게 메시지 옵션을 선택한 경우 받는 사람의 전자 메일 주소를 입력하거나 드롭다운 목록을 사용하여 값이 전자 메일 주소인 속성을 선택합니다. 조건이 충족되면 지정된 개인에게 전자 메일이 전송됩니다.
        • 그룹 채팅 메시지 옵션을 선택한 경우 드롭다운 목록에서 그룹 채팅을 선택합니다. 조건이 충족되면 그룹 채팅에 메시지가 게시됩니다.
        • 채널 게시 옵션을 선택한 경우 드롭다운 목록에서 팀 및 채널을 선택합니다. 조건이 충족되면 선택한 채널에 메시지가 게시됩니다.
     3. 헤드라인의 경우 Teams 알림의 헤드라인을 입력합니다.
     4. 노트의 경우 Teams 알림에 대한 메모를 입력합니다.

        비고

        제목, 제목 또는 노트를 입력할 때 입력 @ 하거나 텍스트 상자 옆에 있는 단추를 선택하여 데이터의 속성을 참조할 수 있습니다. 예: @BikepointID.

     5. 컨텍스트의 경우 Teams 알림에 포함할 드롭다운 목록에서 값을 선택합니다.

     

   • 패브릭 작업 실행: 조건이 충족되면 패브릭 파이프라인, Spark 작업 또는 Notebook을 시작하도록 경고를 구성하려면 다음 단계를 수행합니다.

     1. 선택 작업의 경우 파이프라인 실행, Spark 작업 실행, Notebook 실행 또는 함수 실행(미리 보기)을 선택합니다.
     2. '실행할 패브릭 항목 선택' 목록에서 실행할 패브릭 항목(파이프라인, 노트북, 스파크 작업, 함수)을 선택합니다.
     3. 매개 변수 추가를 선택하고 Fabric 항목의 매개 변수 이름과 해당 매개 변수의 값을 지정합니다. 둘 이상의 매개 변수를 추가할 수 있습니다. 입력 @ 하거나 텍스트 상자 옆에 있는 단추를 선택하여 경고 데이터에서 매개 변수를 전달할 수 있습니다. 예: @BikepointID.

   • 사용자 지정 작업: 조건이 충족되면 사용자 지정 작업을 호출하도록 경고를 구성하려면 다음 단계를 수행합니다.

     1. 선택 작업의 경우 사용자 지정 작업 만들기를 선택합니다.

        

     2. 작업 섹션에서 설명한 대로 먼저 규칙을 만든 다음, 사용자 지정 작업 트리거(Power Automate 흐름)의 단계에 따라 사용자 지정 작업 설정을 완료합니다.

     3. 사용자 지정 작업을 만든 후 규칙의 정의 창에서 작업 드롭다운 목록에서 만든 사용자 지정 작업을 선택합니다.

5. 저장 위치에서 Activator 경고를 저장할 위치를 지정합니다. 기존 작업 영역을 선택하고 기존 활성화기 또는 새 작업 영역에 저장합니다.

1. 만들기를 선택하여 활성화자 규칙을 만듭니다.