이벤트 - 전역

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기7분

    • 이벤트 API는 이벤트 내에서 값을 설정/가져올 수 있는 메서드를 제공합니다.

    이러한 이벤트는 a MID 서버 에서 인스턴스로 ServiceNow 전송됩니다. 이벤트를 성공적으로 전송하려면 먼저 와 인스턴스 간의 MID 서버ServiceNow 연결을 정의해야 합니다.

    이벤트 API를 사용하여 이벤트 내에서 필드를 추가/업데이트합니다. SNEventSenderProvider API를 사용하여 이벤트 발신자 객체를 인스턴스화합니다. 그런 다음 IEventSender API를 사용하여 이벤트를 인스턴스로 ServiceNow 보냅니다.

    이 API에 접근하려면 먼저 Event Management(com.glideapp.itom.snac) 플러그인을 활성화해야 합니다. Event Management 플러그인은 별도의 구독이 필요하며 담당자가 ServiceNow 활성화해야 합니다. 이 플러그인은 데모 데이터를 포함하며 관련 플러그인이 아직 활성화되지 않은 경우 이를 활성화합니다.

    Event Management에 대한 자세한 내용은 Event Management를 참조하십시오.

    이벤트 - Event()

    Event 생성자를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    없음 
    var event = new Event();
var esource = event.getField("source");
var eseverity = event.getField("severity");

    이벤트 - getField(String field)

    전달된 이벤트 관리 필드의 현재 값을 반환합니다.

    표 2. 매개변수
    이름 유형 설명
    필드 문자열 반환할 이벤트 관리 필드 값의 이름입니다.
    표 3. 반환
    유형 설명
    문자열 요청된 이벤트 관리 필드의 값입니다. 
    var event = new Event();
