경보 통합의 사용자 지정 페이로드
Instance Observer 통합을 사용하면 및 외부 공급업체 통합에 대한 사용자 지정 JSON 요청 페이로드를 정의하고 관리할 수 ServiceNow 있습니다.
이제 알림 페이로드에 추가 필드를 포함하고, 대상 시스템에서 필요하지 않은 특정 데이터를 제외하고, 특정 타사 API 요구 사항 또는 내부 비즈니스 논리에 맞게 페이로드를 포맷할 수 있으므로 고객 측에서 복잡하게 스크립팅된 REST API가 필요하지 않습니다.
- 기본 페이로드를 사용하거나 필요에 따라 추가 데이터를 포함하도록 사용자 지정합니다.
- 필요한 경우 왼쪽의 편집기 창에 표시되는 기본 페이로드를 수정합니다.
- 각 매개변수는 키와 값으로 구성되므로 키 또는 값 중 하나 또는 둘 다를 수정합니다.
- 오른쪽의 미리 보기 섹션은 렌더링 후 예상되는 JSON 페이로드를 표시합니다.
- JSON이 유효하지 않으면 오류가 강조 표시되고 저장 옵션이 비활성화됩니다.
기본 콧수염 페이로드 템플릿
{
"alert_number": "{{alert_number}}",
"alert_type": "{{alert_type}}",
"alert_name": "{{alert_name}}",
"alert_time": "{{alert_time}}",
"instance": "{{instance}}",
"description": "{{description}}",
"alert_created": "{{alert_created}}"
}
예: 기본 페이로드 + 사용자 지정 매개변수
{
"alert_number": "{{alert_number}}",
"alert_type": "{{alert_type}}",
"alert_name": "{{alert_name}}",
"alert_time": "{{alert_time}}",
"instance": "{{instance}}",
"description": "{{description}}",
"alert_created": "{{alert_created}}",
"Custom_message": "{{alert_name}}' of type {{alert_type}} generated for {{instance}} at {{alert_time}}. Please review.",
"Severity": “High”
}
사용자 지정 매개변수 및 제한
custom_parameter 필드를 사용하면 JSON 템플릿에 사용자 지정 메시지를 삽입할 수 있으며, 사용자 지정 매개변수 샘플에 표시된 대로 기존 매개변수를 사용할 수도 있습니다.
제한 사항은 다음과 같습니다.
- 필수: 템플릿을 저장할 매개변수가 하나 이상 또는 최대 20개 필요합니다.
- 최대: 13개의 사용자 지정 매개변수.
- 초과하면 템플릿에 하나 이상의 기본 키와 최대 20개의 키가 있어야 한다는 경고가 나타납니다 . "기본값으로 재설정"을 조정하거나 선택하여 기본값을 적용합니다.
구문 참조를 위한 사용자 지정 매개변수 샘플
"Information": "{{alert_time}} 설명: {{description}}에서 {{인스턴스}}에 대한 경보 {{alert_name}}이(가) 트리거되었습니다."
"Alert_message": "{{alert_name}}에서 {{alert_type}} 유형의 새 경보 '{{alert_time}}에 생성되었습니다. 검토하십시오."
"Event_type": "심각도가 높음! {{alert_name}}에서 {{인스턴스}}에 대한 경보 {{alert_time}}이(가) 트리거되었습니다. 설명: {{description}}"
외부 공급업체 요청 본문 매핑
일부 타사 통합에는 특정 키 이름이 필요합니다. 기본 페이로드를 예상 형식과 일치하도록 수정할 수 있습니다.
예: 외부 공급업체 요청 본문:
{
"endTime": 1,
"entitySelector": "string",
"eventType": "AVAILABILITY_EVENT",
"properties": {},
"startTime": 1,
"timeout": 1,
"title": "string"
}
외부 공급업체 형식과 일치하도록 IO 페이로드를 수정했습니다.
작업 및 확인
- 변경 사항 되돌리기
- 마지막으로 저장된 콘텐츠를 복원합니다.
- 기본값으로 재설정
- 템플릿을 기본 페이로드로 재설정합니다.
- 구문 검사기
- 저장하기 전에 JSON 유효성을 확인합니다. 오류로 인해 저장할 수 없습니다.
- 통합 테스트
- 웹후크 통합을 확인하기 위해 샘플 알림을 보냅니다.