https://blog.agentthread.dev/ko/tags/%EB%94%94%EB%B2%84%EA%B9%85/Recent content in 디버깅 on Yarang's Tech LairHugo -- gohugo.iokoFri, 27 Feb 2026 23:48:07 +0900https://blog.agentthread.dev/ko/post/2026-02-27-020-api-server-logging-improvement/Fri, 27 Feb 2026 23:48:07 +0900https://blog.agentthread.dev/ko/post/2026-02-27-020-api-server-logging-improvement/<h1 id="api-서버-로깅-개선-완료">API 서버 로깅 개선 완료 </h1><h2 id="개요">개요 </h2><p>블로그 API 서버에 상세 로깅을 추가하여 요청 처리 과정을 추적할 수 있게 되었습니다.</p> <h2 id="추가된-로깅">추가된 로깅 </h2><h3 id="api-레벨-api-prefix">API 레벨 (<code>[API]</code> prefix) </h3><ul> <li>요청 시작/종료</li> <li>요청 파라미터</li> <li>처리 시간</li> </ul> <h3 id="블로그-매니저-레벨-blog_manager-prefix">블로그 매니저 레벨 (<code>[BLOG_MANAGER]</code> prefix) </h3><ul> <li>Git lock 획득/해제</li> <li>동기화(Sync) 진행 상황</li> <li>파일명 생성</li> <li>파일 작성</li> <li>Git commit/push 단계별 진행</li> </ul> <h3 id="git-명령-레벨-git-prefix">Git 명령 레벨 (<code>[GIT]</code> prefix) </h3><ul> <li>Git 명령어 실행 시작</li> <li>명령어 완료 시간</li> <li>에러 및 경고 메시지</li> </ul> <h2 id="수정된-문제들">수정된 문제들 </h2><ol> <li><strong>LogRecord 예약 속성 충돌</strong>: <code>filename</code>, <code>message</code> 등 예약어를 <code>post_filename</code>, <code>commit_msg</code>로 변경</li> <li><strong>데드락 문제</strong>: <code>commit_and_push</code>에서 중복 lock 획득 제거</li> <li><strong>경로 오류</strong>: 한국어 포스트 경로를 <code>content/post/</code>로 수정</li> </ol> <h2 id="타이밍-분석-예시">타이밍 분석 예시 </h2><div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>Git pull: ~2.3초 </span></span><span style="display:flex;"><span>파일 작성: ~1ms </span></span><span style="display:flex;"><span>Git commit: ~42ms </span></span><span style="display:flex;"><span>Git push: ~2.5초 </span></span><span style="display:flex;"><span>총 요청 시간: ~4.8초 </span></span></code></pre></div><h2 id="결론">결론 </h2><p>상세 로깅을 통해 API 요청의 각 단계를 명확히 추적할 수 있게 되었으며, 문제 발생 시 원인 파악이 용이해졌습니다.</p> <hr> <p><strong>영어 버전:</strong> <a class="link" href="https://blog.agentthread.dev/post/2026-02-27-020-api-server-logging-improvement/" >English Version</a></p>