트레이스

개요

트레이스는 선택한 업무시스템의 거래 처리 현황을 조회하고 추적하는 기능입니다. 트레이스 로그를 조회하고 각 거래의 처리 흐름을 단계별로 확인할 수 있습니다.

트레이스 로그 조회

트레이스 로그를 조회하려면 WebAdmin 메인 메뉴에서 [통계분석] > [트레이스]를 선택합니다.

트레이스 화면은 트레이스 목록 테이블과 상단의 검색 영역으로 구성됩니다.

trace monitoring
  • ① 검색 영역

    조회 기간과 검색 조건을 설정하여 트레이스 정보를 조회할 수 있습니다. 트레이스 아이디, 요청 IP, 거래 이름, 상태, 어댑터 이름, 엔드포인트 이름, 대상 서버를 기준으로 검색할 수 있습니다.

    1. 조회 기간이 길면 로딩 시간이 오래 걸릴 수 있습니다. 적절한 조회 기간과 검색 조건을 설정하는 것을 권장합니다.

    2. 트레이스 아이디로 검색해도 검색 결과가 없을 때는 해당 업무시스템의 트레이스 로그 설정이 활성화되어 있는지 확인합니다. 로깅이 비활성화된 경우 로그가 기록되지 않습니다.

  • ② 트레이스 목록

    검색 영역에서 설정한 조건에 따라 트레이스 검색 결과가 표시됩니다. 트레이스 목록 테이블에서 조회 가능한 항목은 다음과 같습니다.

    항목 설명

    트레이스 아이디

    트레이스의 고유 식별자입니다. 아이디를 클릭하면 트레이스 상세 화면으로 이동합니다.

    요청 IP

    클라이언트의 IP 주소

    거래 이름

    거래 이름

    요청 시간

    거래가 시작된 시간

    경과 시간 (ms)

    거래의 총 처리 소요 시간 (단위: ms)

    상태

    거래 처리 상태를 표시합니다.

    • 성공: 거래가 정상 완료된 경우입니다.

    • 오류: 거래를 처리 중 오류가 발생한 경우입니다.

    • 서버 다운: 엔진 서버가 비정상 종료되어 거래가 중단된 경우입니다.

    어댑터 이름

    거래를 수신한 어댑터

    엔드포인트 이름

    거래를 수신한 엔드포인트의 이름

    대상 서버

    거래를 처리한 엔진 서버

트레이스 상세 조회

트레이스 목록에서 특정 트레이스 아이디를 클릭하면 트레이스 상세 화면으로 이동합니다.

trace monitoring detail

트레이스 상세 화면에서는 트레이스 로그 정보와 스팬 목록을 조회할 수 있습니다. 조회 가능한 트레이스 로그 정보는 트레이스 로그 조회를 참고합니다.

스팬 목록

거래 처리 과정에서 수행된 각 작업 단계(스팬)를 계층 구조로 표시합니다.

스팬은 하나의 거래를 처리하는 과정에서 수행되는 개별 작업 단위이며, 계층 구조를 통해 전체 처리 흐름을 추적할 수 있습니다.

trace monitoring span table
항목 설명

No

스팬 실행 순서

구분

처리 유형을 아이콘으로 표시합니다.

  • 인바운드 (trace monitoring inbound icon)

  • 플로우 (trace monitoring flow icon)

  • 아웃바운드 (trace monitoring outbound icon)

실행 모듈

해당 처리 단계를 수행한 리소스 이름을 표시합니다. (어댑터, 엔드포인트, 매핑, 플로우 등)

요청 시간

해당 처리 단계의 시작 시간

경과 시간 (ms)

해당 처리 단계의 소요 시간을 표시합니다. 각 단계별 처리 시간을 시각적으로 확인할 수 있습니다.

메시지

메시지 아이콘을 클릭하면 해당 단계의 요청/응답 메시지를 확인할 수 있습니다.

오류 분석

오류 거래 조회

트레이스 화면의 검색 영역에서 상태 필터를 '오류'로 선택하고, 조회 기간을 설정하여 조회합니다.

오류 상세 확인

트레이스 목록에서 오류가 발생한 트레이스 아이디를 클릭하면 트레이스 상세 페이지로 이동합니다.

trace monitoring detail error

스팬 목록에서 오류가 발생한 단계를 확인합니다. 오류가 발생한 행은 붉은색으로 표시됩니다.

메시지 아이콘을 클릭하여 오류 메시지를 확인합니다.