---
kind: CONCEPT
slug: messaging-observability-c04
title: 거절된 태그 집합도 세어서 남긴다
topic: delivery-and-settlement-models
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: concept:messaging-observability-c04
evidenceCapturedOn: 2026-09-01
assets:
  - key: messaging-observability-c04
    file: ../../../final/evidence/rendered/messaging-observability-c04.svg
evidence:
  - ../../../final/evidence/raw/messaging-observability-c04.txt
source:
  - 원본 분석 절은 analysis/messaging/messaging-observability.md#L334 이다.
module: messaging-observability
---

# 거절된 태그 집합도 세어서 남긴다

메트릭: 호출자가 MessagingTags를 만들어 MessagingObservation의 다섯 메서드 중 하나를 호출 → MessagingMetrics.admitted(tags) → guard.admit(tags) → 통과하면 Micrometer Tags로 변환 후 미터 기록, 거절되면 rejectedTagSets.increment() 추적(발행): tracer.inject(context, headers) → traceparent 없으면 그대로 반환 → 있으면 세 헤더를 platform factory로 추가 추적(수신): tracer.extract(headers) → traceparent 없으면 TraceContext.none() → 있으면 세 값으로 TraceContext 재구성(core-api의 W3C 검증을 통과해야 함) 감사: 호출자가 MessagingAuditEvent를 만들어 sink에 record

## 관계

- **타입이 문서화한 불변식은 타입이 강제한다**
  같은 분석 리프에서 끌어낸 규칙이다.

## 본문

<!-- body:start -->

**메트릭:** 호출자가 `MessagingTags`를 만들어 `MessagingObservation`의 다섯 메서드 중 하나를 호출 → `MessagingMetrics.admitted(tags)` → `guard.admit(tags)` → 통과하면 Micrometer `Tags`로 변환 후 미터 기록, 거절되면 `rejectedTagSets.increment()`.

## MessagingTags 참조 위치

:::evidence key="messaging-observability-c04" alt="코드베이스에서 MessagingTags 를 검색한 출력 37줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="MessagingTags 코드베이스 검색 — 37줄 · exit 0" zoom="true"
:::

## 추적 — 발행 쪽

`tracer.inject(context, headers)` → `traceparent` 없으면 그대로 반환 → 있으면 세 헤더를 `platform` factory로 추가.

## 추적 — 수신 쪽

`tracer.extract(headers)` → `traceparent` 없으면 `TraceContext.none()` → 있으면 세 값으로 `TraceContext` 재구성(**core-api의 W3C 검증을 통과해야 함**).

## 감사

호출자가 `MessagingAuditEvent`를 만들어 sink에 `record` 한다.

<!-- body:end -->