round9 리뷰의 관측 registry 묶음(B5), 로그 내용 묶음(B6a), 비밀·IP 문서 묶음(B6b)을 고친다. 운영자가 보는 신호(지표·MDC·헤더 registry)가 코드와 어긋나고, 로그 줄이 남기지 말아야 할 값을 싣고 남겨야 할 줄을 버렸다.
B6a 로그 내용. 401·403 보안 WARN, route를 못 찾은 요청 로그, 처리하지 못한 예외 ERROR가 원본 URI를 실었다(RR9-02-09). 호출자 없는 HeaderSanitizer가 공개 유틸리티로 남아 있었다(RR9-02-15). SamplingTurboFilter가 감사 logger의 INFO 줄도 표본으로 버렸다(RR9-02-21). outbox relay·파일 서버 정리 스케줄러가 실패를 통째로 남겨 SQL·값이 원인 사슬로 따라갔다(RR9-02-22). JSON 로그 profile 칸이 Spring이 해석한 profile과 다를 수 있었다(RR9-02-26).
B6b 비밀·IP 문서. IP 신뢰 설정을 두 문서가 다르게 적었다(RR9-02-10). masking_rule이 구현 없는 full_except_last_4를 약속했고 full로 적은 키 일부를 가리지 않았다(RR9-02-12). 로컬 비밀 기본값이 __LOCAL_DEV_ 규칙을 따르지 않았다(RR9-02-13).
B5 관측 registry.metrics.yaml에 아무 코드도 등록하지 않는 행 열하나와 코드에 없는 tag 값이 있었고, 등록하는 지표 다수가 빠져 있었다(RR9-02-05). mdc-keys.yaml 18키 중 5키만 맞았다(RR9-02-07). 전송마다 correlation 규칙이 다른데 하나로 적었다(RR9-02-08). in-process lock이 lock.acquisition을 세지 않았다(RR9-02-27). headers.yaml이 요청 id를 ulid로 적고 아무도 쓰지 않는 헤더를 적었다(RR9-03-05).
고른 방법과 버린 대안
LoggedPath: handler가 고른 pattern, 없으면 식별자가 들 수 있는 마디를 {}로 가린 경로. 세 로그 줄이 같이 쓴다. 버린 안: 원본 URI를 두고 문서로 경고(수집기가 이미 받는다).
스케줄러 실패는 새 ServerFailureLog.forBackgroundTask로 남긴다: persistence 실패는 원인 사슬 없이, 그 밖의 carrier는 client 쪽 코드여도 stack과 함께(요청이 없으니 결함이다). composition:outbox-relay → shared-contract edge를 registry에 더했다.
SamplingTurboFilter는 AUDIT marker(marker 자신의 이름. SLF4J 2.0.20이 marker 참조 API를 deprecated로 둔다)와 이름 끝 마디가 audit·security인 logger를 표본에서 뺀다.
ResolvedProfileJsonProvider가 줄을 쓸 때의 해석된 profile을 쓴다.
LogMaskingPatterns: 키 목록을 넓히고, 여러 줄 PEM 블록(같은 라벨의 END까지, 없으면 끝까지)과 URI userinfo 비밀번호(host가 뒤따르는 첫 @까지, 256자 상한, 선형 시간)를 가린다. 버린 안: full_except_last_4 구현(끝 네 자리를 남길 값이 없다).
registry를 코드와 시험으로 묶었다: MetricsRegistryCodeAlignmentTest가 행 → 코드(이름이 상수면 그 상수를 쓰는 곳까지)와 코드(글자·상수 이름의 builder·registry·Metrics·Observation 호출) → 행 두 방향을 보고, 형태마다 기준 meter 하나를 찾아 scan 자체가 살아 있는지도 본다. HeaderRegistryRuntimeAlignmentTest·StructuredLogFieldContractTest도 코드 상수와 대조한다. 공용 도우미 MainSources에 위반 fixture 시험을 둔다. 버린 안: 틀린 행만 지우기(새 지표가 다시 빠진다).
slo_driven 행과 MetricsDistributionMeterFilter 대상을 같은 집합으로 묶었고, histogram을 켜지 않는 hikaricp timer 행은 평균으로 경보한다.
밑줄 든 meter 이름 둘을 이름 규칙에 맞췄다(http.client.ratelimit.rejected, fileserver.upload.offset.mismatch). in-process lock을 MeteredDistributedLock으로 감쌌다.
정한 기본값
headers.yaml의 service: 출처는 서비스 controller가 읽으라고 둔 ApiHeaders 상수 셋(Idempotency-Key, If-Match, If-None-Match)만 쓴다. 시험이 그 목록과 「템플릿 main이 쓰지 않음」을 강제한다.
tracestate는 W3C 전파가 쓰는 framework: 행으로 둔다.
템플릿 코드가 부르지 않는 공개 메서드로만 생기는 job.retry.total·job.dlq.total 행은 지우지 않고 emitted_when을 적는다.
userinfo 가림은 비밀번호에 날 @·/·#·?가 있어도 가리고, 포트(host:8080/)와 경로·query의 @는 비밀번호로 보지 않는다. 공백이 든 비밀번호와 숫자 뒤에 /가 오는 비밀번호는 못 가린다.
로컬 비밀 기본값: __LOCAL_DEV_db_password__, __LOCAL_DEV_minio_root__, __LOCAL_DEV_keycloak_admin__.
위험과 영향
지표 이름 둘이 바뀌고 단일 인스턴스 lock 지표가 생긴다. 로그의 경로 값과 JSON profile 칸의 출처가 바뀐다. HeaderSanitizer가 지워진다. 로컬 compose의 옛 volume은 옛 비밀번호로 만들어졌으면 DB·MinIO 접속이 실패한다. 할 일은 docs/upgrade/2026-11-round9-observability.md 113행이다(B6a 15, B6b 67, B5 813).
감사 줄이 표본에서 빠져 로그 양이 늘 수 있다.
중간 커밋 B6a·B6b는 따로 돌리지 않았다. desktop 검증은 head 트리 기준이다.
검증
desktop(새 main e6c3b159 기준, 트리 745f1c7a): lockfile 재생성(outbox-relay·app-bootstrap, 바뀐 것 없음) 뒤 spotlessApply, :adapter:inbound:web:systemTest :app-bootstrap:systemTest :app-bootstrap:documentContractTest :app-bootstrap:repositoryContractTest :app-bootstrap:verifyEnvKeys rc=0, scripts/verify.sh pr rc=0(시험 6931건, 실패 0, 건너뜀 35).
head 트리는 그 트리와 docs/capability-status.md 제거 표의 한 칸(마지막으로 존재한 커밋을 새 기준 e6c3b159로)만 다르다. 문서 검사는 노트북에서 다시 돌렸다(OK).
앞선 실행에서 새 main의 -Werror가 Marker.contains(String)·iterator() deprecated와 ErrorProne StringConcatToTextBlock을 잡아 고쳤다.
RED: 새 시험은 고치기 전 트리에서 실패했다(a2-red, 바뀐 registry·로그 시험 7건 등).
노트북: python3 scripts/check-docs.py·check-work-docs.py·verify-httpclient-docs.py OK.
새 눈 리뷰 4회(관측·보안·시험·문서 1·2차, 셋을 묶은 3차, 가림 정규식 4차)와 구조 리뷰 1회. 마지막 지적까지 모두 고쳤다.
2026-11-12 전체 리뷰 docs/reviews/2026-11-12-round9-review/(색인 「묶음」 B5·B6a·B6b).
그룹 B에 넘긴 것: ApachePoolMetricsBinder, MongoTransactionRetry 지연.
범위 밖으로 남긴 것: httpclient ResilienceRejectionRecorder가 breaker::state를 gauge 상태 객체로 넘겨 GC 뒤 http.client.circuit.state가 NaN일 수 있다(탐침 필요). ApiHeaders.DEPRECATION·DATE는 쓰는 곳 없는 공개 상수다. graphql의 observation convention bean 둘이 Spring observation에 연결되지 않는다.
## 무엇을, 왜
round9 리뷰의 관측 registry 묶음(B5), 로그 내용 묶음(B6a), 비밀·IP 문서 묶음(B6b)을 고친다. 운영자가 보는 신호(지표·MDC·헤더 registry)가 코드와 어긋나고, 로그 줄이 남기지 말아야 할 값을 싣고 남겨야 할 줄을 버렸다.
- **B6a 로그 내용.** 401·403 보안 WARN, route를 못 찾은 요청 로그, 처리하지 못한 예외 ERROR가 원본 URI를 실었다(RR9-02-09). 호출자 없는 `HeaderSanitizer`가 공개 유틸리티로 남아 있었다(RR9-02-15). `SamplingTurboFilter`가 감사 logger의 INFO 줄도 표본으로 버렸다(RR9-02-21). outbox relay·파일 서버 정리 스케줄러가 실패를 통째로 남겨 SQL·값이 원인 사슬로 따라갔다(RR9-02-22). JSON 로그 `profile` 칸이 Spring이 해석한 profile과 다를 수 있었다(RR9-02-26).
- **B6b 비밀·IP 문서.** IP 신뢰 설정을 두 문서가 다르게 적었다(RR9-02-10). `masking_rule`이 구현 없는 `full_except_last_4`를 약속했고 full로 적은 키 일부를 가리지 않았다(RR9-02-12). 로컬 비밀 기본값이 `__LOCAL_DEV_` 규칙을 따르지 않았다(RR9-02-13).
- **B5 관측 registry.** `metrics.yaml`에 아무 코드도 등록하지 않는 행 열하나와 코드에 없는 tag 값이 있었고, 등록하는 지표 다수가 빠져 있었다(RR9-02-05). `mdc-keys.yaml` 18키 중 5키만 맞았다(RR9-02-07). 전송마다 correlation 규칙이 다른데 하나로 적었다(RR9-02-08). in-process lock이 `lock.acquisition`을 세지 않았다(RR9-02-27). `headers.yaml`이 요청 id를 ulid로 적고 아무도 쓰지 않는 헤더를 적었다(RR9-03-05).
## 고른 방법과 버린 대안
- `LoggedPath`: handler가 고른 pattern, 없으면 식별자가 들 수 있는 마디를 `{}`로 가린 경로. 세 로그 줄이 같이 쓴다. 버린 안: 원본 URI를 두고 문서로 경고(수집기가 이미 받는다).
- 스케줄러 실패는 새 `ServerFailureLog.forBackgroundTask`로 남긴다: persistence 실패는 원인 사슬 없이, 그 밖의 carrier는 client 쪽 코드여도 stack과 함께(요청이 없으니 결함이다). `composition:outbox-relay → shared-contract` edge를 registry에 더했다.
- `SamplingTurboFilter`는 `AUDIT` marker(marker 자신의 이름. SLF4J 2.0.20이 marker 참조 API를 deprecated로 둔다)와 이름 끝 마디가 `audit`·`security`인 logger를 표본에서 뺀다.
- `ResolvedProfileJsonProvider`가 줄을 쓸 때의 해석된 profile을 쓴다.
- `LogMaskingPatterns`: 키 목록을 넓히고, 여러 줄 PEM 블록(같은 라벨의 END까지, 없으면 끝까지)과 URI userinfo 비밀번호(host가 뒤따르는 첫 `@`까지, 256자 상한, 선형 시간)를 가린다. 버린 안: `full_except_last_4` 구현(끝 네 자리를 남길 값이 없다).
- registry를 코드와 시험으로 묶었다: `MetricsRegistryCodeAlignmentTest`가 행 → 코드(이름이 상수면 그 상수를 쓰는 곳까지)와 코드(글자·상수 이름의 builder·registry·`Metrics`·`Observation` 호출) → 행 두 방향을 보고, 형태마다 기준 meter 하나를 찾아 scan 자체가 살아 있는지도 본다. `HeaderRegistryRuntimeAlignmentTest`·`StructuredLogFieldContractTest`도 코드 상수와 대조한다. 공용 도우미 `MainSources`에 위반 fixture 시험을 둔다. 버린 안: 틀린 행만 지우기(새 지표가 다시 빠진다).
- slo_driven 행과 `MetricsDistributionMeterFilter` 대상을 같은 집합으로 묶었고, histogram을 켜지 않는 hikaricp timer 행은 평균으로 경보한다.
- 밑줄 든 meter 이름 둘을 이름 규칙에 맞췄다(`http.client.ratelimit.rejected`, `fileserver.upload.offset.mismatch`). in-process lock을 `MeteredDistributedLock`으로 감쌌다.
## 정한 기본값
- `headers.yaml`의 `service:` 출처는 서비스 controller가 읽으라고 둔 `ApiHeaders` 상수 셋(`Idempotency-Key`, `If-Match`, `If-None-Match`)만 쓴다. 시험이 그 목록과 「템플릿 main이 쓰지 않음」을 강제한다.
- `tracestate`는 W3C 전파가 쓰는 `framework:` 행으로 둔다.
- 템플릿 코드가 부르지 않는 공개 메서드로만 생기는 `job.retry.total`·`job.dlq.total` 행은 지우지 않고 `emitted_when`을 적는다.
- userinfo 가림은 비밀번호에 날 `@`·`/`·`#`·`?`가 있어도 가리고, 포트(`host:8080/`)와 경로·query의 `@`는 비밀번호로 보지 않는다. 공백이 든 비밀번호와 숫자 뒤에 `/`가 오는 비밀번호는 못 가린다.
- 로컬 비밀 기본값: `__LOCAL_DEV_db_password__`, `__LOCAL_DEV_minio_root__`, `__LOCAL_DEV_keycloak_admin__`.
## 위험과 영향
- 지표 이름 둘이 바뀌고 단일 인스턴스 lock 지표가 생긴다. 로그의 경로 값과 JSON `profile` 칸의 출처가 바뀐다. `HeaderSanitizer`가 지워진다. 로컬 compose의 옛 volume은 옛 비밀번호로 만들어졌으면 DB·MinIO 접속이 실패한다. 할 일은 `docs/upgrade/2026-11-round9-observability.md` 1~13행이다(B6a 1~5, B6b 6~7, B5 8~13).
- 감사 줄이 표본에서 빠져 로그 양이 늘 수 있다.
- 중간 커밋 B6a·B6b는 따로 돌리지 않았다. desktop 검증은 head 트리 기준이다.
## 검증
- desktop(새 main `e6c3b159` 기준, 트리 `745f1c7a`): lockfile 재생성(outbox-relay·app-bootstrap, 바뀐 것 없음) 뒤 `spotlessApply`, `:adapter:inbound:web:systemTest :app-bootstrap:systemTest :app-bootstrap:documentContractTest :app-bootstrap:repositoryContractTest :app-bootstrap:verifyEnvKeys` rc=0, `scripts/verify.sh pr` rc=0(시험 6931건, 실패 0, 건너뜀 35).
- head 트리는 그 트리와 `docs/capability-status.md` 제거 표의 한 칸(마지막으로 존재한 커밋을 새 기준 `e6c3b159`로)만 다르다. 문서 검사는 노트북에서 다시 돌렸다(OK).
- 앞선 실행에서 새 main의 `-Werror`가 `Marker.contains(String)`·`iterator()` deprecated와 ErrorProne `StringConcatToTextBlock`을 잡아 고쳤다.
- RED: 새 시험은 고치기 전 트리에서 실패했다(a2-red, 바뀐 registry·로그 시험 7건 등).
- 노트북: `python3 scripts/check-docs.py`·`check-work-docs.py`·`verify-httpclient-docs.py` OK.
- 새 눈 리뷰 4회(관측·보안·시험·문서 1·2차, 셋을 묶은 3차, 가림 정규식 4차)와 구조 리뷰 1회. 마지막 지적까지 모두 고쳤다.
## 리뷰어가 볼 곳
- `src/bootstrap/app/src/test/java/dev/caskeleton/bootstrap/contract/MetricsRegistryCodeAlignmentTest.java`, `contract/support/MainSources.java`, `HeaderRegistryRuntimeAlignmentTest.java`.
- `LogMaskingPatterns` 규칙 0·4와 시험, `SamplingTurboFilter`, `LoggedPath`, `ServerFailureLog.forBackgroundTask`.
- `docs/registries/metrics.yaml`·`headers.yaml`·`mdc-keys.yaml`·`secrets-classification.yaml`, `docs/upgrade/2026-11-round9-observability.md`.
## 발견 판정
| 발견 | 판정 | 커밋 |
|---|---|---|
| RR9-02-09 | 고침 | 75df7615 |
| RR9-02-15 | 고침 | 75df7615 |
| RR9-02-21 | 고침 | 75df7615 |
| RR9-02-22 | 고침 | 75df7615 |
| RR9-02-26 | 고침 | 75df7615 |
| RR9-02-10 | 고침 | a7f44d8a |
| RR9-02-12 | 고침 | a7f44d8a |
| RR9-02-13 | 고침 | a7f44d8a |
| RR9-02-14 | 해당 없음 | #22 f2d2267e가 이미 고침(`ManagementSecurityConfig` Javadoc) |
| RR9-02-05 | 고침 | 354b7fc9 |
| RR9-02-07 | 고침 | 354b7fc9 |
| RR9-02-08 | 고침 | 354b7fc9 |
| RR9-02-27 | 고침 | 354b7fc9 |
| RR9-03-05 | 고침 | 354b7fc9 |
## 관련
- 2026-11-12 전체 리뷰 `docs/reviews/2026-11-12-round9-review/`(색인 「묶음」 B5·B6a·B6b).
- 그룹 B에 넘긴 것: `ApachePoolMetricsBinder`, `MongoTransactionRetry` 지연.
- 범위 밖으로 남긴 것: httpclient `ResilienceRejectionRecorder`가 `breaker::state`를 gauge 상태 객체로 넘겨 GC 뒤 `http.client.circuit.state`가 NaN일 수 있다(탐침 필요). `ApiHeaders.DEPRECATION`·`DATE`는 쓰는 곳 없는 공개 상수다. graphql의 observation convention bean 둘이 Spring observation에 연결되지 않는다.
로그 줄이 남기지 말아야 할 값을 싣고, 남겨야 할 줄을 버린다. 401·403
보안 WARN, route를 못 찾은 요청 로그, 처리하지 못한 예외 ERROR가 원본
request URI(식별자·토큰이 든 경로)를 싣는다. outbox relay·파일 서버 정리
스케줄러는 실패를 통째로 남겨 SQL·제약 이름·값이 원인 사슬로 따라간다.
SamplingTurboFilter는 INFO 이하를 logger 구분 없이 표본으로 버려 감사
logger의 INFO 줄도 사라진다. JSON 로그 profile 칸은 Logback이 처음 읽은
환경 변수 값이라 Spring이 해석한 profile과 다를 수 있다. HeaderSanitizer는
운영 코드가 부르지 않는 공개 유틸리티로 남아 있다.
- LoggedPath: route template이 있으면 그것, 없으면 식별자가 들 수 있는
마디를 {}로 가린 경로. 세 줄이 모두 쓴다. 버린 안: 원본 URI 그대로 두고
문서로 경고(로그 수집기가 이미 받는다).
- 스케줄러 실패는 새 ServerFailureLog.forBackgroundTask로 남긴다: 분류된
persistence 실패는 원인 사슬 없이, 그 밖의 carrier는 client 쪽 코드여도
stack과 함께(요청이 없으니 결함이다). composition:outbox-relay에
shared-contract edge를 더한다(gradle/modules.json).
- SamplingTurboFilter는 AUDIT marker와 이름 끝 마디가 audit·security인
logger를 표본에서 뺀다(이름별 판정은 캐시).
- ResolvedProfileJsonProvider가 줄을 쓸 때의 해석된 profile을 쓴다.
- HeaderSanitizer와 시험을 지우고 capability-status 제거 표에 적는다.
위험: 경로를 보던 로그 검색이 가린 경로를 본다. 감사 줄이 표본에서 빠져
양이 늘 수 있다. docs/upgrade/2026-11-round9-observability.md 1~5행.
검증: desktop에서 바뀐 leaf check·:app-bootstrap:test·systemTest·
documentContractTest·repositoryContractTest, scripts/verify.sh pr rc=0
(묶음 셋을 합친 트리). 새 시험은 고치기 전 트리에서 실패했다(RED).
Refs: RR9-02-09, RR9-02-15, RR9-02-21, RR9-02-22, RR9-02-26
BREAKING CHANGE: 보안·요청·예외 로그 줄의 경로 값과 JSON profile 칸의 출처,
HeaderSanitizer 삭제. docs/upgrade/2026-11-round9-observability.md 1~5행.
로컬 비밀 기본값(compose·lane·application-local의 DB 비밀번호, MinIO
root, Keycloak admin)이 __LOCAL_DEV_ 접두어 규칙을 따르지 않아 prod
sentinel 검사가 그 값을 알아보지 못한다. secrets-classification.yaml은
구현 없는 masking_rule full_except_last_4를 약속하고, full로 적은 키 일부
(salt·PEM·HMAC/signing key, URI 사용자 정보)를 LogMaskingPatterns가 가리지
않는다. required_test는 없는 시험 이름이다. IP 신뢰 설정을 두 문서가
다르게 적는다(application-local은 framework, rate-limiting은 native).
- 기본값을 __LOCAL_DEV_db_password__·__LOCAL_DEV_minio_root__·
__LOCAL_DEV_keycloak_admin__로 바꾼다.
- masking_rule을 full|userinfo|none 셋으로 줄이고, LogMaskingPatterns의
키 목록을 넓히고 URI userinfo와 여러 줄 PEM 블록 가림을 더한다. 시험이 masking_rule 어휘,
required_test 클래스 존재, full·userinfo 행이 실제로 가려지는지 본다.
버린 안: full_except_last_4 구현(끝 네 자리를 남길 값이 없다).
- IP 신뢰는 native + 내부 proxy 목록 하나로 적는다.
위험: 로컬 compose 볼륨이 옛 비밀번호로 만들어졌으면 DB 접속이 실패한다
(docs/upgrade/2026-11-round9-observability.md 6행). 운영 값은 바뀌지
않는다.
검증: 위와 같은 desktop 실행(묶음 셋을 합친 트리) rc=0.
Refs: RR9-02-10, RR9-02-12, RR9-02-13
BREAKING CHANGE: 로컬 compose·lane의 비밀 기본값이 바뀐다. 옛 볼륨은
지우거나 env로 옛 값을 준다(docs/upgrade/2026-11-round9-observability.md 6~7행).
관측 registry가 코드와 양쪽으로 어긋난다. metrics.yaml에는 아무 코드도
등록하지 않는 행 열하나와 코드에 없는 tag 값이 있고, 코드가 등록하는
graphql·notification·http.client·fileserver·mongodb·jpa.query 지표 다수가
없다. mdc-keys.yaml은 18키 중 코드가 넣는 5키만 맞고 required_in이 틀렸다.
headers.yaml은 X-Request-Id·X-Correlation-Id를 ulid로 적고 아무도 쓰지
않는 Deprecation·Sunset·tracestate를 적는다. 전송마다 correlation 규칙이
다른데 registry는 하나로 적는다. 단일 인스턴스 in-process lock은
lock.acquisition을 세지 않아 그 지표가 0이다. 밑줄 든 meter 이름 둘이
이름 규칙을 어긴다.
- 행마다 등록하는 main 파일(source)·상수(constant)·등록 주체
(registered_by)를 적고, MetricsRegistryCodeAlignmentTest가 행 → 코드(이름이
상수면 그 상수를 쓰는 곳까지)와 코드(글자·상수 이름의 builder·registry·
Metrics 호출) → 행 두 방향을 본다. 템플릿이 부르지 않는 공개 메서드로만
생기는 job.* 행은 emitted_when을 적는다. 버린 안: 행만 지우기(새 지표가
다시 빠진다).
- mdc-keys는 5키와 전송별 표, headers는 source가 든 33행(서비스 controller용
상수는 service: 출처), StructuredLog·HeaderRegistry 시험이 코드 상수와
집합을 대조한다. 두 registry 시험은 시험 도우미 MainSources를 같이 쓴다.
- slo_driven 행은 MetricsDistributionMeterFilter 대상과 같은 집합이다(두
방향 시험). histogram을 켜지 않는 hikaricp timer 행은 평균으로 경보한다.
graphql.datafetcher·dataloader 행에 Spring 기본 tag를 적는다.
- in-process lock을 MeteredDistributedLock으로 감싼다.
- http.client.ratelimit.rejected, fileserver.upload.offset.mismatch로
이름을 바꾸고 http.client.circuit.state.rejected를 상수로 둔다.
- CardinalityBounds(status 40·outcome 6·uri), MetricNaming 단위 규칙,
SLO filter 대상(http.server.requests·jvm.gc.pause)을 문서와 맞춘다.
위험: 지표 이름 둘이 바뀌고 단일 인스턴스 lock 지표가 생긴다. 그 이름으로
만든 대시보드·경보를 옮겨야 한다(docs/upgrade/2026-11-round9-observability.md
8~13행). ApachePoolMetricsBinder·MongoTransactionRetry 지연은 다른 묶음이
맡는다.
검증: 위와 같은 desktop 실행(묶음 셋을 합친 트리) rc=0.
Refs: RR9-02-05, RR9-02-07, RR9-02-08, RR9-02-27, RR9-03-05
BREAKING CHANGE: http.client.rate_limit.rejected → http.client.ratelimit.rejected,
fileserver.upload.offset_mismatch → fileserver.upload.offset.mismatch,
CardinalityBounds 상수. docs/upgrade/2026-11-round9-observability.md 8~13행.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 리뷰의 관측 registry 묶음(B5), 로그 내용 묶음(B6a), 비밀·IP 문서 묶음(B6b)을 고친다. 운영자가 보는 신호(지표·MDC·헤더 registry)가 코드와 어긋나고, 로그 줄이 남기지 말아야 할 값을 싣고 남겨야 할 줄을 버렸다.
HeaderSanitizer가 공개 유틸리티로 남아 있었다(RR9-02-15).SamplingTurboFilter가 감사 logger의 INFO 줄도 표본으로 버렸다(RR9-02-21). outbox relay·파일 서버 정리 스케줄러가 실패를 통째로 남겨 SQL·값이 원인 사슬로 따라갔다(RR9-02-22). JSON 로그profile칸이 Spring이 해석한 profile과 다를 수 있었다(RR9-02-26).masking_rule이 구현 없는full_except_last_4를 약속했고 full로 적은 키 일부를 가리지 않았다(RR9-02-12). 로컬 비밀 기본값이__LOCAL_DEV_규칙을 따르지 않았다(RR9-02-13).metrics.yaml에 아무 코드도 등록하지 않는 행 열하나와 코드에 없는 tag 값이 있었고, 등록하는 지표 다수가 빠져 있었다(RR9-02-05).mdc-keys.yaml18키 중 5키만 맞았다(RR9-02-07). 전송마다 correlation 규칙이 다른데 하나로 적었다(RR9-02-08). in-process lock이lock.acquisition을 세지 않았다(RR9-02-27).headers.yaml이 요청 id를 ulid로 적고 아무도 쓰지 않는 헤더를 적었다(RR9-03-05).고른 방법과 버린 대안
LoggedPath: handler가 고른 pattern, 없으면 식별자가 들 수 있는 마디를{}로 가린 경로. 세 로그 줄이 같이 쓴다. 버린 안: 원본 URI를 두고 문서로 경고(수집기가 이미 받는다).ServerFailureLog.forBackgroundTask로 남긴다: persistence 실패는 원인 사슬 없이, 그 밖의 carrier는 client 쪽 코드여도 stack과 함께(요청이 없으니 결함이다).composition:outbox-relay → shared-contractedge를 registry에 더했다.SamplingTurboFilter는AUDITmarker(marker 자신의 이름. SLF4J 2.0.20이 marker 참조 API를 deprecated로 둔다)와 이름 끝 마디가audit·security인 logger를 표본에서 뺀다.ResolvedProfileJsonProvider가 줄을 쓸 때의 해석된 profile을 쓴다.LogMaskingPatterns: 키 목록을 넓히고, 여러 줄 PEM 블록(같은 라벨의 END까지, 없으면 끝까지)과 URI userinfo 비밀번호(host가 뒤따르는 첫@까지, 256자 상한, 선형 시간)를 가린다. 버린 안:full_except_last_4구현(끝 네 자리를 남길 값이 없다).MetricsRegistryCodeAlignmentTest가 행 → 코드(이름이 상수면 그 상수를 쓰는 곳까지)와 코드(글자·상수 이름의 builder·registry·Metrics·Observation호출) → 행 두 방향을 보고, 형태마다 기준 meter 하나를 찾아 scan 자체가 살아 있는지도 본다.HeaderRegistryRuntimeAlignmentTest·StructuredLogFieldContractTest도 코드 상수와 대조한다. 공용 도우미MainSources에 위반 fixture 시험을 둔다. 버린 안: 틀린 행만 지우기(새 지표가 다시 빠진다).MetricsDistributionMeterFilter대상을 같은 집합으로 묶었고, histogram을 켜지 않는 hikaricp timer 행은 평균으로 경보한다.http.client.ratelimit.rejected,fileserver.upload.offset.mismatch). in-process lock을MeteredDistributedLock으로 감쌌다.정한 기본값
headers.yaml의service:출처는 서비스 controller가 읽으라고 둔ApiHeaders상수 셋(Idempotency-Key,If-Match,If-None-Match)만 쓴다. 시험이 그 목록과 「템플릿 main이 쓰지 않음」을 강제한다.tracestate는 W3C 전파가 쓰는framework:행으로 둔다.job.retry.total·job.dlq.total행은 지우지 않고emitted_when을 적는다.@·/·#·?가 있어도 가리고, 포트(host:8080/)와 경로·query의@는 비밀번호로 보지 않는다. 공백이 든 비밀번호와 숫자 뒤에/가 오는 비밀번호는 못 가린다.__LOCAL_DEV_db_password__,__LOCAL_DEV_minio_root__,__LOCAL_DEV_keycloak_admin__.위험과 영향
profile칸의 출처가 바뀐다.HeaderSanitizer가 지워진다. 로컬 compose의 옛 volume은 옛 비밀번호로 만들어졌으면 DB·MinIO 접속이 실패한다. 할 일은docs/upgrade/2026-11-round9-observability.md113행이다(B6a 15, B6b 67, B5 813).검증
e6c3b159기준, 트리745f1c7a): lockfile 재생성(outbox-relay·app-bootstrap, 바뀐 것 없음) 뒤spotlessApply,:adapter:inbound:web:systemTest :app-bootstrap:systemTest :app-bootstrap:documentContractTest :app-bootstrap:repositoryContractTest :app-bootstrap:verifyEnvKeysrc=0,scripts/verify.sh prrc=0(시험 6931건, 실패 0, 건너뜀 35).docs/capability-status.md제거 표의 한 칸(마지막으로 존재한 커밋을 새 기준e6c3b159로)만 다르다. 문서 검사는 노트북에서 다시 돌렸다(OK).-Werror가Marker.contains(String)·iterator()deprecated와 ErrorProneStringConcatToTextBlock을 잡아 고쳤다.python3 scripts/check-docs.py·check-work-docs.py·verify-httpclient-docs.pyOK.리뷰어가 볼 곳
src/bootstrap/app/src/test/java/dev/caskeleton/bootstrap/contract/MetricsRegistryCodeAlignmentTest.java,contract/support/MainSources.java,HeaderRegistryRuntimeAlignmentTest.java.LogMaskingPatterns규칙 0·4와 시험,SamplingTurboFilter,LoggedPath,ServerFailureLog.forBackgroundTask.docs/registries/metrics.yaml·headers.yaml·mdc-keys.yaml·secrets-classification.yaml,docs/upgrade/2026-11-round9-observability.md.발견 판정
75df761575df761575df761575df761575df7615a7f44d8aa7f44d8aa7f44d8aManagementSecurityConfigJavadoc)354b7fc9354b7fc9354b7fc9354b7fc9354b7fc9관련
docs/reviews/2026-11-12-round9-review/(색인 「묶음」 B5·B6a·B6b).ApachePoolMetricsBinder,MongoTransactionRetry지연.ResilienceRejectionRecorder가breaker::state를 gauge 상태 객체로 넘겨 GC 뒤http.client.circuit.state가 NaN일 수 있다(탐침 필요).ApiHeaders.DEPRECATION·DATE는 쓰는 곳 없는 공개 상수다. graphql의 observation convention bean 둘이 Spring observation에 연결되지 않는다.로그 줄이 남기지 말아야 할 값을 싣고, 남겨야 할 줄을 버린다. 401·403 보안 WARN, route를 못 찾은 요청 로그, 처리하지 못한 예외 ERROR가 원본 request URI(식별자·토큰이 든 경로)를 싣는다. outbox relay·파일 서버 정리 스케줄러는 실패를 통째로 남겨 SQL·제약 이름·값이 원인 사슬로 따라간다. SamplingTurboFilter는 INFO 이하를 logger 구분 없이 표본으로 버려 감사 logger의 INFO 줄도 사라진다. JSON 로그 profile 칸은 Logback이 처음 읽은 환경 변수 값이라 Spring이 해석한 profile과 다를 수 있다. HeaderSanitizer는 운영 코드가 부르지 않는 공개 유틸리티로 남아 있다. - LoggedPath: route template이 있으면 그것, 없으면 식별자가 들 수 있는 마디를 {}로 가린 경로. 세 줄이 모두 쓴다. 버린 안: 원본 URI 그대로 두고 문서로 경고(로그 수집기가 이미 받는다). - 스케줄러 실패는 새 ServerFailureLog.forBackgroundTask로 남긴다: 분류된 persistence 실패는 원인 사슬 없이, 그 밖의 carrier는 client 쪽 코드여도 stack과 함께(요청이 없으니 결함이다). composition:outbox-relay에 shared-contract edge를 더한다(gradle/modules.json). - SamplingTurboFilter는 AUDIT marker와 이름 끝 마디가 audit·security인 logger를 표본에서 뺀다(이름별 판정은 캐시). - ResolvedProfileJsonProvider가 줄을 쓸 때의 해석된 profile을 쓴다. - HeaderSanitizer와 시험을 지우고 capability-status 제거 표에 적는다. 위험: 경로를 보던 로그 검색이 가린 경로를 본다. 감사 줄이 표본에서 빠져 양이 늘 수 있다. docs/upgrade/2026-11-round9-observability.md 1~5행. 검증: desktop에서 바뀐 leaf check·:app-bootstrap:test·systemTest· documentContractTest·repositoryContractTest, scripts/verify.sh pr rc=0 (묶음 셋을 합친 트리). 새 시험은 고치기 전 트리에서 실패했다(RED). Refs: RR9-02-09, RR9-02-15, RR9-02-21, RR9-02-22, RR9-02-26 BREAKING CHANGE: 보안·요청·예외 로그 줄의 경로 값과 JSON profile 칸의 출처, HeaderSanitizer 삭제. docs/upgrade/2026-11-round9-observability.md 1~5행.