로그관리
로깅 방식
로컬 로깅
인스턴스가 온라인 인터페이스를 처리하면서 직접 DB/파일에 로그를 적재한다. 온라인 거래량이 많지 않을 경우 사용한다.
리모트 로깅
온라인 인터페이스 처리시 발생하는 로그 데이터를 비동기로 로깅하는 방식이다. 온라인 거래량이 많은 경우 인터페이스 처리 성능 향상을 위해 사용된다.
노드관리 > 인스턴스정보에 로깅인스턴스를 등록해 실행 중인 상태여야 리모트 로깅이 가능하며,
리모트 로깅 시 BXI는 로그 데이터를 Apache Kafka에 전달해 비동기로 처리한다.
로깅 인스턴스는 온라인 인스턴스와 동일한 노드 내에 기동할 수도 있지만, 온라인 인스턴스와 다른 노드에 기동할 수도 있다. 이 때, 로깅인스턴스가 있는 노드를 kafka서버에 별도로 기동시켜야 한다.
설정
시스템 파라미터에서 관련 설정을 진행한다.
| 설정키 | 내용 | 기본값 |
|---|---|---|
| LOG_POSITION | 로깅 방식을 로컬/리모트 중 설정할 수 있다. | Local |
| LOG_KAFKA_SERVERS | Kafka 메시지 관리 서버의 IP 주소(broker 서버 IP)이며, 클러스터 구성시 ,로 구분하여 등록한다. | localhost:9092 |
로그 종류
온라인 인터페이스의 로그는 송수신로그, 거래로그, 통계로그, 에러로그가 있다.
송수신 전문로그
게이트웨이 컴포넌트 및 라우터에서 입출력 전문을 기록하는 로그이다.
로그 파일의 기록 매체는 환경설정 > 시스템파라미터설정의 LOG_TYPE을 설정하며, 유효값은 아래와 같다.
| 설정값 | 내용 |
|---|---|
| DB | DB에 기록 |
| FILE | FILE에 기록 |
| ALL | DB, FILE 모두 기록 |
오른쪽 연계대상을 요청하는 케이스를 기준으로 구간별 로깅여부를 설정하면 아래와 같다.| 설정키 | 내용 |
|---|---|
| BZI | 라우터 입력전문 로깅 여부 |
| BZO | 라우터 출력전문 로깅 여부 |
| IGI | 요청입력전문에 대한 로깅 여부 |
| IGO | 요청출력전문에 대한 로깅 여부 |
| OGI | 응답입력전문에 대한 로깅 여부 |
| OGO | 응답출력전문에 대한 로깅 여부 |
특정 라우터의 구간별 로깅 여부는 플로우관리 > 라우터정보에서 라우터별로 정의할 수 있다.
::::
거래로그
온라인 인터페이스 처리 결과로그이며, 환경설정 > 시스템파라미터설정의 TX_HISTORY_YN에 따라 생성 여부를 결정한다.
해당로그가 생성되지 않으면 로그모니터링 > 거래내역조회화면에서 로그가 조회되지 않는다.
특별한 경우가 아니면 Y로 설정한다.
:::
통계로그
온라인 인터페이스의 처리건수, 에러건수, 정상건수의 통계 정보이며,
환경설정 > 시스템파라미터설정의 STATISTICS_YN에 따라 생성 여부를 결정한다.
해당로그가 생성되지 않으면 통계현황 화면들을 사용할 수 없다.
에러로그
에러 및 시스템 중요정보(커넥션 접속, 종료 등)를 기록하는 로그이며, 에러로그는 시스템 및 에러추적을 위한 중요정보로 항상 기록된다.