사용자 지정 끌어오기 커넥터 생성

릴리스 버전: Australia

업데이트 날짜 2026년 03월 12일

소요 시간: 6분

이벤트 소스를 대신하여 이벤트를 검색하기 위해 스크립트, 커넥터 정의 및 커넥터 인스턴스가 필요한 사용자 지정 끌어오기 커넥터를 만들 수 있습니다.

시작하기 전에

필요한 역할: evt_mgmt_admin

이 태스크 정보

사용자 지정 커넥터 스크립트는 새 이벤트 소스에 대한 원격 API 호출을 통해 이벤트를 인스턴스로 ServiceNow 보낼 수 있습니다. 스크립트를 만든 다음 새 이벤트 관리 커넥터 정의 및 커넥터 인스턴스의 일부로 추가할 수 있습니다. 이 절차에서는 이름 필드에 파일 이름으로 입력한 이름을 사용하여 JavaScript 코드 파일을 자동으로 만듭니다. 이러한 작업을 수행하는 JavaScript 사용자 지정 코드는 다음과 같아야 합니다.

이벤트 모니터링 도구에 연결합니다.
이벤트 모니터링 도구에서 이벤트를 검색합니다.
웹 서비스 API를 사용하여 이벤트 [em_event] 테이블로 이벤트를 보냅니다. REST API를 참조하십시오.

각 커넥터 정의는 이벤트 소스 벤더에 따라 다릅니다. 커넥터 정의는 외부 이벤트 소스에서 이벤트를 끌어오는 MID 서버 스크립트 포함을 지정합니다. 또한 커넥터 정의는 외부 이벤트 소스 호스트에 연결하는 데 필요한 커넥터 인스턴스 값 매개변수를 지정합니다.

프로시저

사용자 지정 MID 서버 스크립트 포함을 생성합니다.

이 예시에서는 Groovy(사용 중단)를 사용합니다. Groovy에는 스크립트 포함 대신 JavaScript를 사용하는 것이 좋습니다.

다음 메서드를 구현합니다.
- @Override OperationStatus testConnection()
- @Override OperationStatus execute()
ThirdPartyConnector를 확장하도록 클래스를 디자인합니다.
```
 public class HypericConnector extends ThirdPartyConnector
```

이벤트 생성, 전송, 로깅, 타사 커넥터 기본 클래스에 대한 플랫폼 클래스를 임포트합니다.


package com.service_now.mid.probe.tpcon.test

import com.glide.util.Log
import com.service_now.mid.MIDServer
import com.service_now.mid.probe.event.IEventSender
import com.service_now.mid.probe.event.SNEventSender
import com.service_now.mid.probe.tpcon.OperationStatus
import com.service_now.mid.probe.tpcon.OperationStatusType
import com.service_now.mid.probe.tpcon.ThirdPartyConnector
import com.snc.commons.eventmgmt.Event

수집기에서 제공하는 API를 사용하여 SCOM 또는 VMware vRealize Hyperic(Hyperic) 등의 데이터 수집기에 연결합니다.

매개변수를 context 사용하여 커넥터 인스턴스에서 가져온 이벤트 필드 값을 설정합니다.


def authString = (context.username + ':'+ context.password).getBytes().encodeBase64().toString()
def urlStr = 'http://'+context.host + ':' + context.parameters.port + '/' + apiFunction

스크립트에서 execute 함수를 구현합니다.

API를 사용하여 커넥터에서 이벤트를 읽고 이벤트 객체를 생성하고 인스턴스로 ServiceNow 보냅니다. 예:


GPathResult alertsResponse1 = readAlerts('hqu/hqapi1/alert/find.hqu?begin=' + lastSignatureStr +
'&end='+ tillStr +'&count=1000000&severity=1&inEscalation=false&notFixed=false');
Event event = new Event()
event.emsSystem = context.name
event.source = "Hyperic"
event.description = it.@reason
event.type = it.@name
...
IEventSender eventSender = MIDServer.getSingleton(SNEventSender.class)
    for (Event event  : list) {
        eventSender.sendEvent(event)
     }

