클라우드 API 트레일

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 3분
  • 클라우드 API 트레일은 클라우드 API를 사용하는 모든 활동에 대한 활동 로그이며 MID 서버를 거칩니다.

    클라우드 API 트레일 내용

    그림 1. CAPI 트레일 양식
    클라우드 API 트레일 양식
    필드 설명
    동적 경로 ID 항목의 자동 생성된 ID 번호입니다.
    Mid 이름 디스커버리이(가) 수행된 MID 서버의 이름입니다.
    경로 상태 API가 실행한 디스커버리 작업의 성공 여부입니다. 가능한 값:
    • 성공
    • 오류
    • 실행
    입력 매개변수 API 트레일 레코드를 생성한 입력 매개변수입니다. 이 값은 일반적으로 디스커버리이(가) 실행된 데이터센터입니다.
    인터페이스 이름
    호출한 사람 이 값은 디스커버리을(를) 실행할 때 항상 CMP입니다.
    메서드 이름 이 레코드를 처리한 클라우드 API의 인터페이스 작업입니다.
    제공자 이름 클라우드 제공자입니다.
    버전 클라우드 API에 지정된 버전입니다.

    CAPI 트레일 로그

    CAPI 트레일 로그 관련 목록은 클라우드 API 트레일 항목에 대한 상세 정보를 제공합니다. 다음과 같은 유형의 로그 키를 사용할 수 있습니다.

    로그 키 설명
    route_data 클라우드 API 호출에 대한 정보입니다.
    dynamic_route URI를 포함하여 데이터가 실제로 사용한 경로에 대한 정보입니다.
    route_result 인스턴스가 받은 페이로드 또는 데이터 전송 결과에 대한 설명입니다. 페이로드는
    chunk_number 인스턴스가 받은 데이터 청크의 수입니다.
    route_status 루트 연결 및 페이로드 전송의 성공 여부입니다.
    route_error 발생한 오류입니다. 예를 들어 Failed to list loadbalancer Failed : HTTP 오류 코드 : 403 오류는 자격 증명이 잘못되어 디스커버리이(가) 클라우드 자원에 액세스할 수 없다는 의미합니다.
    error_detail 시도한 디스커버리에서 사용된 클라우드 프로비저닝 및 거버넌스 API 및 커넥터를 포함한 오류 및 클라우드 제공자가 throw한 오류에 대한 자세한 내용입니다.
    route_error의 예는 다음과 같습니다.
    Failed to list loadbalancer Failed : HTTP error code : 403

    같은 오류에 대한 error_detail 항목의 예는 다음과 같습니다.

    com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerException: Failed to list loadbalancer Failed : HTTP error code : 403
           at com.snc.cmp.connector.cloud.loadbalancer.customizer.impl.AWSLoadBalancerCustomizer.listLoadBalancers(AWSLoadBalancerCustomizer.java:56)
    	at com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerProducer.process(LoadBalancerProducer.java:46)
    	at org.apache.camel.util.AsyncProcessorConverterHelper$ProcessorToAsyncProcessorBridge.process(AsyncProcessorConverterHelper.java:61)
           at org.apache.camel.processor.SendProcessor.process(SendProcessor.java:145)
           ...

    이 두 항목은 자격 증명이 잘못되어 디스커버리가 클라우드 자원에 액세스할 수 없음을 나타냅니다. 부하 분산 장치가 클라우드 자원에 대한 액세스를 허용하는 첫 번째 장치이므로 부하 분산 장치 인터페이스가 첫 번째 오류를 throw 합니다. org.apache.camel 오류는 Amazon Web Services 측의 라우팅 오류를 나타냅니다.

    인스턴스 측의 해당 오류는 클라우드 오케스트레이션 트레일에 캡처됩니다.

    클라우드 API 트레일 열기

    클라우드 자원의 실패한 정책 또는 실패한 디스커버리 같은 문제를 디버깅하고 해결하려면 클라우드 API 트레일을 엽니다.

    시작하기 전에

    필요한 역할: sn_cmp.cloud_operator 또는 sn_cmp.cloud_admin

    프로시저

    1. 클라우드 관리자 포털에서 다음으로 이동합니다. 운영 > 트레일.
    2. 클라우드 API 트레일 탭에서 필요한 경우 클라우드 API 트레일 기록 목록을 필터링하고 정렬합니다.
      실패한 디스커버리 같은 항목을 찾으려는 경우에는 경로 상태 열에 오류가 있는 항목만 표시되도록 목록을 필터링합니다.
    3. 생성됨 열의 링크를 클릭하여 클라우드 API 트레일 기록을 엽니다.
    4. CAPI 트레일 로그 관련 목록에서 원하는 정보를 표시하는 로그 기록을 엽니다.
      예를 들어 route_error 또는 error_detail을 열어 실패한 작업을 디버깅합니다.