2025-08-12
밤 배치 전에 확인하는 로그 태그 6가지
작성: 류하람
운영 스크립트는 실행 자체보다 “무슨 일이 벌어졌는지 설명하는 능력”이 중요합니다. 태그가 일관되지 않으면 같은 오류도 매번 다른 문장으로 보입니다.
첫째, 작업 식별자를 고정 길이로 남깁니다. 둘째, 입력 파일 버전을 해시로 붙입니다. 셋째, 재시도 횟수와 백오프 단계를 숫자로 분리합니다. 넷째, 외부 API 응답 코드를 원문과 함께 적습니다. 다섯째, 부분 성공 여부를 불리언으로 표시합니다. 여섯째, 마지막 성공 단계 인덱스를 남겨 재시작 지점을 알 수 있게 합니다.
이 여섯 가지는 Flowly Castly의 주간 멘토링에서 반복 피드백으로 올라오는 항목입니다. 팀마다 도구는 다르지만, 읽는 사람이 같은 순서로 스캔할 수 있게 배치하는 것이 핵심입니다.
이 글은 베스트 프랙티스를 제시하지만, 특정 벤더 솔루션 구매를 권유하지 않습니다. 사용 중인 스택에 맞춰 필드를 줄이거나 늘리되, “한 줄에 한 사실” 규칙을 지키는 것을 권장합니다.
#운영#로그#자동화