OpenTelemetry용 서비스 그래프 커넥터 구성

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

    • (이전의 Lightstep)에서 ServiceNow 클라우드 옵저버빌리티 데이터를 끌어오도록 구성 관리 데이터베이스(CMDB)예약된 임포트 작업을 설정합니다.

    시작하기 전에

    이를 서비스 그래프 커넥터사용하려면 (ITOM) 가시성 애플리케이션 또는 ITOM 검색 애플리케이션을 기반으로 하는 구독 단위에 IT Operations Management 대한 구독이 필요합니다. 구독에 대한 ServiceNow 구독 단위 개요의 "관리형 IT 자원 유형" 섹션에 정의된 바와 같이, 이 서비스 그래프 커넥터페이지에서 생성 또는 수정 CMDB 되었지만 아직 ITOM 가시성 또는 ITOM 디스커버리로 관리되지 않는 관리형 IT 자원의 경우 이러한 자원은 해당 애플리케이션의 구독 단위 소비를 증가시킵니다. ITOM 가시성 또는 ITOM 디스커버리 내에서 현재 구독 단위 사용량을 검토하여 사용 가능한 용량을 확인합니다.

    의존성 및 요구사항:
    • 자동으로 설치되는 Integration Commons for CMDB 스토어 앱입니다.
    • 자동으로 설치되는 CMDB CI Class Models 스토어 앱입니다. CMDB CI 클래스 모델 문서를 참조하십시오.
    • ITOM 검색 라이센스 플러그인(com.snc.itom.discovery.license). 이 플러그인을 활성화해야 합니다.
    • ITOM 라이선싱 플러그인(com.snc.itom.license). 자세한 내용은 검색 요청을 참조하십시오.
    • 자동으로 설치되는 Datastream 작업 플러그인(com.glide.hub.action_type.datastream)입니다.
    • 이벤트 수집에만 필요한 sn_observability(Observability Commons CMDB )입니다. 이벤트 관리가 작동하려면 커넥터를 설치하기 전에 앱에 대한 CMDB 옵저버블 커먼즈를 설치해야 합니다. 자세한 내용은 의 CMDB에 대한 Observability Commons 를 ServiceNow Store참조하십시오.
    주:
    이전 버전의 가 OpenTelemetry용 서비스 그래프 커넥터있는 경우 이전 커넥터에서 데이터를 마이그레이션하지 마십시오. 이전 버전을 제거하고 새 통합을 실행해야 합니다.

    필요한 역할: 관리자

    프로시저

    1. 애플리케이션 선택기를 OpenTelemetry용 서비스 그래프 커넥터 사용하여 애플리케이션 범위를 설정했는지 확인합니다.
      자세한 내용은 애플리케이션 선택기를 참조하십시오.
    2. 다음으로 이동 모두 > 서비스 그래프 커넥터 > OpenTelemetry > 설정.
    3. 시작하기 페이지에서 시작하기를 선택합니다.
    4. 애플리케이션 속성을 구성하여 API에 ServiceNow 클라우드 옵저버빌리티 요청을 보내기 위한 조직 및 인증 자격 증명을 설정합니다.
      1. OpenTelemetry용 서비스 그래프 커넥터 페이지의 연결 구성 섹션에서 시작을 선택합니다.
      2. OpenTelemetry 사용 작업의 경우 애플리케이션이 지식베이스의 Now SupportServiceNow 클라우드 식별 가능성 설정 [KB1527588] 문서에 설명된 조건을 충족하는지 확인합니다클라우드 옵저버빌리티.
        중요사항:
        커넥터를 설치하는 동안 나중에 사용할 애플리케이션의 프로젝트, 조직 및 API 키 세부 정보를 클라우드 옵저버빌리티 기록해 둡니다.
        애플리케이션에서 환경을 클라우드 옵저버빌리티 설정한 OpenTelemetry 후 안내 설정으로 돌아가서 완료로 표시를 선택하여 OpenTelemetry 사용 작업을 완료로 표시합니다.
      3. 클라우드 옵저버빌리티 프로젝트, 자원 및 의존성 매핑 정보를 검색할 조직 상세 정보를 입력합니다.
        1. 조직 설정 작업에 대해 구성을 선택합니다.
        2. 서비스 그래프 연결 속성 양식의 값 필드에 조직 이름을 클라우드 옵저버빌리티 입력합니다.
        3. 업데이트를 선택합니다.
        4. 완료로 표시를 선택하여 조직 설정 작업을 완료하도록 표시합니다.
      4. 애플리케이션과 연결된 클라우드 옵저버빌리티 API 키 상세 정보를 입력합니다.
        1. API 키 설정 작업의 경우 구성을 선택합니다.
        2. API 키 자격 증명 양식의 API 키 필드에 단계에서 4.b적어 둔 애플리케이션과 연결된 클라우드 옵저버빌리티 API 키를 입력합니다.
        3. 업데이트를 선택합니다.
        4. 완료로 표시를 선택하여 API 키 설정 작업을 완료하도록 설정합니다.
      5. API 연결을 테스트하여 클라우드 옵저버빌리티 애플리케이션에서 데이터를 임포트합니다 클라우드 옵저버빌리티 .
        1. 연결 테스트 작업의 경우 구성을 선택합니다.
        2. 연결 테스트 관련 링크를 선택합니다.
        3. 상태 필드가 성공으로 설정되면 X를 선택하여 연결 테스트 대화 상자를 닫고 안내 설정 페이지로 돌아갑니다.

          테스트에 오류가 있는 경우, 수정 제안을 따르십시오.

        4. 완료로 표시를 선택하여 연결 테스트 작업을 완료하도록 설정합니다.
      6. 조직에 포함된 클라우드 옵저버빌리티 모든 프로젝트를 검색합니다.
        1. 프로젝트 가져오기 작업에 대해 구성을 선택합니다.
        2. 프로젝트 가져오기를 선택합니다.
        3. 프로젝트 속성 관련 목록이 단계에서 4.c.ii지정한 조직에 포함된 모든 프로젝트로 채워지면 X를 선택하여 프로젝트 가져오기 대화 상자를 닫고 안내 설정 페이지로 돌아갑니다.
        4. 완료로 표시를 선택하여 프로젝트 가져오기 작업을 완료로 설정합니다.
    5. 옵션: 추가 구성을 구성하여 조사 기간을 설정하고, 제외된 프로젝트를 추가하고, 프로젝트 진단을 실행하고, 서비스 맵과 부실 구성 항목(CI)에 대한 통합 설정을 구성합니다.
      1. OpenTelemetry용 서비스 그래프 커넥터 페이지의 고급 설정 섹션에서 계속을 선택합니다.
      2. 프로젝트에서 자원을 검색할 시점의 조사 기간을 설정합니다.

        조사 기간은 조직의 프로젝트에서 자원을 검색하기 위한 시작 및 종료 시간을 계산하는 데 사용되며 예약된 작업 빈도 설정과 일치해야 합니다. 예를 들어 조사 기간을 12시간으로 설정하면 시작 시간에서 현재 시간을 뺀 12시간을 뺀 값으로 계산된 시작 시간부터 현재 시간인 종료 시간까지 자원이 검색됩니다.

        1. 조사 기간 설정 작업에서 구성을 선택합니다.
        2. 서비스 그래프 연결 속성 양식의 값 필드에 조사 기간을 시간 단위로 입력합니다.
        3. 업데이트를 선택합니다.
        4. 완료로 표시를 선택하여 조사 기간 설정 작업을 완료하도록 설정합니다.
      3. 자원을 검색하지 않을 프로젝트를 선택합니다.
        1. 제외된 프로젝트 추가 작업에서 구성을 선택합니다.
        2. 프로젝트 열에서 프로젝트를 선택합니다.
        3. 프로젝트 제외 확인란을 선택합니다.
        4. 업데이트를 선택합니다.
        5. 제외하려는 각 프로젝트에 대해 5.c.ii 의 5.c.iv 단계를 반복합니다.
        6. 제외된 프로젝트 추가 대화 상자를 닫고 안내 설정 페이지로 돌아가려면 X를 선택합니다.
        7. 완료로 표시를 선택하여 제외된 프로젝트 추가 작업을 완료로 설정합니다.
      4. 프로젝트 진단을 실행하여 자원 API 응답을 테스트하고 API에 클러스터 이름, Kubernetes 네임스페이스 및 Kubernetes 노드가 포함되어 Kubernetes 있는지 확인합니다.
        1. 프로젝트 진단 실행 작업에 대해 구성을 선택합니다.
        2. 프로젝트 열에서 프로젝트를 선택합니다.
        3. 진단 실행을 선택합니다.
        4. 진단 상태 필드가 성공으로 설정되면 X를 선택하여 프로젝트 진단 실행 대화 상자를 닫고 안내 설정 페이지로 돌아갑니다.

          진단 테스트에 오류가 있는 경우 진단 메시지 필드의 지시에 따라 오류를 해결합니다.

        5. 진단을 실행할 각 프로젝트에 대해 5.d.iv 이 단계를 5.d.ii 반복합니다.
        6. 완료로 표시를 선택하여 프로젝트 진단 실행 작업을 완료로 설정합니다.
      5. 서비스 맵 및 부실 CI에 대한 시스템 속성을 구성합니다.
        1. 커넥터 작업에 대한 시스템 속성 구성 작업에서 구성을 선택합니다.
        2. 속성의 기본값을 확인하거나 사용자 지정 구성의 값을 입력합니다.
        3. 저장을 선택합니다.
        4. 완료로 표시를 선택하여 커넥터 작업에 대한 Configure system properties(시스템 속성 구성)를 완료로 설정합니다.
    6. 애플리케이션에서 전체 또는 증분 데이터를 클라우드 옵저버빌리티 임포트하도록 예약된 작업을 구성합니다.
      1. OpenTelemetry용 서비스 그래프 커넥터 페이지의 예약된 임포트 작업 구성 섹션에서 계속을 선택합니다.
      2. 전체 데이터 임포트를 위해 예약된 작업을 활성화합니다.

        기본적으로 OpenTelemetry Resources 예약된 작업은 전체 데이터 임포트에 사용할 수 있습니다. 그러나 작업을 활성화해야 합니다.

        1. 전체 임포트를 위해 예약된 작업 구성 작업의 경우 구성을 선택합니다.
        2. 예약된 작업에 대한 OpenTelemetry Resources 예약된 데이터 임포트 양식에서 예약된 작업의 필드 값을 확인하고 활성 확인란을 선택합니다.

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

        3. 업데이트를 선택합니다.
        4. 안내 설정에서 완료로 표시를 선택하여 전체 임포트 작업에 대한 예약된 작업 구성을 완료하도록 설정합니다.
      3. 옵션: 델타 데이터 임포트를 위해 예약된 작업을 활성화합니다.

        기본적으로 OpenTelemetry Delta Resources 예약된 작업은 델타 데이터 임포트에 사용할 수 있습니다. 그러나 작업을 활성화해야 합니다.

        주:
        다음 시나리오에서는 델타 데이터 끌어오기가 발생하지 않습니다.
        • 전체 데이터 임포트가 동시에 예약됩니다.
        • 데이터 소스의 마지막 실행 날짜/시간 필드가 비어 있습니다.
        • 마지막 델타 데이터 끌어오기 기간이 3일 이상입니다.
        1. 델타 임포트 작업에 대한 예약된 작업 구성의 경우 구성을 선택합니다.
        2. 예약된 작업에 대한 OpenTelemetry Delta Resources 예약된 데이터 임포트 양식에서 예약된 작업의 필드 값을 확인하고 활성 확인란을 선택합니다.

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

        3. 업데이트를 선택합니다.
        4. 안내 설정에서 완료로 표시를 선택하여 델타 임포트 작업에 대한 예약된 작업 구성을 완료하도록 설정합니다.
      주:
      자원을 검색하기 위해 새 프로젝트를 추가할 때 델타 임포트를 실행하기 전에 전체 임포트를 수행하여 부분 데이터를 방지하고 정확하게 채워 CMDB 야 합니다.
    7. 애플리케이션에서 애플리케이션으로 클라우드 옵저버빌리티 이벤트를 전송하여 ServiceNow 이벤트 관리 경보 및 이벤트를 관리합니다.
      Observability Commons for CMDB 애플리케이션이 설치된 경우에만 경보 및 이벤트를 관리할 수 있습니다.
      주:
      이 기능을 활성화하려면 유료 클라우드 옵저버빌리티 라이센스가 필요하지만 비프로덕션 환경에서 제품을 평가하기 위해 무료 계정에서도 이 기능을 사용할 수 있습니다. 자세한 내용은 계정 담당자에게 문의 ServiceNow 할 수 있습니다.
      1. OpenTelemetry용 서비스 그래프 커넥터 페이지의 경보 및 이벤트 관리 섹션에서 계속을 선택합니다.
      2. 프로젝트에 대한 웹후크 대상을 생성합니다.
        1. 웹후크 생성 작업에서 구성을 선택합니다.
        2. 프로젝트 열에서 제외되지 않은 프로젝트를 선택합니다.
        3. 웹후크 생성을 선택하여 애플리케이션에 웹후크 대상을 클라우드 옵저버빌리티 생성합니다.
        4. 성공 메시지가 나타나면 X 를 선택하여 웹후크 생성 대화 상자를 닫고 안내 설정 페이지로 돌아갑니다.

          웹후크가 성공적으로 생성되면 다음을 수행합니다.

          • 시스템은 인스턴스의 각 웹후크 대상 ServiceNow 에 대한 사용자 기록을 자동으로 생성합니다.
          • 사용자 기록의 사용자 이름은 ls_api_로 시작하고<project_name> 사용자에게 evt_mgmt_integration 역할이 할당됩니다.
        5. 웹후크를 생성할 각 프로젝트에 대해 이 7.b.iv 단계를 7.b.ii 반복합니다.
        6. 안내 설정에서 완료로 표시를 선택하여 웹후크 생성 작업을 완료로 설정합니다.
      3. CMDB에서 일치하는 CI가 없는 이벤트를 수집하기 위한 시스템 속성을 구성합니다.
        1. 일치하지 않는 CI에 대한 속성 구성 작업에 대해 구성을 선택합니다.
        2. 값 필드에 true를 입력합니다.
        3. 업데이트를 선택합니다.
        4. 안내 설정에서 완료로 표시를 선택하여 일치하지 않는 CI에 대한 속성 구성 작업을 완료하도록 설정합니다.