원격 웹 서버에 경고 알림을 보내도록 webhook를 구성할 수 있습니다. webhook는 HTTP POST/PUT을 통해 알림을 제공합니다.
사전 요구 사항
-
슈퍼 관리자 또는 관련 사용 권한이 있는 역할에 연결된 사용자로 vRealize Log Insight 웹 사용자 인터페이스에 로그인했는지 확인합니다. 자세한 내용은 역할 생성 및 수정의 내용을 참조하십시오. 웹 사용자 인터페이스의 URL 형식은 https://log-insight-host이며 여기서 log-insight-host는 vRealize Log Insight 가상 장치의 IP 주소 또는 호스트 이름입니다.
- vRO(vRealize Orchestrator) 끝점을 사용하여 Webhook를 생성하는 경우 vRealize Orchestrator에서 워크플로를 생성했는지 확인합니다. 자세한 내용은 vRealize Orchestrator 클라이언트에서 워크플로 생성을 참조하십시오.
프로시저
- 기본 메뉴를 확장하고 경고 > Webhook로 이동합니다.
- 새 Webhook를 클릭합니다.
- 이름 텍스트 상자에 Webhook의 이름을 입력합니다.
- 다음 정보를 입력합니다.
옵션 설명 끝점 알림을 보낼 끝점(예 : Slack, Pager Duty, vRO 또는 사용자 지정 끝점)을 선택합니다. 선택한 끝점 유형에 따라 다음이 적용됩니다. - 사용자 인터페이스는 추가 입력 옵션을 제공합니다.
- 사용자 인터페이스는 webhook 페이로드를 요구에 따라 사용자 지정할 수 있는 미리 정의된 템플릿으로 채웁니다.
Webhook URL Webhook 알림을 게시할 원격 웹 서버의 URL을 입력합니다. URL 형식은 끝점 선택에 따라 변경됩니다. 샘플 형식은 텍스트 상자에 제공됩니다. 참고: vRO 끝점 URL에는 vRealize Orchestrator에서 생성된 해당 워크플로의 ID를 포함해야 합니다.URL을 입력한 후 테스트 경고를 클릭하여 연결을 확인합니다.
여러 Webhook URL을 공백으로 구분하여 입력할 수 있습니다.
통합 키 Pager Duty 끝점을 선택하는 경우 webhook 요청에 대한 통합 키를 입력합니다. 고급 설정 vRO 또는 사용자 지정 끝점을 선택하는 경우 컨텐츠 유형, 인증 등과 같은 추가 정보를 입력합니다. - vRO 끝점의 경우 컨텐츠 유형의 기본값은 JSON입니다. 필요한 경우 XML로 변경할 수 있습니다. Webhook 페이로드는 선택한 컨텐츠 유형에 따라 생성됩니다.
vRO 요청을 인증하기 위한 인증 헤더를 제공합니다. 일부 인증 옵션은 다음과 같습니다.
- 기본 인증 - 첫 번째 텍스트 상자에 기본값인 인증을 유지합니다. 두 번째 텍스트 상자에 Basic Base64_encoded_string_for_username_and_password 형식으로 값을 입력합니다.
- 기본 토큰 인증 - 첫 번째 텍스트 상자에 기본값인 인증을 유지합니다. 두 번째 텍스트 상자에 Bearer bearer_token 형식으로 값을 입력합니다.
- 사용자 지정 끝점의 경우 컨텐츠 유형의 기본값은 JSON이고 작업은 POST입니다. 이러한 옵션을 사용자 지정하고 사용자 지정 헤더에서 요청에 추가 헤더를 추가할 수 있습니다. 구성된 원격 웹 서버에 webhook 알림을 POST/PUT하기 위한 권한이 필요한 경우 인증 사용자 및 인증 암호 텍스트 상자에 서버에서 인증할 사용자 이름과 암호를 입력합니다.
Webhook 페이로드 이 영역은 끝점 드롭다운 메뉴에서 선택한 내용에 따라 자동으로 채워집니다. POST/PUT WebHook 알림 요청의 일부로 전송되는 본문의 템플릿인 페이로드를 사용자 지정할 수 있습니다. 본문은 XML 또는 JSON 형식일 수 있습니다. 페이로드의 매개 변수는 webhook 알림을 보내는 동안 실제 값으로 바뀝니다. 예를 들어 매개 변수 $(AlertName)은 경고의 이름으로 대체됩니다. 참고: vRO 끝점의 매개 변수는 vRealize Orchestrator에서 생성된 해당 워크플로의 입력 또는 출력 매개 변수와 일치해야 합니다.매개 변수 매개 변수 목록을 사용하여 webhook 페이로드를 구성 또는 수정할 수 있습니다. AlertName
AlertNameString
AlertType
AlertTypeString
SearchPeriod
SearchPeriodString
HitOperator
HitOperatorString
messages
messagesString
HasMoreResults
HasMoreResultsString
Url
UrlString
EditUrl
EditUrlString
Info
InfoString
Recommendation
RecommendationString
NumHits
NumHitsString
TriggeredAt
TriggeredAtString
SourceInfo
SourceInfoString
참고:messagesString
을 제외하고 다른 모든 문자열 매개 변수 유형의 컨텐츠는 동일합니다. - 저장을 클릭합니다.
다음에 수행할 작업
경고를 구성한 후 끝점에서 Webhook 알림을 볼 수 있습니다. 예를 들어 vRO에서 Webhook 알림은 워크플로 실행으로 나열됩니다. 각 워크플로 실행에서 변수 섹션의 페이로드 매개 변수 값을 볼 수 있습니다.