실무 가이드
장애 분석 순서
HandStack 기능 장애가 발생하면 다음 순서로 확인합니다.
- 브라우저 개발자 도구의 네트워크 오류
ack시작 로그와 현재 실행 포트- 거래 ID와 요청 ID
transact거 래 처리 로그dbclient또는function실행 로그- 외부 서비스 응답 로그
- 배포 직후라면 빌드/배포 로그
한 파일만 보고 결론을 내리지 말고 요청 흐름을 따라갑니다.
로그 작성 기준
코드에서 로그를 남길 때는 다음 정보를 포함합니다.
- 어떤 모듈에서 발생했는가?
- 어떤 거래 또는 작업인가?
- 어떤 입력 식별자와 관련 있는가?
- 외부 서비스 호출인지 내부 오류인지?
- 사용자가 재시도할 수 있는 오류인지?
민감한 본문 데이터는 그대로 기록하지 않습니다.
관리작업 로그
.bat, .ps1, .sh로 실행하는 관리작업은 콘솔 출력만으로 끝내지 말고 작업 결과를 남깁니다.
- 실행 명령
- 실행 환경
- 시작/종료 시각
- 성공/실패 여부
- 실패한 파일 또는 대상
- 후속 조치
체크리스트
- 장애 발생 시 요청 흐름을 추적할 로그가 있는가?
- 로그에 실제 암호나 토큰이 남지 않는가?
- 배포 자동화 로그에서 실패 원인을 확인할 수 있는가?
- 모듈별 로그 위치가 문서화되어 있는가?
- 운영 로그 보관 기간과 접근 권한이 정해져 있는가?