Repository navigation
Releases: cattomato-libs/Alh
Releases · cattomato-libs/Alh
Release list
v1.0.0
Spring Boot 3.4+ 용 AOP 로깅 스타터의 첫 릴리즈.
Features
- MDC 요청 컨텍스트 — 요청마다
requestId,userId,method,uri자동 세팅.X-Request-Id헤더 전파 지원. - AOP 자동 로깅 — 설정한 pointcut 표현식에 매칭되는 메서드는 진입/종료 자동 로그 (파라미터·소요시간·예외 포함).
- Slow 감지 — 임계값 (
slow-threshold-ms) 초과 시 WARN 으로 로깅. 메서드별@LogSlow(thresholdMs=...)override 가능. - 민감정보 마스킹 — 키워드 기반 (
password,token,authorization등) + PII 정규식 (이메일 →a***@***.com, 휴대폰 →010-****-5678, 카드 마지막 4자리, 주민번호 전체 마스킹). - 로그 인젝션 방지 — 파라미터/예외 메시지/URI 내부
\n,\r,\t, ESC 자동 이스케이프.X-Request-Id헤더는 화이트리스트 검증. - 커스텀 어노테이션 —
@LogExecution(강제 로깅),@LogSlow(임계값 오버라이드),@NoLog(제외). - Alert / Notification — ERROR 로그 발생 시 Slack/Discord 웹훅 자동 발송 (비동기, 레이트 리미트, 무한루프 가드, MDC 포함, 스택 트림).
- Spring Boot AutoConfiguration — 빈 자동 등록, 모듈별 독립 opt-out,
@ConditionalOnMissingBean로 사용자 override 자유.
Install
```gradle
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
implementation 'com.github.catomat0:Alh:1.0.0'
}
```
JitPack 사용 시 소비자는 별도 인증 세팅이 필요 없어 어떤 CI/CD 환경에서도 그대로 동작합니다.