2024-09-09 · 최나래
API 게이트웨이 로그에서 신호만 남기기
게이트웨이 로그는 기본적으로 너무 많습니다. 첫째 단락에서는 필드를 열 개 이하로 줄이고, 사용자 세션 대신 상관관계 ID만 남깁니다. 둘째, 에러 코드별로 샘플링 비율을 다르게 두어 희귀 오류는 더 자주 남깁니다.
셋째 단락에서는 로그 대시보드에 "질문" 카드를 붙입니다. 예: "지난 1시간 동안 5xx 비율이 기준을 넘긴 경로는?" 카드는 SQL이 아니라 자연어 질문 형태로 운영자가 익숙한 표현을 씁니다.
넷째 단락에서는 로그 보존 기간을 법적 요구와 운영 필요를 분리해 표로 적습니다. 분리하지 않으면 모든 로그를 180일 보관하려다 비용이 불어납니다.