사용 구성 Kong Gateway용 API 서비스 그래프 커넥터SGC 센터

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 7분

    • 데이터를 Kong Gateway구성 관리 데이터베이스(CMDB).

    시작하기 전에

    ServiceNow Store 설치 단계는 ServiceNow Store 애플리케이션 설치를 참조하십시오. 에서 ServiceNow Store버전 2.0.0 이상을 설치합니다Kong Gateway용 API 서비스 그래프 커넥터.

    프로메테우스 연결을 설정하는 경우 에서 프로메테우스 플러그인 Kong Gateway 을 사용하도록 설정하고 필요한 자격 증명을 사용할 수 있는지 확인합니다. Prometheus 플러그인에 대한 자세한 내용은 개발자 설명서 사이트의 KongPrometheus를 참조하십시오.

    필요한 역할: 다음 표는 플레이북의 각 스테이지에 필요한 역할을 보여줍니다.
    표 1. 각 플레이북 스테이지에 필요한 역할
    스테이지 역할
    필수 구성요소 관리자
    설정 SGC-관리자(sn_cmdb_int_util.sgc_admin) 또는 관리자
    주:
    백그라운드 스크립트를 실행하고 SGC-Admin 사용자에게 전역 테이블에 대한 접근 권한을 제공하려면 관리자 사용자 역할이 필요합니다. 의 사용자 역할 서비스 그래프 커넥터에 대한 자세한 내용은 다음 문서를 참조하십시오 서비스 그래프 커넥터 사용자 역할.

    이 태스크 정보

    온보딩 커넥터에 대한 플레이북 경험은 에서 CMDB 작업 공간활성화됩니다SGC 센터. 애플리케이션을 구성하려면 SGC 센터 플레이북과 상호작용하는 방법에 대한 자세한 내용은 플레이북과 상호작용 섹션을 참조하십시오SGC 센터 구성.

    주:
    또는 의 설치된 연결 또는 초안 연결 SGC 센터에서 이미 사용할 수 있는 기본 연결을 구성할 수 있습니다. 이동 모두 > 서비스 그래프 커넥터을 클릭한 다음 메뉴에서 커넥터 설정을 선택합니다. 설치된 연결과 초안 연결에 대한 자세한 내용은 문서를 참조하십시오 에 추가된 서비스 그래프 커넥터 연결 관리 SGC 센터.

    프로시저

    1. 다음으로 이동 작업 공간 > CMDB 작업 공간.
    2. 에서 CMDB 작업 공간을 선택합니다 SGC 센터.
    3. 개요 페이지에서 연결 생성을 선택합니다.
      팁:
      또는 모든 연결 페이지에서 연결 만들기를 선택할 수 있습니다.
    4. 연결 생성 창에서 커넥터 유형을 선택한 Kong 다음 연결 생성을 선택합니다.
    5. 커넥터를 사용하여 처음으로 연결을 설정할 때 초기 필요 조건을 완료합니다.
      주:
      이 단계는 처음 설정하는 동안에만 필요합니다. SGC 센터에서 연결을 만들 때 초기 설정 작업 수행 문서를 참조하십시오.
    6. 인증을 위한 템플릿을 선택하여 연결을 생성합니다.
      1. 플레이북의 설정 단계에서 별칭 템플릿 선택 활동을 선택합니다.
      2. 템플릿 유형을 선택합니다.
        • Kong RBAC 인증: 토큰 기반 인증을 사용할 때 선택합니다.
        • Kong 기본 인증: 기본 인증을 사용할 때 선택합니다.
    7. 연결 상세 정보를 입력하고 데이터 임포트 Kong Gateway 를 위한 API 연결을 테스트합니다.
      1. 플레이북의 설정 단계에서 연결 생성 및 테스트 활동을 선택합니다.
      2. 양식에서 필드를 채웁니다.
        표 2. 연결 양식 생성 및 테스트
        필드 설명
        연결 이름 연결 기록을 식별하는 Kong Gateway 이름입니다.
        호스트 이름 Kong Admin API 서버의 관리자 URL 주소입니다.
        프로토콜 클라이언트와 Kong 서버 간의 보안 통신을 보장하는 연결에 사용되는 프로토콜입니다.
        기본 포트 재정의 Kong Admin API에서 사용하는 포트입니다.
        API 키 서비스에 연결하기 위한 인증 비밀입니다 Kong Gateway . 이 필드는 별칭 템플릿 선택 활동에서 Kong RBAC 인증을 선택한 경우에만 나타납니다.
        사용자 이름 Kong Gateway Admin API에 대한 요청을 인증하는 데 필요한 사용자 이름입니다. 이 필드는 별칭 템플릿 선택 활동에서 Kong 기본 인증을 선택한 경우에만 나타납니다.
        암호 요청을 인증하는 데 필요한 사용자 이름과 연결된 암호입니다. 이 필드는 별칭 템플릿 선택 활동에서 Kong 기본 인증을 선택한 경우에만 나타납니다.
      3. 연결 만들기 및 테스트를 선택합니다.
      4. 연결 테스트가 완료되면 계속을 선택합니다.
    8. 옵션: 연결에 대한 구성 속성을 설정합니다.
      1. 플레이북의 설정 단계에서 구성 속성 설정 활동을 선택합니다.
      2. 데이터 검색 구성 섹션에서 사용할 수 있는 필드에 Expand HTTP Method Types 경로에 고려할 GET, POST,PUT, PATCH,DELETE,OPTIONS,HEAD,CONNECT 및 TRACE를 포함한 HTTP 메서드를 입력합니다.
        여러 방법의 경우 쉼표로 구분합니다. 비워 두면 모든 표준 HTTP 메서드를 지원한다는 것을 나타내는 ALL 메서드를 사용하여 단일 API 프런트엔드가 생성됩니다.
      3. 속성 설정 섹션에서 사용할 수 있는 필드에 Exclude workspaces 임포트에서 제외해야 하는 작업 공간을 입력합니다.

        작업 공간이 여러 개인 경우 쉼표로 구분합니다. 예: workspace1,workspace2. 이 필드를 비워 두면 커넥터 내의 데이터 소스가 모든 작업 공간에서 데이터를 임포트합니다.

      4. 서비스에서 태그를 수집하려면 태그 설정 섹션에서 태그 임포트 확인란을 Kong Gateway 선택합니다.
        이 옵션을 선택하면 태그 값 구분 기호 필드에 태그에 대한 키-값 쌍 구분 기호를 지정합니다. 선택하지 않으면 태그를 가져오지 않습니다.
      5. 태그 설정 섹션에서 사용할 수 있는 태그 값 구분자 필드에 태그의 키와 값에 대한 구분 기호를 입력합니다.
        예를 들어 태그 값 구분 기호가 =로 설정된 경우 env=prod 태그는 env 를 키로, prod 를 값으로 사용하여 저장됩니다.

        비워 두면 태그가 수집되지 않습니다.

      6. 사용량 데이터 수집을 활성화하여 지정된 기간 동안 API 사용량 데이터를 검색하려면 메트릭 설정 섹션에서 사용 데이터 수집 확인란을 선택합니다.
      7. 메트릭 설정 섹션에서 사용할 수 있는 수집 기간(일) 필드에 API 사용량 데이터 수집 기간(일)을 입력합니다.
      8. 계속을 선택합니다.
    9. 옵션: 프로메테우스 연결 상세 정보를 입력하고 프로메테우스 플러그인을 사용하여 메트릭 데이터를 임포트 Kong Gateway 하기 위한 API 연결을 테스트합니다.
      주:
      프로메테우스를 통한 API 사용량 모니터링이 필요하지 않거나 기존 프로메테우스 인스턴스를 사용하는 경우 이 단계를 건너뛸 수 있습니다. 이 단계를 건너뛰려면 프로메테우스 연결 생성 및 테스트 활동에 대해 건너뛰기를 선택합니다.
      1. 플레이북의 설정 스테이지에서 프로메테우스 연결 생성 및 테스트 활동을 선택합니다.
      2. 양식에서 필드를 채웁니다.
        표 3. 프로메테우스 연결 생성 및 테스트 양식
        필드 설명
        연결 이름 프로메테우스 연결 기록을 식별하는 이름입니다.
        연결 URL 메트릭을 가져오는 데 사용되는 프로메테우스 HTTP API의 기본 URL입니다.
        사용자 이름 프로메테우스 서버에 대한 요청을 인증하는 데 필요한 사용자 이름입니다.
        암호 프로메테우스 서버에 대한 요청을 인증하는 데 필요한 사용자 이름과 관련된 암호입니다.
      3. 연결 만들기 및 테스트를 선택합니다.
      4. 연결 테스트가 완료되면 계속을 선택합니다.
    10. 옵션: 프로메테우스 연결을 연결과 Kong Gateway 연결합니다.
      주:
      프로메테우스를 사용한 API 사용량 모니터링이 필요하지 않은 경우 이 단계를 건너뛸 수 있습니다. 이 단계를 건너뛰려면 Kong Prometheus 매핑 활동에 대해 건너뛰기를 선택합니다.
      1. 플레이북의 설정 스테이지에서 Kong 프로메테우스 매핑 활동을 선택합니다.
      2. 프로메테우스 연결 필드에서 연결할 프로메테우스 연결을 검색하고 선택합니다.
        단계에서 9 작성된 프로메테우스 연결을 선택하거나 이 단계에서 기존 프로메테우스 연결을 선택할 수 있습니다. 단계를 9건너뛰는 경우 기존 프로메테우스 연결을 선택합니다.
      3. 제출을 선택합니다.
      프로메테우스 연결은 여러 Kong Gateway 연결과 연결될 수 있습니다. 뷰에서 언제든지 연결의 Kong Gateway 프로메테우스 매핑을 업데이트할 수 있습니다 SGC 센터 . SGC 센터 에서 연결 서비스 그래프 커넥터업데이트 문서를 참조하십시오.
    11. 데이터를 정기적으로 임포트하도록 임포트 일정을 구성합니다.
      1. 플레이북의 설정 단계에서 임포트 일정 구성 활동을 선택합니다.
      2. 임포트 일정 구성을 선택합니다.
      3. 임포트 일정 목록에서 상위 예약된 데이터 임포트를 확장하여 연결과 연결된 SG-Kong Gateway 임포트 일정을 선택합니다.
        주:
        연결 이름은 일정 이름 앞에 붙습니다.
      4. 임포트 일정 구성 대화 상자에서 활성 확인란을 선택한 다음, 실행 일정 및 시간 상세 정보를 입력합니다.

        자세한 내용은 Schedule a data import 문서를 참조하십시오.

      5. 저장을 선택합니다.
        또는 지금 실행을 선택하여 임포트 일정을 즉시 실행합니다.
      6. 계속을 선택합니다.
    12. 플레이북의 설정 스테이지에서 연결 생성 확인 활동을 선택하여 연결이 구성되었는지 확인합니다.

    다음에 수행할 작업

    모든 연결 보기를 선택하여 연결 세부 정보를 검토합니다. 연결 및 프로메테우스 연결을 포함하여 Kong Gateway 구성된 연결(생성된 경우)이 설치된 연결 목록에 나타납니다.

    그런 다음 SGC 센터CMDB 작업 공간. 자세한 내용은 에 추가된 서비스 그래프 커넥터 연결 관리 SGC 센터 문서를 참조하십시오.