방법: 후크를 사용하여 경고를 구성하고 알림 가져오기

  • 아티클

Important

2023년 9월 20일부터 새로운 Metrics Advisor 리소스를 만들 수 없습니다. Metrics Advisor 서비스는 2026년 10월 1일에 사용 중지됩니다.

Metrics Advisor에서 변칙이 검색되면 후크를 사용하여 경고 설정에 따라 경고 알림이 트리거됩니다. 경고 설정은 여러 검색 구성과 함께 사용할 수 있으며, 다양한 매개 변수를 사용하여 경고 규칙을 사용자 지정할 수 있습니다.

후크 만들기

Metrics Advisor는 이메일, Teams, webhook, Azure DevOps 등의 네 가지 다른 유형의 후크를 지원합니다. 특정 시나리오에 적합한 후크를 선택할 수 있습니다.

이메일 후크

참고 항목

변칙 경고를 보내려면 먼저 Metrics Advisor 리소스 관리자가 이메일 설정을 구성하고 Metrics Advisor에 SMTP 관련 정보를 입력해야 합니다. 리소스 그룹 관리자 또는 구독 관리자는 Metrics Advisor 리소스의 액세스 제어 탭에서 하나 이상의 Cognitive Services Metrics Advisor 관리자 역할을 할당해야 합니다. 이메일 설정 구성에 대해 자세히 알아보기

이메일 후크는 받는 사람 이메일 섹션에 지정된 이메일 주소로 변칙 경고를 보내는 채널입니다. 두 가지 유형의 경고 이메일(데이터 피드를 사용할 수 없음 경고 및 하나 이상의 변칙을 포함하는 인시던트 보고서)이 전송됩니다.

이메일 후크를 만들기 위해 다음 매개 변수를 사용할 수 있습니다.

매개 변수 Description
이름 이메일 후크의 이름입니다.
받는 사람 이메일 경고를 보낼 이메일 주소
외부 링크 문제 해결 메모와 같이 사용자 지정 리디렉션을 사용하도록 설정하는 선택적 필드입니다.
사용자 지정 변칙 경고 제목 제목 템플릿은 ${severity}, ${alertSettingName}, ${datafeedName}, ${metricName}, ${detectConfigName}, ${timestamp}, ${topDimension}, ${incidentCount}, ${anomalyCount}를 지원합니다.

확인을 클릭하면 이메일 후크가 만들어집니다. 모든 경고 설정에서 사용하여 변칙 경고를 수신할 수 있습니다. 자세한 단계는 Metrics Advisor에서 변칙 알림 사용 자습서를 참조하세요.

Teams 후크

Teams 후크는 변칙 경고가 Microsoft Teams 채널로 전송되는 채널입니다. Teams 후크는 ‘들어오는 webhook’ 커넥터를 통해 구현됩니다. 대상 Teams 채널에서 ‘들어오는 webhook’ 커넥터를 미리 만들고 URL을 가져와야 할 수도 있습니다. 그런 다음, Metrics Advisor 작업 영역으로 다시 피벗합니다.

왼쪽 탐색 모음에서 ‘후크’ 탭을 선택한 후 페이지 오른쪽 상단에서 ‘후크 만들기’ 단추를 선택합니다. ‘Teams’ 후크 유형을 선택하면 다음 매개 변수가 제공됩니다.

매개 변수 Description
이름 Teams 후크의 이름입니다.
커넥터 URL 대상 Teams 채널에서 만든 ‘들어오는 webhook’ 커넥터에서 방금 복사한 URL입니다.

확인을 선택하면 Teams 후크가 만들어집니다. 모든 경고 설정에서 이를 사용하여 대상 Teams 채널에 변칙 경고를 알릴 수 있습니다. 자세한 단계는 Metrics Advisor에서 변칙 알림 사용 자습서를 참조하세요.

웹후크

webhook는 고객이 제공한 엔드포인트를 사용하는 또 다른 알림 채널입니다. 시계열에서 검색된 모든 변칙은 webhook를 통해 알림을 받습니다. Metrics Advisor 내에서 webhook를 경고 알림 채널로 사용하도록 설정하는 몇 가지 단계가 있습니다.

1단계. Metrics Advisor 리소스에서 관리 ID 사용

시스템이 할당한 관리 ID는 리소스당 하나로 제한되며 이 리소스의 수명주기에 연결됩니다. Azure RBAC(역할 기반 액세스 제어)를 사용하여 관리 ID에 권한을 부여할 수 있습니다. 관리 ID는 Microsoft Entra ID로 인증되므로 코드에 자격 증명을 저장할 필요가 없습니다.

