사용자 지정 커넥터 구성

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분

    • 사용자 지정 커넥터를 데이터 소스로 인증하여 이벤트 정보를 ServiceNow 인스턴스에 밀어넣을 수 있도록 합니다. 상세 정보 및 매핑 필드를 제공하여 사용자 지정 커넥터를 정의합니다. 이렇게 하면 사용자 지정 커넥터의 이벤트 메시지에서 추출된 정보가 필요한 이벤트 필드를 채울 수 있습니다. 마지막으로 사용자 지정 커넥터 웹후크에 대한 URL을 생성하고 제공합니다.

    시작하기 전에

    • 이벤트 관리 커넥터(sn_em_connector) 플러그인이 Now Platform 인스턴스에 설치되어 있는지 확인합니다. 자세한 내용은 이벤트 관리 커넥터 구성 문서를 참조하십시오.
    • 사용자 지정 커넥터에서 관리하는 호스트의 구성 항목이 Now Platform 인스턴스에 있는지 확인합니다. 이러한 CI는 실제 또는 가상일 수 있으며 IP 검색 또는 클라우드 디스커버리를 통해 검색하거나 수동으로 만들 수 있습니다. 자세한 내용은 ITOM 제품의 클라우드 환경에 액세스 문서를 참조하십시오.

    필요한 역할: evt_mgmt_admin

    이 태스크 정보

    ServiceNow 인스턴스에 이벤트 정보 밀어넣기를 시작하려면 사용자 지정 커넥터의 표준 웹후크를 사용하여 Now Platform 인스턴스를 REST 엔드포인트로 설정해야 합니다.

    커넥터 상세 정보 및 매핑 필드를 제공하여 사용자 지정 커넥터를 정의합니다. 그런 다음 사용자 지정 커넥터의 이벤트 메시지에서 추출된 정보가 필요한 이벤트 필드를 채우고 이벤트를 데이터베이스에 삽입합니다.

    URL은 ServiceNow 인스턴스와 사용자 지정 커넥터를 기반으로 코드에 의해 생성됩니다. 이 URL을 사용하여 사용자 지정 커넥터에서 ServiceNow 인스턴스로 이벤트를 보낼 수 있는 웹후크를 생성합니다.

    프로시저

    1. 다음으로 이동 작업 공간 > 서비스 운영 작업 공간.
    2. 왼쪽 창에서 통합 시작 패드 아이콘(통합 시작 패드 아이콘)을 선택합니다.
    3. 통합 찾아보기 탭에서 모든 통합 드롭다운 목록을 선택하고 사용자 지정을 선택합니다.
      사용자 지정 커넥터 타일만 표시됩니다.
      그림 1. 밀어넣기 커넥터
      사용자 지정 커넥터로 필터링
    4. 사용자 지정 커넥터 유형 타일을 선택합니다.
    5. 상세 정보 제공 페이지에서 커넥터에 대한 상세 정보를 제공합니다.
      그림 2. 사용자 지정 커넥터 상세 페이지
      사용자 지정 커넥터 상세 페이지
      1. 커넥터 이름 필드에 커넥터의 고유한 통합 이름을 입력합니다.
      2. 옵션: 태그 필드에 태그를 입력하여 고속 목록에서 이 유형의 커넥터를 찾고 식별할 수 있습니다.
        태그를 더 추가하려면 태그 필드 옆에 있는 더하기 아이콘(태그 추가를 위한 더하기 기호)을 선택합니다. 태그 추가 창이 열립니다.
        1. 키 필드에 태그 키를 입력합니다.
        2. 값 필드에 태그 값을 입력합니다.
        3. 추가를 선택합니다.
      3. 옵션: 설명 필드에 이 커넥터에 대한 간략한 정보를 입력합니다.
      4. 소스 필드에 외부 이벤트 소스에서 이벤트를 수집하는 데 사용할 벤더를 입력합니다.

        소스 필드는 커넥터를 식별하고, 커넥터가 활성화되면 이벤트 및 경보의 소스를 인식하는 식별자 역할을 합니다.

      5. 옵션: 할당 그룹 드롭다운 목록에서 커넥터 관리 및 유지 보수를 담당하는 그룹 또는 팀을 선택합니다.
    6. 옵션: 커넥터 타일에 표시할 이미지를 끌어서 업로드합니다.
      • 이미지를 상자로 드래그합니다.
      • 이미지 업로드를 선택하여 이미지 파일을 찾은 다음 파일을 선택합니다.
      최대 업로드 파일 크기는 1MB입니다.
    7. 이벤트를 ITOM 인스턴스에 직접 연결할지 아니면 MID 서버를 통해 연결할지 결정합니다.

      • 이벤트를 ITOM 인스턴스로 직접 전송하려면 ITOM 인스턴스로 직접을 선택합니다.

      • 이벤트 메시지를 처리한 다음 인스턴스로 이벤트를 전달하는 MID 서버를 통해 이벤트를 보내려면 MID 서버를 통해를 선택합니다.

        MID 서버가 있는 경우 MID 서버 선택 필드에서 이벤트 수신기와 연결된 사용 가능한 MID 서버를 선택합니다.

        MID 서버를 만들어야 하는 경우 다음 중 하나를 선택합니다.
        • MID 웹 서버 확장 구성
        • MID 웹 서비스 이벤트 수집기 컨텍스트 구성
        자세한 내용은 MID 웹 서버 확장 구성 및 MID WebService 이벤트 수집기 컨텍스트 구성 문서를 참조하십시오.
    8. 다음을 선택합니다.
      사용자 지정 커넥터 입력 방법
    9. 입력 방법 설정 페이지에서 이벤트 데이터를 수집하는 방법을 선택합니다.
      방법설명
      실제 소스 이벤트를 수집해 필드 정의
      1. 실제 소스 이벤트를 수집해 필드 정의를 선택합니다.
        주:
        사용자 지정 커넥터에서 실제 소스 이벤트를 수집하여 여러 이벤트를 참조로 사용하여 필드를 정의함으로써 이벤트 및 경보 정확도를 높입니다.
      2. 클립보드에 복사를 선택하여 URL을 복사합니다.
      3. URL을 사용자 지정 커넥터의 웹후크 설정에 붙여넣어 사용자 지정 커넥터가 ServiceNow 인스턴스에 이벤트를 보낼 수 있는 웹후크를 생성합니다. 모니터링 시스템의 웹훅 구성에 기본 인증 자격 증명(예: 사용자 이름 및 암호)을 입력합니다. 웹후크를 사용하면 사용자 지정 커넥터에서 인스턴스로 이벤트를 보낼 수 있습니다.
      4. 이벤트 확인을 선택합니다. 이벤트 수가 표시됩니다. 이벤트가 JSON 파일을 생성하며 다음을 선택한 후 찾아볼 수 있습니다.
      JSON 샘플을 사용하여 필드 매핑
      1. JSON 샘플을 사용하여 필드 매핑을 선택합니다.
        주:
        샘플 JSON이 있는 경우에만 이 옵션을 선택합니다.
      2. 페이로드 입력 대화 상자에서 JSON 샘플 페이로드를 복사하고 붙여 넣어 필드를 매핑하기 위한 매핑을 만들고 봅니다.
        사용자 지정 커넥터 JSON 페이로드 업로드
      3. JSON 업로드를 선택합니다.
      4. 새 JSON 편집 또는 붙여넣기를 선택하여 업로드한 JSON을 편집하거나 새 JSON을 붙여넣습니다.
      5. 클립보드에 복사를 선택하여 URL을 복사합니다.
      6. URL을 사용자 지정 커넥터의 웹후크 설정에 붙여넣어 사용자 지정 커넥터가 ServiceNow 인스턴스에 이벤트를 보낼 수 있는 웹후크를 생성합니다. 모니터링 시스템의 웹훅 구성에 기본 인증 자격 증명(예: 사용자 이름 및 암호)을 입력합니다. 웹후크를 사용하면 사용자 지정 커넥터에서 인스턴스로 이벤트를 보낼 수 있습니다.
    10. 다음을 선택합니다.
      필드를 매핑할 수 있는 페이지가 열립니다.
      사용자 지정 커넥터 필드 매핑 옵션 페이지.
    11. 맵 필드 페이지의 커넥터 필드 이름 열에서 ServiceNow 심각도 필드 열에 나열된 심각도 값에 매핑되는 값을 하나 이상 입력합니다.
    12. 맵 필드 페이지의 커넥터 필드 이름 열에서 ServiceNow 심각도 필드 열에 나열된 심각도 값에 매핑되는 값을 하나 이상 입력합니다.

      JSON 코드 샘플의 심각도 값을 입력할 수 있습니다. 심각도 값을 설정하려면 사용자 지정 커넥터의 페이로드와 해당 커넥터가 지원하는 심각도 유형을 잘 알고 있어야 합니다. 받은 이벤트의 심각도 값은 시스템에서 생성된 이벤트와 일치해야 합니다.

      JSON 코드 샘플의 필드를 ServiceNow 필드에 매핑하여 시스템이 수신 데이터에서 이벤트를 올바르게 생성할 수 있도록 합니다. 사용자의 시간과 노력을 절약하기 위해 심각도 및 메시지 키 정보가 자동으로 채워집니다. 메시지 키는 이벤트에 대한 올바른 식별자를 제공하여 중복 제거가 올바르게 작동하고 중복 경보가 생성되지 않도록 합니다.

    13. 옵션: 여러 JSON 파일을 보려면 JSON 샘플 위의 화살표를 선택합니다.
    14. 옵션: 기타 필드 섹션의 커넥터 열은 선택 사항이지만 이벤트에 대한 추가 정보를 제공하는 사용자 지정 이벤트 매개변수를 지정합니다.
      선택적 정보를 제공하지 않으려면 필드를 비워 둡니다.
      1. 설명 필드에 의미 있는 경보 설명을 입력합니다.
      2. 메트릭 이름 필드에 이벤트를 성능 메트릭 또는 경보를 트리거한 KPI와 연결할 수 있는 메트릭 이름을 입력합니다.
      3. 노드 필드에 CI 바인딩에 사용할 노드 값을 입력합니다.
      4. 이벤트 시간 필드에 사용자 지정 커넥터 이벤트의 생성 시간을 입력합니다.
        이벤트 시간이 매핑되지 않은 경우 시스템은 기본 이벤트 시간을 사용합니다.
      5. 이벤트 시간 설정 필드에서 시간 형식과 이벤트 시간대를 선택합니다.
        • 시간 형식: 최대 길이가 40자인 UTC 또는 GMT 형식의 GlideDateTime 필드입니다.
        • 시간대: 시간은 UTC(Coordinated Universal Time)에 저장되며 시스템 시간대를 기준으로 전역으로 표시됩니다.
    15. 활성화를 선택하여 커넥터를 활성화하고 저장한 다음 확인 팝업 창에서 확인을 선택합니다.
      상세 정보 탭에서 커넥터 상세 정보를 보고 필드 매핑 탭에서 필드 매핑을 볼 수 있습니다.

    결과

    커넥터가 활성화되면 사용자 지정 커넥터 콘솔에서 ServiceNow 인스턴스로 이벤트가 플로우되기 시작합니다. 플러그인은 원본 사용자 지정 커넥터 이벤트 메시지에서 정보를 추출하여 필요한 이벤트 필드를 채우고 이벤트를 데이터베이스에 삽입합니다. Now Platform 인스턴스의 이벤트를 보려면 모든 이벤트로 이동합니다. 자세한 내용은 이벤트 보기 문서를 참조하십시오.

    다음에 수행할 작업

    프로세스가 성공적으로 완료되어 이벤트가 시스템에 유입되고 있는지 확인하려면 관련 이벤트 탭에서 관련 이벤트를 봅니다. 설정이 성공하면 자동화 추가를 진행하여 경보 자동화를 설정합니다. 경보 자동화에 대한 자세한 내용은 ITOM용 서비스 운영 작업 공간의 경보 자동화 문서를 참조하십시오.