docs: Mistral API 429 에러 트러블슈팅 문서 추가

troubleshooting/250929_happybell80_mistral_api_429_error.md

@@ -0,0 +1,49 @@
+---
+date: 2025-09-29
+author: happybell80
+tags: [mistral, api, rate-limit, daily-headlines]
+---
+
+# Mistral API 429 에러 발생
+
+## 문제 발생
+- 시간: 2025-09-29 09:10 (KST)
+- 서비스: rb8001 daily_headlines 스케줄러
+- 에러: Mistral API 429 (Too Many Requests)
+- 발생 횟수: 전체 로그에서 1회만 발생
+
+## 환경 정보
+- API 키: MISTRAL_API_KEY 환경변수로 설정됨
+- 사용 모델: mistral-medium (추정)
+- 용도: 키워드 생성
+
+## 로그 조사 결과
+```bash
+docker logs rb8001 2>&1 | grep -c "Mistral API error: 429"
+# 결과: 1
+
+docker logs rb8001 --since "2025-09-29T00:00:00" | grep -c "Mistral API error: 429"
+# 결과: 0 (오늘 로그에는 없음)
+
+docker logs rb8001 --since "2025-09-28T00:00:00" | grep -c "Mistral API error: 429"
+# 결과: 0 (어제도 없음)
+```
+
+## API 상태 확인
+- Mistral API 모델 목록 조회: 정상 응답
+- 테스트 요청 5회 연속 실행: 모두 200 OK
+- 현재 시점 API 상태: 정상 작동
+
+## 발생 시점 분석
+- daily_headlines는 매일 오전 9:10에 실행
+- 서버 부팅 직후 여러 스케줄러 동시 실행 가능성
+- 첫 실행 시에만 발생, 이후 정상
+
+## 가능한 원인
+- 무료 계정의 일일 요청 한도
+- 분당 요청 제한 (rate limit)
+- 서버 초기화 시 동시 요청 충돌
+
+## 현재 상태
+- Mistral API: 정상 작동 중
+- 키워드 생성: 수동 테스트 시 정상