이벤트 - 전역

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

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

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

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

    이 API에 액세스하기 전에 이벤트 관리(com.glideapp.itom.snac) 플러그인을 활성화해야 합니다. 이벤트 관리 플러그인은 별도의 구독이 필요하며 활성화해야 합니다. 이 플러그인은 데모 데이터를 포함하며 관련 플러그인이 아직 활성화되지 않은 경우 이를 활성화합니다.

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

    이벤트 - Event()

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

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

    이벤트 - getField(문자열 필드)

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

    표 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(문자열 키, 문자열 값)

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

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

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

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

    최대 길이: 4,000자

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

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

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

    최대 길이: 4,000자

    연결된 UI 필드: 설명

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

    최대 길이: 100

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

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

    최대 길이: 1024자

    연결된 UI 필드: 메시지 키

    기본값: , , , 및 의 조합source입니다metric name. resourcetypenode
    resolution_state 이벤트 해결 상태입니다.
    유효한 값은 다음과 같습니다.
    • 신규: 해당 이벤트의 해결 상태가 열려 있습니다.
    • Closing: 해당 이벤트의 해결 상태는 Closing/Closed입니다.

    연결된 UI 필드: 해결 상태

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

    최대 길이: 100자

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

    연결된 UI 필드: 심각도

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

    최대 길이: 200자

    연결된 UI 필드: 소스

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

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

    최대 길이: 40자

    연결된 UI 필드: 이벤트 시간

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

    최대 길이: 100자

    연결된 UI 필드: 유형

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

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

    표 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(문자열 텍스트)

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

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

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

    이벤트 - setTimeOfEvent(String timeOfEvent)

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

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

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

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