---
title: blog-topic / micrometer-meterfilter-resilience4j-functioncounter
source_type: blog-topic
status: raw
related_branches: [feature-outbound-http-client-baseline]
related_projects: [ca-tmpl]
tags: [blog-topic, ca-tmpl, observability, micrometer, circuit-breaker, metric-naming, high-cardinality]
created: 2026-07-02
status_label: ready-for-canonical
target_audience: backend-engineer
inspiration_url:
archive_url:
---

# blog-topic: micrometer-meterfilter-resilience4j-functioncounter

> Layer: `raw/blog-topics/` — 작업 중 나온 블로그 글감 원석. 최종 블로그는 canonical 정제 후 `wiki/blog/`에서 작성한다.

## Parent / 부모

- [[raw/branch-notes/feature-outbound-http-client-baseline]] — Micrometer MeterFilter와 Resilience4j FunctionCounter 충돌 회피 쟁점에서 나온 글감.

## 트리거 / Trigger

- 트리거 유형: `branch-work`
- 트리거 날짜: 2026-07-02
- 트리거 연결 노트: [[raw/branch-notes/feature-outbound-http-client-baseline]]

## 글감 / Topic seed

- 한 문장 요지: outbound HTTP observability에서 Micrometer `MeterFilter`와 Resilience4j `FunctionCounter` registration/tag policy가 충돌할 수 있는 지점을 정리한다.
- 예상 제목 후보:
  - MeterFilter가 Resilience4j metric을 만날 때 생기는 문제
  - outbound HTTP metric tag policy를 어디서 강제할까

## 핵심 주장 후보 / Claim candidates

- 사실 후보:
  - branch가 Micrometer MeterFilter와 Resilience4j FunctionCounter 충돌 회피 topic을 명시한다 — 근거 후보: [[raw/branch-notes/feature-outbound-http-client-baseline]] line `:374`.
- 경험 후보:
  - metrics tag/registration 문제를 운영 관측성 글감으로 분리할 수 있다.
- 의견/해석 후보:
  - metric naming/cardinality policy는 application metric만이 아니라 library-generated metric에도 영향을 준다.

## Outline seed

1. library metric도 내 관측성 계약 안에 들어온다 — Resilience4j가 생성한 meter를 어떻게 다룰지 정해야 한다.
2. MeterFilter는 강력하지만 순서와 scope가 중요하다 — registration 시점의 tag policy를 확인한다.
3. cardinality guard와 circuit breaker metric의 균형 — 필요한 label과 금지 label을 나눈다.

## Canonical 전환 후보 / Canonical extraction candidates

- `wiki/projects/ca-tmpl/outbound-http-client-baseline.md` 후보:
  - outbound HTTP metrics integration decision.
- `wiki/concepts/micrometer-meterfilter-ordering.md` 후보:
  - Micrometer MeterFilter와 library meter registration 일반 개념.
- 필요한 추가 검증:
  - 실제 meter 이름, tag set, filter ordering test.

## Sources / 근거 후보

- [[raw/branch-notes/feature-outbound-http-client-baseline]] — Micrometer/Resilience4j topic seed 근거.

## 미해결 / Unknown

- 아직 확인해야 할 사실: FunctionCounter registration과 MeterFilter 적용 순서.
- 과장하면 안 되는 부분: Micrometer/Resilience4j 자체의 일반 결함처럼 쓰지 않는다. ca-tmpl metric contract와 integration edge로 제한한다.
- 블로그로 쓰기 전에 필요한 canonical 정제: official docs/raw source 보강 필요.

## Decision / 처리 결정

- 액션: `promote-to-canonical`
- 이유: `wiki/projects/ca-tmpl/data-layer-persistence-cache-outbound.md` 에 Micrometer/Resilience4j metric registration edge 글감으로 반영했다.
- 다음 단계: target canonical이 아직 `draft` 이므로 `blogify` 전 review/verify가 필요하다. Micrometer/Resilience4j 자체의 일반 결함처럼 쓰지 않는다.

## Related / 관련

- 관련 branch: [[raw/branch-notes/feature-outbound-http-client-baseline]]
- 관련 error:
- 관련 interview prep:
- derived blog: 생성 전. 생성 시 `wiki/blog/micrometer-meterfilter-resilience4j-functioncounter-YYYY-MM-DD.md` 후보