chore: Alloy v1.21.0 도입 및 filelog 정렬 통일

[geonusp]

🧰 Chore PR

🔗 GitHub Issue

• Related chore: Grafana Alloy v1.21.0 업그레이드 및 filelog 정렬 동작 검증 #266

---

🧩 한눈에 요약

무엇을 변경했나?

• 인프라
• 설정파일
• 빌드 파일
• CI
• 의존성
• 런타임/비즈니스 로직 리팩터링 없음 (있으면 Refactor PR 템플릿 사용)

왜 필요한가?

• Alloy v1.21.0에 포함된 filelog 정렬 수정에 맞춰 기존 우회 설정을 제거하고, receiver의 정렬 설정을 직접 사용하도록 변경했다.

범위

• Included: Alloy 이미지 v1.21.0 업그레이드, filelog 설정 이전, 회전 로그 순서 검증 추가, 로컬 민감 파일 ignore 규칙 추가, CI 컨테이너가 임시 Alloy 설정 파일을 읽도록 권한 수정
• Not included: WSL Docker Desktop에서 로그 파일이 Alloy에 노출되지 않는 문제의 원인 확인([bug] WSL에서 Docker 로그 파일 마운트가 비어 Alloy 수집 검증 실패 #267), 운영 서버 적용

---

🧪 테스트 / 검증

로컬

• Command: python deploy/observability/scripts/verify-log-pipeline.py
• Result: PowerShell에서 전체 검증 PASS. 권한 수정 후 WSL에서는 Alloy가 설정을 읽고 기동하지만, Docker -> Alloy -> Loki 단계는 여전히 타임아웃되어 #267에서 조사 중이다.

CI

• 링크/결과: CI #427 실패는 임시 Alloy 설정 파일의 permission denied가 원인. 0644 권한 수정 커밋 5c5e3b75 반영 후 CI #428 진행 중.

Smoke / 수동 검증

• 시나리오: 로컬 Docker Compose로 로그 수집·회전·재시작·백엔드 재생성·Loki 장애 복구 검증
• 결과: PowerShell 실행에서 전체 검증 통과. 권한 수정 후 WSL 재실행에서는 Alloy 기동까지 확인했고 로그 수집은 [bug] WSL에서 Docker 로그 파일 마운트가 비어 Alloy 수집 검증 실패 #267 타임아웃 재현.

테스트 공백

• WSL 실행에서만 첫 Docker 로그 수집 단계가 실패한다. 원인은 미확정이며 #267에서 조사한다.

---

🧭 영향 범위

• 설정/환경변수 변경 없음
• 설정/환경변수 변경 있음 (항목: Alloy 이미지 버전 및 filelog receiver 설정)
• CI/빌드 파이프라인 영향 없음
• CI/빌드 파이프라인 영향 있음
• 의존성 변경 없음
• 의존성 변경 있음 (Grafana Alloy v1.19.2 → v1.21.0)

---

⚠️ 리스크 & 롤백

리스크

• filelog ordering 설정 지원 버전이 v1.21.0보다 낮으면 새 설정이 동작하지 않을 수 있다.
• WSL Docker Desktop에서는 테스트 스크립트가 로그 파일을 읽지 못하는 문제가 남아 있다([bug] WSL에서 Docker 로그 파일 마운트가 비어 Alloy 수집 검증 실패 #267).

롤백

• 단순 revert로 가능
• 버전 pin/되돌리기 필요 (대상: Alloy 이미지와 filelog 설정, 방법: 기존 v1.19.2 설정으로 revert)
• 배포 롤백(이전 태그/이미지) 가능

---

💬 리뷰 가이드

• 꼭 봐야 하는 파일/설정: deploy/observability/app-agent/alloy/config.alloy, deploy/observability/app-agent/docker-compose.yml, deploy/observability/scripts/verify-log-pipeline.py의 임시 설정 파일 권한과 회전 순서 검증 코드
• 트레이드오프/대안: 기존 file_input 우회 대신 Alloy v1.21.0의 receiver 정렬 설정을 직접 사용한다.
• 관련 PR: [feat] Loki·Alloy 로그 파이프라인 및 Grafana logs↔Trace 연결 (4/4) #264.
• upstream 수정: fix(otelcol.receiver.filelog): Use alphabetical instead of lexicographic sort type grafana/alloy#7212
• 성능/보안/호환성 영향: Alloy 이미지 버전만 변경되며 앱 API·DB 스키마에는 영향 없다.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Repository UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: 77e43c89-18e3-45f8-8ccd-66257a643ec4

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}