원격 웹 서버에 경고 알림을 보내도록 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 클라이언트에서 워크플로 생성을 참조하십시오.

프로시저

  1. 기본 메뉴를 확장하고 경고 > Webhook로 이동합니다.
  2. 새 Webhook를 클릭합니다.
  3. 이름 텍스트 상자에 Webhook의 이름을 입력합니다.
  4. 다음 정보를 입력합니다.
    옵션 설명
    끝점 알림을 보낼 끝점(예 : Slack, Pager Duty, vRO 또는 사용자 지정 끝점)을 선택합니다. 선택한 끝점 유형에 따라 다음이 적용됩니다.
    • 사용자 인터페이스는 추가 입력 옵션을 제공합니다.
    • 사용자 인터페이스는 webhook 페이로드를 요구에 따라 사용자 지정할 수 있는 미리 정의된 템플릿으로 채웁니다.
    로그 페이로드 해당하는 경고 쿼리와 일치하는 각 결과에 대해 하나의 Webhook 알림을 보낼지 아니면 일치하는 모든 결과에 대해 하나의 알림을 보낼지를 선택합니다.
    • 일치하는 각 결과에 대해 하나의 Webhook 알림을 보내려면 개별 로그를 선택합니다.
      참고: 이 옵션을 선택하면 최대 10개의 알림을 보낼 수 있습니다.
    • 일치하는 모든 결과에 대해 하나의 Webhook 알림을 보내려면 로그 스트림을 선택합니다.
    Webhook URL Webhook 알림을 게시할 원격 웹 서버의 URL을 입력합니다. URL 형식은 끝점 선택에 따라 변경됩니다. 샘플 형식은 텍스트 상자에 제공됩니다.
    참고: vRO 끝점 URL에는 vRealize Orchestrator에서 생성된 해당 워크플로의 ID를 포함해야 합니다.

    URL을 입력한 후 테스트 경고를 클릭하여 연결을 확인합니다.

    여러 Webhook URL을 공백으로 구분하여 입력할 수 있습니다.
    웹 프록시 하나 이상의 HTTP 프록시를 구성한 경우 드롭다운 메뉴에서 프록시를 선택합니다. vRealize Log Insight는 선택한 프록시를 통해 끝점에 Webhook 알림을 전송합니다.
    통합 키 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을 제외하고 다른 모든 문자열 매개 변수 유형의 컨텐츠는 동일합니다.
  5. 저장을 클릭합니다.

다음에 수행할 작업

선택한 끝점에 Webhook 알림을 보내도록 경고를 구성합니다. 자세한 내용은 Webhook 알림을 보낼 경고 추가를 참조하십시오.

경고를 구성한 후 끝점에서 Webhook 알림을 볼 수 있습니다. 예를 들어 vRO에서 Webhook 알림은 워크플로 실행으로 나열됩니다. 각 워크플로 실행에서 변수 섹션의 페이로드 매개 변수 값을 볼 수 있습니다.