Azure Portal에서 Metrics Advisor 리소스로 이동하여 ‘ID’를 선택하고 ‘켜기’로 전환한 다음 관리 ID를 사용하도록 설정합니다.

2단계. Metrics Advisor 작업 영역에서 webhook 만들기

작업 영역에 로그인하고 ‘후크’ 탭을 선택한 다음 ‘후크 만들기’ 단추를 선택합니다.

웹후크를 만들려면 다음 정보를 추가해야 합니다.

매개 변수 설명
엔드포인트 경고가 트리거될 때 호출되는 API 주소. Https여야 합니다.
사용자 이름/암호 API 주소를 인증하는 데 사용할 수 있습니다. 인증이 필요하지 않은 경우 비워 둡니다.
헤더 API 호출의 사용자 지정 헤더.
Azure Key Vault의 인증서 식별자 엔드포인트에 액세스하려면 인증서로 인증해야 하는 경우 인증서를 Azure Key Vault에 저장해야 합니다. 여기에 식별자를 입력합니다.

참고 항목

webhook가 만들어지거나 수정되면, 요청 본문이 비어 있는 테스트로 엔드포인트가 호출됩니다. 유효성 검사에 통과하려면 API가 200 HTTP 코드를 반환해야 합니다.

web hook creation window.

  • 요청 메서드는 POST입니다.
  • 시간 제한 30초
  • 5xx 오류의 경우 다시 시도하고, 다른 오류는 무시합니다. 301/302 리디렉션 요청을 따르지 않습니다.
  • 요청 본문.:
{
"value": [{
	"hookId": "b0f27e91-28cf-4aa2-aa66-ac0275df14dd",
	"alertType": "Anomaly",
	"alertInfo": {
		"anomalyAlertingConfigurationId": "1bc6052e-9a2a-430b-9cbd-80cd07a78c64",
		"alertId": "172536dbc00",
		"timestamp": "2020-05-27T00:00:00Z",
		"createdTime": "2020-05-29T10:04:45.590Z",
		"modifiedTime": "2020-05-29T10:04:45.590Z"
	},
	"callBackUrl": "https://kensho2-api.azurewebsites.net/alert/anomaly/configurations/1bc6052e-9a2a-430b-9cbd-80cd07a78c64/alerts/172536dbc00/incidents"
}]
}

3단계. (선택 사항) 인증서를 Azure Key Vault에 저장하고 식별자를 가져옵니다. 앞에서 설명한 대로, 엔드포인트에 액세스하기 위해 인증서로 인증해야 하는 경우 인증서를 Azure Key Vault에 저장해야 합니다.

  • Azure Portal을 사용하여 Azure Key Vault에서 인증서 설정 및 검색 확인
  • 추가한 인증서를 선택하면 ‘인증서 식별자’를 복사할 수 있습니다.
  • 그런 다음 ‘액세스 정책’과 ‘액세스 정책 추가’를 선택하고 ‘키 권한’, ‘비밀 권한’ 및 ‘인증서 권한’에 대해 ‘가져오기’ 권한을 부여합니다. Metrics Advisor 리소스의 이름으로 보안 주체를 선택합니다. ‘액세스 정책’ 페이지에서 ‘추가’ 및 ‘저장’ 단추를 선택합니다.

4단계 알림이 웹후크를 통해 푸시되면 변칙 알림을 수신함으로써 웹후크 요청에서 “callBackUrl”을 호출하여 인시던트 데이터를 페치할 수 있습니다. 이 API에 대한 세부 정보는 다음에서 확인할 수 있습니다.

webhook 및 Azure Logic Apps 사용하면 SMTP 서버를 구성하지 않고 이메일 알림을 보낼 수 있습니다. 자세한 단계는 Metrics Advisor에서 변칙 알림 사용 자습서를 참조하세요.

Azure DevOps

또한 Metrics Advisor는 변칙이 검색될 때 문제/버그를 추적하기 위해 Azure DevOps에서 작업 항목을 자동으로 만드는 기능도 지원합니다. 모든 경고는 Azure DevOps 후크를 통해 전송될 수 있습니다.

Azure DevOps 후크를 만들려면 다음 정보를 추가해야 합니다.

매개 변수 Description
이름 후크 이름
조직 DevOps가 속한 조직
프로젝트 DevOps의 특정 프로젝트
액세스 토큰 DevOps에 인증하기 위한 토큰

참고 항목

Metrics Advisor가 변칙 경고를 기반으로 작업 항목을 생성하도록 하려면 쓰기 권한을 부여해야 합니다. 후크를 만든 후에는 모든 경고 설정에서 후크를 사용할 수 있습니다. 후크 설정 페이지에서 후크를 관리합니다.