var eventSource = event.getField("source");
var eventSeverity = event.getField("severity");

    이벤트 - setAdditionalInfo(String additionalInfo)

    연결된 이벤트의 기존 additional_info 필드를 전달된 JSON 문자열로 대체합니다.

    주:
    setField() 메서드를 사용하여 필드 내의 특정 필드를 업데이트할 수 있습니다additional_info.
    표 4. 매개변수
    이름 유형 설명
    additionalInfo 문자열 필드에 저장할 JSON 문자열(키/값 쌍)입니다 additional_info .
    주:
    이 매개변수는 기존 정보를 대체합니다. 기존 필드는 업데이트하지 않습니다.
    표 5. 반환
    유형 설명
    void 
    event.setAdditionalInfo("{\"evtComponent\":\"Microsoft-Windows- WindowsUpdateClient\",\"evtMessage\":\"Installation Failure: Windows failed. Error 0x80070490\"}");

    이벤트 - setField(String key, String value)

    연결된 이벤트에서 지정된 필드를 설정합니다.

    전달 key 된 내용이 미리 정의된 이벤트 필드와 일치하면 메서드는 해당 이벤트 필드를 업데이트합니다. 그렇지 않으면 메서드는 전달value된 key 를 적용하기 전에 이벤트의 섹션에 매개 변수를 additional_info 추가합니다.

    다음은 이 방법을 사용하여 수정할 수 있는 미리 정의된 이벤트 필드입니다.

    필드 설명
    additional_info 연결된 이벤트의 필드에 추가할 additional_info 키-값 쌍입니다. 전달된 키가 이미 있는 경우 해당 값을 덮어씁니다.

    최대 길이: 4,000자

    관련된 UI 필드: 추가 정보
    ci_identifier 구성 항목을 고유하게 식별하는 JSON 문자열입니다. 예: {"name":"SAP ORA01","type":"Oracle"}.

    최대 길이: 1,000자
    cmdb_ci 이벤트를 바인딩할 구성 항목 [cmdb_ci] 기록의 Sys_id입니다.

    기본값: Null
    설명 이벤트에 대한 자유 형식 설명입니다.

    최대 길이: 4,000자

    연결된 UI 필드: 설명

    기본값: Null
    event_class 이벤트를 생성한 EMS(Enterprise Message Service)입니다. 예: "Solarwinds" 또는 "SCOM".

    최대 길이: 100

    연결된 UI 필드: 소스 인스턴스

    기본값: Null
    message_key 고유 이벤트 식별자입니다. 기존 이벤트 심각도를 재정의하려면 동일한 message_key 값을 사용합니다.

    최대 길이: 1024자

    연결된 UI 필드: 메시지 키

    기본값: , node, typeresource의 조합source입니다metric name.
    resolution_state 이벤트 해결 상태입니다.
    유효한 값은 다음과 같습니다.
    • 신규: 해당 이벤트에 대한 해결 상태가 오픈되었습니다.
    • 종결: 해당 이벤트에 대한 해결 상태가 종결/종결입니다.

    연결된 UI 필드: 해결 상태

    기본값: 신규
    resource 이벤트와 연결할 노드 자원입니다. 예를 들어 "Disk C:", "CPI-1" 또는 프로세스나 서비스의 이름입니다.

    최대 길이: 100자

    연결된 UI 필드: 자원
    severity 이벤트 심각도
    유효한 값은 다음과 같습니다.
    • 0: 지우기 - 아무 작업도 필요하지 않습니다. 이 이벤트에서는 경보가 생성되지 않습니다. 기존 경보는 종결됩니다.
    • 1: 확인 - 경보가 생성됩니다. 자원이 여전히 작동하고 있습니다.
    • 2: 경고 - 리소스가 여전히 작동하더라도 주의가 필요합니다.
    • 3: 경미함 - 부분적이거나 중요하지 않은 기능의 손실 또는 성능 저하가 발생했습니다.
    • 4: 중요 - 주요 기능에 심각한 장애가 있거나 성능이 저하되었습니다.
    • 5: 심각 - 즉각적인 조치가 필요합니다. 자원이 작동하지 않거나 중요한 문제가 곧 발생합니다.

    연결된 UI 필드: 심각도

    기본값: Null
    source 이벤트를 트리거한 EMS의 인스턴스입니다. 일반적으로 커넥터 인스턴스 이름입니다.

    최대 길이: 200자

    연결된 UI 필드: 소스

    기본값: Null
    time_of_event 소스 시스템에서 이벤트가 발생한 UTC 시간입니다.

    형식: "yyyy-MM-dd HH:mm:ss"

    최대 길이: 40자

    관련된 UI 필드: 이벤트 시간

    기본값: 현재 날짜/시간
    type 이벤트가 관련된 메트릭 유형(디스크 또는 CPU)입니다. 이 값은 경보가 생성되는 이벤트 기록을 식별하는 데 사용됩니다.

    최대 길이: 100자

    연결된 UI 필드: 유형

    기본값: Null
    주:
    setText() 메서드를 사용하여 필드를 업데이트 description 하고 setTimeOfEvent() 메서드를 사용하여 이벤트 시간을 업데이트할 수도 있습니다.

    이벤트에 대한 자세한 내용은 Event Management를 참조하십시오.

    표 6. 매개변수
    이름 유형 설명
    키 문자열 이벤트에서 추가하거나 업데이트할 키의 이름입니다. 미리 정의된 이벤트 필드에 대한 자세한 내용은 이벤트 수집의 이벤트 필드 형식을 참조하십시오.
    값 문자열 연결된 이벤트 필드에 저장할 정보입니다.
    주:
    문자열은 value 저장되기 전에 잘리며, 여러 공백이 단일 공백으로 바뀝니다.
    표 7. 반환
    유형 설명
    void 
    var event = new Event();
event.setField("source","SAP Solman");
event.setField("severity","3");
event.setField("time_of_event", "2019-18-05 13:12:05");
event.setField("type", "SAP object");
event.setField("user", "admin"); // parameter will be added to additional_info section

    이벤트 - setText(text 문자열)

    description 연결된 이벤트의 필드를 전달된 값으로 설정합니다.

    주:
    이 메서드를 사용하여 이벤트 - setField(String key, String value) 현재 이벤트에서 필드를 설정할 text 수도 있습니다. setField() 메서드와 달리 이 메서드는 전달된 텍스트를 자르지 않습니다.
    표 8. 매개변수
    이름 유형 설명
    텍스트 문자열 연결된 이벤트의 필드에 저장할 description 텍스트입니다.

    최대 길이: 4000자
    표 9. 반환
    유형 설명
    void 
    var event = new Event();
event.setText("SAP Solman");

    이벤트 - setTimeOfEvent(String timeOfEvent)

    time_of_event 연결된 이벤트의 필드를 UTC 시간 값으로 전달합니다.

    주:
    이 이벤트 - setField(String key, String value) 방법을 사용하여 필드를 설정할 수도 있습니다 time_of_event .
    표 10. 매개변수
    이름 유형 설명
    timeOfEvent 문자열 필드에서 time_of_event 설정할 UTC 시간 값입니다.

    형식: "yyyy-MM-dd HH:mm:ss"

    최대 길이: 40자
    표 11. 반환
    유형 설명
    void 
    var event = new Event();
event.setTimeOfEvent("2019-18-05 13:12:05");