Repository navigation
Engineering Log
wcorn edited this page Jun 15, 2026
·
31 revisions
트러블슈팅 · 성능 개선 · 비용 최적화 · 장애 대응 기록. 문제 → 원인 → 조치 → 결과가 있는 작업을 항목별 개별 페이지로 남긴다.
새 항목: 아래 리스트에 한 줄 추가 +
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의 절차와 교차 링크