Skip to content

Engineering Log

wcorn edited this page Jun 15, 2026 · 31 revisions

Engineering Log

트러블슈팅 · 성능 개선 · 비용 최적화 · 장애 대응 기록. 문제 → 원인 → 조치 → 결과가 있는 작업을 항목별 개별 페이지로 남긴다.

새 항목: 아래 리스트에 한 줄 추가 + ELOG-NNN-<slug> 개별 페이지 생성. 작성은 맨 아래 템플릿 참고.

분류

  • 🔧 트러블슈팅 — 장애/버그 원인 추적과 해결
  • ⚡ 성능 개선 — 응답속도/처리량/리소스 최적화
  • 💰 비용 최적화 — 인프라/클라우드 비용 절감
  • 🚨 장애 대응 — 운영 중 발생한 인시던트 (상세는 Incident Runbook과 교차 참조)

목록

# 날짜 분류 제목 한 줄 요약
ELOG-010 2026-06 🔧 트러블슈팅 sealed-secrets repo 이전으로 Infra CI 전면 실패 helm repo가 bitnami-labs→bitnami.github.io 이전(구 URL 404). CI repo-add + Chart.yaml URL 교정
ELOG-009 2026-06 ⚡ 성능 개선 Cloudflare LAX 라우팅 지연 → 집 회선 직결 무료 CF anycast가 한국→LAX 라우팅. CF 제거 + Route53 wildcard + MetalLB + cert-manager 직결 → TTFB 872ms→12~26ms
ELOG-008 2026-06 💰 비용 최적화 AWS 비용이 S3 요청료로 샘 용량 아닌 요청(~88%)이 주범. Thanos GET 63%·Longhorn LIST 23%. 폴링 0 + Thanos caching bucket
ELOG-007 2026-06 🔧 트러블슈팅 노드 inotify 고갈(백업·MetalLB 반복 실패) fs.inotify.max_user_instances=128 고갈이 두 장애의 공통 뿌리. Ansible로 1024 상향
ELOG-006 2026-06 🔧 트러블슈팅 MySQL 백업이 31일간 0건 시크릿 부재(CreateContainerConfigError)+OL9 런타임설치+PROCESS 권한 3겹. 2-컨테이너 진짜 mysqldump+aws-cli로 재설계
ELOG-005 2026-06 ⚡ 성능 개선 FE 로딩/체감 속도 + 자료 목록 쿼리 코드 스플리팅(1.15MB→분할) + 이미지 즉시 미리보기 + 라우트 prefetch + materials 쿼리 member_id 인덱스
ELOG-004 2026-06 🔧 트러블슈팅 access 만료 후 403, 새로고침해야 복구 미인증을 401로 통일(AuthenticationEntryPoint)해 FE 런타임 자동 재발급 동작
ELOG-003 2026-06 🔧 트러블슈팅 노트 heading이 일반 텍스트로 보임 input rule은 정상, @tailwindcss/typography 미설치로 .prose 무력화가 진짜 원인
ELOG-002 2026-06 🔧 트러블슈팅 노트 표가 페이지 전체를 넓힘 표가 아니라 AppLayout <main>의 flex min-width:auto가 콘텐츠로 늘어남. min-w-0로 해결
ELOG-001 2026-05 🔧 트러블슈팅 MySQL NodePort 외부 접속 hang Istio envoy 프로토콜 sniff ↔ MySQL server-first 충돌. appProtocol: tcp 명시로 해결

템플릿

새 개별 페이지(ELOG-NNN-<slug>)는 아래 형식을 따른다. 복사해서 사용:

# ELOG-NNN: <제목>

| 항목 | 내용 |
|------|------|
| 분류 | 🔧 트러블슈팅 / ⚡ 성능 개선 / 💰 비용 최적화 / 🚨 장애 대응 |
| 날짜 | YYYY-MM-DD |
| 영역 | BE / FE / Infra / DB |
| 관련 이슈/PR | #NNN, #NNN |
| 상태 | 해결 / 완화 / 모니터링 중 / 보류 |

## 1. 상황 (Before)

무슨 증상/문제가 있었는지. 어떤 맥락에서 발견했는지.
(성능 개선이면: 개선 전 수치 — 응답시간/쿼리수/메모리 등)

## 2. 원인 분석

왜 그런 일이 일어났는지. 어떻게 원인을 좁혔는지 (로그/측정/재현).

## 3. 조치

실제로 무엇을 바꿨는지. 핵심 변경(코드/설정/인프라)을 구체적으로.

## 4. 결과 (After)

조치 후 어떻게 됐는지. (성능 개선이면: 개선 후 수치 + 변화율)

## 5. 교훈 / 후속

다음에 같은 류를 만나면 무엇을 먼저 볼지. 남은 과제/재발 방지책.

## 참고

- 링크, 문서, 커밋 등

작성 규칙

  • 번호(NNN)는 순차 증가. slug는 영어 kebab-case 짧게
  • 추측으로 채우지 않는다. 실제 측정/로그/조치 내용만 기록
  • 성능/비용 항목은 수치(전/후) 를 반드시 남긴다
  • 장애 대응은 Incident Runbook의 절차와 교차 링크

Clone this wiki locally