Skip to content

Releases: cattomato-libs/Alh

Release list

v1.0.0

Choose a tag to compare

@catomat0 catomat0 released this 15 Sep 05:54

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 환경에서도 그대로 동작합니다.