경고 설정 추가 또는 편집

메트릭 세부 정보 페이지로 이동하여 메트릭 세부 정보 페이지의 왼쪽 하단에 있는 경고 설정 섹션을 찾습니다. 선택한 검색 구성에 적용되는 모든 경고 설정이 나열됩니다. 새 검색 구성이 만들어지면 경고 설정이 없으므로 경고가 전송되지 않습니다.
추가, 편집 및 삭제 아이콘을 사용하여 경고 설정을 수정할 수 있습니다.

Alert settings menu item.

추가 또는 편집 단추를 선택하면 경고 설정을 추가하거나 편집할 수 있는 창이 나타납니다.

Add or edit alert settings

경고 설정 이름: 경고 설정의 이름입니다. 이 이름은 경고 이메일 제목에 표시됩니다.

후크: 경고를 보낼 후크 목록입니다.

위의 스크린샷에 표시된 섹션은 한 가지 검색 구성에 대한 설정입니다. 다양한 검색 구성에 대해 서로 다른 경고 설정을 지정할 수 있습니다. 이 창의 세 번째 드롭다운 목록을 사용하여 대상 구성을 선택합니다.

필터 설정

다음은 하나의 검색 구성에 대한 필터 설정입니다.

경고 대상에는 변칙 필터링 옵션이 네 가지 있습니다.

  • 모든 계열의 변칙: 모든 변칙이 경고에 포함됩니다.
  • 계열 그룹의 변칙: 차원 값을 기준으로 계열을 필터링합니다. 일부 차원에 대해 특정 값을 설정합니다. 계열이 지정된 값과 일치하는 경우에만 변칙이 경고에 포함됩니다.
  • 즐겨찾는 계열의 변칙: 즐겨찾기로 표시된 계열만 경고에 포함됩니다. |
  • 모든 계열의 상위 N개 변칙: 이 필터는 값이 상위 N개에 속하는 계열에만 관심이 있는 경우에 사용됩니다. Metrics Advisor는 이전의 타임스탬프를 다시 살펴보고 이러한 타임스탬프의 계열 값이 상위 N개에 속하는지 확인합니다. ‘상위 n개’가 지정된 수보다 클 경우 변칙이 경고에 포함됩니다. |

변칙 옵션 필터링은 다음 옵션이 포함된 추가 필터입니다.

  • 심각도: 변칙 심각도가 지정된 범위 내에 있는 경우에만 변칙이 포함됩니다.
  • 다시 알림: 경고에서 트리거될 때 다음 N개 포인트(마침표)의 변칙에 대한 경고를 일시적으로 중지합니다.
    • 다시 알림 유형: 계열로 설정되면, 변칙이 트리거되면 해당 계열만 다시 알립니다. 메트릭의 경우 변칙 하나가 트리거되면 이 메트릭의 모든 계열을 다시 알립니다.
    • 다시 알림 수: 다시 알릴 포인트(마침표)의 수입니다.
    • 비연속인 경우 초기화: 선택한 경우, 변칙이 트리거되면 연속된 다음 n개의 변칙을 다시 알립니다. 다음 데이터 포인트 중 하나가 변칙이 아닌 경우 해당 포인트부터 다시 알림이 초기화됩니다. 이 옵션을 선택하지 않으면 연속적인 데이터 포인트가 변칙이 아니더라도 한 변칙이 트리거되면 다음 n개 포인트(마침표)를 다시 알립니다.
  • 값(선택 사항): 값을 기준으로 필터링합니다. 조건을 충족하는 포인트 값인 경우에만 변칙이 포함됩니다. 다른 메트릭의 해당 값을 사용하는 경우 두 메트릭의 차원 이름이 일치해야 합니다.

필터링되지 않은 변칙은 경고로 전송됩니다.

교차 메트릭 설정 추가

다른 섹션을 추가하려면 경고 설정 페이지에서 + 교차 메트릭 설정 추가를 선택합니다.

연산자 선택기는 각 섹션의 논리적 관계로, 경고의 전송 여부를 결정합니다.

Operator 설명
AND 계열이 각 경고 섹션과 일치하고 모든 데이터 포인트가 변칙인 경우에만 경고를 보냅니다. 메트릭에 다른 차원 이름이 있는 경우 경고가 트리거되지 않습니다.
또는 하나 이상의 섹션에 변칙이 포함되어 있는 경우 경고를 보냅니다.

Operator for multiple alert setting sections

다음 단계