서비스 장애가 나면 어디서 원인을 찾을까?
고객이 500 오류를 신고했지만 언제 어디서 발생했는지 기록이 없다면 원인을 찾기 어렵습니다.
기술 이름보다 해결할 문제를 먼저 살펴보겠습니다
고객이 500 오류를 신고했지만 언제 어디서 발생했는지 기록이 없다면 원인을 찾기 어렵습니다.
AI 개발이라고 해서 처음부터 모든 기능을 한 번에 코딩하는 것은 아닙니다. 이번 시간에는 오류 재현과 개인정보 없는 로그·건강검사를 설계한다.를 이해하고, 화면·입력·서버가 어떤 순서로 움직이는지 작은 예제로 확인해 보겠습니다.
먼저 아래 상황을 읽어보세요. 어떤 정보가 들어오고 무엇이 정상적인 결과인지 알면 코드를 처음 봐도 이해하기 쉬워집니다. 모르는 전문용어는 아래 ‘쉬운 용어 설명’을 열어 확인하세요.
오늘 사용할 가상 상황·입력
요청: POST /api/tasks 결과: 500 요청ID: req_demo_2 민감정보: 기록 금지
코드와 자료는 교육용 축약 예시입니다. 실제 운영 적용 전 추가 보안·예외 처리·환경 설정이 필요할 수 있습니다.
이런 코드 또는 설계 규칙으로 처리합니다
아래 내용을 글자 그대로 외우기보다 어떤 정보를 입력받고, 어떤 규칙을 검사하며, 무엇이 반환되는지 먼저 살펴보세요.
로그 예시:
{ "requestId":"req_demo_2", "route":"/api/tasks", "status":500, "errorCode":"DB_TIMEOUT" }
// 고객 이메일·비밀번호는 제외정상일 때 기대하는 결과
장애 시간·경로·상태·원인 코드 기록 로그에는 비밀번호·토큰 없음 재현 단계와 해결 상태 남김
가장 중요한 것은 외형보다 입력과 결과 사이의 규칙입니다. 빈 입력, 권한 부족, 중복 요청처럼 예외가 생겨도 문제가 없는지 확인해야 합니다. 이 예제 하나를 이해하면 다른 기능도 비슷한 방식으로 나눠 볼 수 있습니다.
실수 사례와 개선 방법을 나란히 비교합니다
오류 로그에 요청 본문의 개인정보와 비밀키까지 저장합니다.
원인 분석에 필요한 최소 정보만 구조화해 기록합니다.
전문용어 두 개를 쉬운 말로 알아보기
- 관측성
- 서비스 상태와 오류 원인을 파악할 수 있는 정보
- 로그
- 시스템에서 일어난 사건을 기록한 데이터
세 단계의 미니 개발 실습
운영 서버가 아니라 로컬 실습 또는 별도의 연습 환경에서 수행합니다. 필요한 외부 계정이나 운영 데이터는 사용하지 않습니다.
- STEP 1오류 상황을 요청ID로 구별
- STEP 2민감정보 없는 구조화 로그 작성
- STEP 3복구 후 동일 오류 재현 여부 확인
실습으로 확인한 입력, 정상 결과, 오류 결과와 수정할 항목을 적어보세요.
오늘 수업의 핵심 질문
로그가 많을수록 보안에도 무조건 좋을까요?
정답과 이유 펼쳐보기
아닙니다. 민감정보가 기록되면 유출 위험이 커집니다.
단순히 붙여 넣은 코드보다 작동 원리와 오류 처리 방법을 자신의 말로 설명하는 것이 중요합니다.
기존 LEXID·RE:LAND 등에서 검증한 개발 구조를 학습용으로 재구성했습니다. 비공개 저장소의 실제 고객 데이터나 비밀키는 공개하지 않습니다. 예시는 운영용 완제품이 아닙니다.