다음으로 이동 MID 서버 > MID 서버 스크립트 파일 스크립트를 생성합니다.
상위 필드Groovy를 '로 지정하고, 양식을 적절하게 작성한 다음 제출을 클릭합니다.
다음으로 이동 이벤트 관리 > 통합 > 커넥터 정의 및 커넥터 정의를 생성합니다.
실행할 Groovy 스크립트 필드에서 MID 서버 스크립트 파일을 선택하고 양식을 적절하게 작성합니다.
사용자 이름 또는 호스트 외에 다른 매개변수(예: 포트)를 추가한 다음 제출을 클릭할 수 있습니다.
다음으로 이동 이벤트 관리 > 통합 > 커넥터 인스턴스 및 커넥터 인스턴스를 생성합니다.
커넥터 정의 필드에서 커넥터 정의를 선택하고 양식을 적절하게 작성한 다음 제출을 클릭합니다.
스크립트를 확인하거나 디버그하려면 MID 서버 로그에 Groovy의 인쇄물 디버그를 사용하십시오.
사용자 지정 커넥터 인스턴스를 사용하여 수신 이벤트를 모니터링하려면 ECC > 큐 및 ConnectorProbe에서 필터링합니다.
사용자 지정 커넥터 정의를 생성합니다.
1. 다음으로 이동 모두 > 이벤트 관리 > 통합 > 커넥터 정의.
2. 새로 만들기를 클릭합니다.
3. 이름 필드에 커넥터 정의를 설명하는 이름을 입력합니다.
4. 스크립트 유형 필드에서 Javascript를 선택합니다.
5. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 선택합니다.
실행할 Javascript 필드는 자동으로 JavaScript 템플릿 파일의 이름으로 채워집니다.
기본 JavaScript 파일을 편집하려면 JavaScript 파일 이름 오른쪽에 있는 정보 아이콘( )을 클릭하고 다음 단계를 수행하십시오.
1. testConnection 함수에 필요한 정보를 지정합니다.
  이 함수는 커넥터 정의를 테스트하여 대상에 대한 연결이 유효한지 확인합니다.
2. execute 기능에 필요한 정보를 지정합니다.
  이 함수는 외부 소스에서 정보를 검색합니다.
3. retrieveKpi 함수에 필요한 정보를 지정합니다.
  이 함수는 외부 소스에서 메트릭 데이터를 검색합니다.
옵션: 기본 JavaScript를 원하는 JavaScript 코드로 바꿀 수 있습니다.

필드에 적절한 정보를 입력합니다.

표 1. 커넥터 정의 양식
필드	설명
기본 일정	이벤트 수신을 시도하는 간격(초)입니다.
양방향	경보가 변경되면 외부 모니터링 시스템이 업데이트되도록 지정합니다. SCOM에 대한 기본 구현이 있습니다.
경보 필드 식별자	수동으로 변경할 경우 외부 모니터링 시스템이 업데이트되도록 경보 필드를 지정합니다. 주: 이 필드는 양방향이 선택된 경우에만 나타납니다.
메트릭 수집	메트릭 수집을 사용하려면 선택합니다. 주: 메트릭은 SCOM 외부 이벤트 소스에 대해서만 수집됩니다.
메트릭 수집 기본 일정(초)	수집해야 하는 정보의 시간(초)을 지정합니다. 기본값은 10초입니다. 주: 이 필드는 메트릭 수집이 선택된 경우에만 나타납니다.
커넥터 매개변수	이벤트 서버와 통신할 수 있도록 매개변수를 지정합니다.
역량에 대한 MID 서버 커넥터 정의	MID 서버 이벤트 서버의 이벤트를 처리할 이름입니다. 지정하지 않으면 사용 가능 MID 서버 이 사용됩니다.

제출을 클릭합니다.