Files
clean-architecture-backend-…/docs/registries/metrics.yaml
T
DongHyeonka 354b7fc959
pr / done (pull_request) Canceled after 0s
fix(observability)!: 지표·MDC·헤더 registry를 코드가 실제로 내는 것과 맞춘다
관측 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행.
2026-11-13 13:12:27 +09:00

1651 lines
66 KiB
YAML

# Registry: Metrics
# Schema owner: feature-contract-registry-governance
# Owner branch: feature-metrics-alerting-contract
# Last updated: 2026-05-22
#
# 읽는 법
# - 이름: Micrometer dot.case다. 단위는 `unit` 칸(seconds | bytes | total)이 말하고, 새 이름에는 단위를 다시 쓰지
# 않는다. Prometheus로 내보낼 때 Micrometer가 timer에 _seconds, counter에 _total을 붙인다(gauge에는 base unit이
# 있을 때만 붙고, unit이 total인 count gauge에는 붙지 않는다). 단위로 끝나는 옛 이름
# (outbox.publisher.published.total 같은 .total, redis.lane.acquire.wait.seconds, http.client.request.bytes·
# response.bytes, fileserver.transfer.bytes)은 이름을 바꾸면 대시보드가 깨지므로 그대로 둔다.
# - 행은 코드가 실제로 등록하는 meter다. `source`가 그 출처다: 이름 글자를 가진 main 파일 또는 `framework: …`
# (Spring Boot·Micrometer·HikariCP·Spring for GraphQL이 내는 것). 이름이 상수로만 있으면 `constant`와 그 상수를 쓰는
# `registered_by` 파일도 적는다. MetricsRegistryCodeAlignmentTest가 행 → 코드(상수면 그 상수를 쓰는 곳까지),
# 그리고 글자·상수 이름으로 등록한 meter → 행의 두 방향을 대조한다. capability를 켠 서비스에서만 나오는 meter도
# 행이 있다(그 행의 절 제목이 말한다). `emitted_when`이 있는 행은 템플릿 코드가 부르지 않는 공개 메서드를 서비스가
# 부를 때만 생긴다.
# - tag 값 개수(cardinality) 상한의 정본은 feature-metrics-alerting-contract의 "Cardinality Bounds" 표다.
# - 값 개수가 많은 tag는 어디서도 쓰지 않는다: user_id, request_id, raw_url, raw_query,
# raw_header_value, ip_address. 어떤 행에도 나오면 안 된다.
# - tenant_id label은 크기가 정해진 매핑 표의 id나 cohort bucket만 쓴다(ULID 원문 금지).
# - error_code tag의 cardinality_limit은 error-codes.yaml 행 수를 따른다(최대 100).
# - alert_severity_thresholds 값은 경보 조건을 사람이 읽는 글로 적은 것이다. 지표 이름·연산자·
# 기간(5m, 1h)은 원문 그대로 두고, 테스트는 키(p1·p2·p3)와 값이 비어 있지 않은지만 본다.
metrics:
# === HTTP 서버 (inbound) ===
# Spring MVC가 요청마다 기록하는 timer다. tag는 Spring Framework 기본 observation convention 그대로다.
# 지연(p99) 경보도 이 timer로 건다.
- name: http.server.requests
type: timer
unit: seconds
tags:
- name: method
cardinality_limit: 8
allowed_values: [GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, OTHER]
- name: status
# 숫자 HTTP status(200, 404, …). 서비스가 실제로 답하는 코드 수가 상한이다.
cardinality_limit: 40
- name: uri
# 맞는 route의 template(/v1/orders/{id}), 없으면 NOT_FOUND·REDIRECTION·UNKNOWN·root.
cardinality_limit: 200
validation: must_be_template_not_raw_uri
- name: outcome
cardinality_limit: 6
allowed_values: [INFORMATIONAL, SUCCESS, REDIRECTION, CLIENT_ERROR, SERVER_ERROR, UNKNOWN]
- name: exception
# 예외 클래스의 단순 이름, 없으면 none.
cardinality_limit: 50
- name: error
cardinality_limit: 50
percentiles: [0.5, 0.9, 0.95, 0.99]
histogram_buckets: slo_driven
alert_severity_thresholds:
p1: "error_rate > 5%가 5m 동안(또는 > 10%가 1m), 또는 p99 > 5s가 5m 동안"
p2: "error_rate > 1%가 10m 동안, 또는 p99 > 1s가 10m 동안"
p3: "error_rate > 0.1%가 1h 동안, 또는 p99 > 500ms가 30m 동안"
owner_branch: feature-metrics-alerting-contract
log_field_mapping: [method, status, uri_template]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: Spring MVC 요청 observation(Spring Framework 기본 convention)"
# === DB connection pool (HikariCP, persistence-jpa를 켤 때) ===
# HikariCP의 Micrometer tracker가 내는 이름 그대로다. acquire timer에는 pool tag 하나뿐이다. 획득 timeout은
# 따로 센다(hikaricp.connections.timeout).
- name: hikaricp.connections.acquire
type: timer
unit: seconds
tags:
- name: pool
cardinality_limit: 5
# histogram을 켜는 것이 없다(MetricsDistributionMeterFilter 대상이 아니다). 경보는 평균(sum/count)으로 건다.
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "평균 acquire 시간(sum/count) > 100ms가 5m 동안"
owner_branch: feature-persistence-failure-baseline
log_field_mapping: [pool]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: HikariCP Micrometer tracker(persistence-jpa를 켤 때)"
- name: hikaricp.connections.timeout
type: counter
unit: total
tags:
- name: pool
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p1: "timeout 증가 > 0이 1m 동안(pool 고갈: active == max)"
owner_branch: feature-persistence-failure-baseline
log_field_mapping: [pool]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: HikariCP Micrometer tracker(persistence-jpa를 켤 때)"
- name: hikaricp.connections.pending
type: gauge
unit: total
tags:
- name: pool
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "pending > 0이 5m 동안"
owner_branch: feature-persistence-failure-baseline
log_field_mapping: [pool]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: HikariCP Micrometer tracker(persistence-jpa를 켤 때)"
# source: feature-persistence-failure-baseline — In scope "Hikari metric 노출 기준" + Hikari Alert Threshold
- name: hikaricp.connections.usage
type: timer
unit: seconds
tags:
- name: pool
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "평균 usage 시간(sum/count) > 1s가 10m 동안(connection을 오래 쥔 트랜잭션)"
owner_branch: feature-persistence-failure-baseline
log_field_mapping: [pool]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: HikariCP Micrometer tracker(persistence-jpa를 켤 때)"
# source: feature-persistence-failure-baseline — In scope "Hikari metric 노출 기준"
- name: hikaricp.connections.active
type: gauge
unit: total
tags:
- name: pool
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p1: "active == max가 1m 동안"
owner_branch: feature-persistence-failure-baseline
log_field_mapping: [pool]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: HikariCP Micrometer tracker(persistence-jpa를 켤 때)"
# === 백그라운드 작업 / 비동기 executor ===
# source: feature-background-job-async-contract — Decisionized Work Items "saturation policy"
# "AbortPolicy default (core=10, max=50, queue=200)"
- name: executor.saturation
type: gauge
unit: total
tags:
- name: executor_name
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "queue 크기 > 용량의 80%가 5m 동안"
p1: "거절 비율 > 0이 1m 동안"
owner_branch: feature-background-job-async-contract
log_field_mapping: [executor_name]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/app/src/main/java/dev/caskeleton/bootstrap/async/BackgroundJobMetrics.java"
# source: feature-background-job-async-contract — Decisionized Work Items "saturation | bounded executor + rejection log"
- name: executor.rejected.total
type: counter
unit: total
tags:
- name: executor_name
cardinality_limit: 10
- name: policy
cardinality_limit: 3
allowed_values: [AbortPolicy, CallerRunsPolicy, DiscardPolicy]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p1: "rejection_count > 0이 1m 동안"
owner_branch: feature-background-job-async-contract
log_field_mapping: [executor_name, policy]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/app/src/main/java/dev/caskeleton/bootstrap/async/BackgroundJobMetrics.java"
# source: feature-background-job-async-contract — Decisionized Work Items "retry/DLQ | exp backoff jitter, max 3, DLQ exhausted"
- name: job.retry.total
type: counter
unit: total
tags:
- name: job_name
cardinality_limit: 50
- name: outcome
cardinality_limit: 4
allowed_values: [SUCCESS, RETRY, EXHAUSTED, DLQ]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "EXHAUSTED 비율 > 1%가 10m 동안"
owner_branch: feature-background-job-async-contract
log_field_mapping: [job_name, outcome, retry_attempt]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/app/src/main/java/dev/caskeleton/bootstrap/async/BackgroundJobMetrics.java"
emitted_when: "서비스가 BackgroundJobMetrics.recordRetryOutcome을 부를 때. 템플릿 코드는 부르지 않는다"
# source: feature-background-job-async-contract — "DLQ after exhausted attempts"
- name: job.dlq.total
type: counter
unit: total
tags:
- name: job_name
cardinality_limit: 50
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p1: "DLQ 비율 > 0이 5m 동안 계속"
owner_branch: feature-background-job-async-contract
log_field_mapping: [job_name]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/app/src/main/java/dev/caskeleton/bootstrap/async/BackgroundJobMetrics.java"
emitted_when: "서비스가 BackgroundJobMetrics.recordDeadLetter를 부를 때. 템플릿 코드는 부르지 않는다"
# === Distributed lock ===
# source: feature-distributed-lock-contract D7 — "metric lock.acquisition (tag: outcome =
# acquired/timeout/error) — 신규 제안" / D5 — try-lock + 유한 waitTime + lease(TTL). lock 획득
# 시도 결과를 센다: 분산 상호배제(distributedLockProvider)와 단일 인스턴스 in-process lock 모두
# MeteredDistributedLock으로 감싼다. key 는 tag 로 넣지 않는다
# (무한 cardinality — 위 전역 금지 규칙). timeout outcome 은 LOCK_ACQUISITION_TIMEOUT 발생과 1:1.
- name: lock.acquisition
type: counter
unit: total
tags:
- name: outcome
cardinality_limit: 3
allowed_values: [acquired, timeout, error]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "timeout 비율 > 5%가 10m 동안"
owner_branch: feature-distributed-lock-contract
log_field_mapping: [outcome]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/lock/MeteredDistributedLock.java"
# source: feature-distributed-lock-contract §Edge / D5 (SI-LOCK-C5) — "lease 만료 후 unlock →
# ConcurrentModificationException — 삼킴 금지, 로그+metric 후 정상 흐름 복귀". lease가 이미 만료된 뒤의
# 해제를 센다(보유자가 close()를 부르기 전에 다른 인스턴스가 JdbcLock 행을 회수함). 0이 아닌 비율이
# 이어지면 lease TTL이 실제 임계 구역 시간보다 짧다는 뜻이다 — APP/lease TTL을 늘리거나 보호하는 일을
# 줄인다. 획득 결과가 아니라서 lock.acquisition과 다른 counter다.
- name: lock.lease.expired
type: counter
unit: total
tags: []
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "lease-expired 비율 > 0이 10m 동안 계속"
owner_branch: feature-distributed-lock-contract
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/lock/MeteredDistributedLock.java"
# === Outbox 발행기 ===
# source: feature-domain-event-outbox-contract — Outbox Defaults
# "DB outbox table with eventId, aggregateId, eventType, payload, occurredAt, status, attemptCount, nextAttemptAt"
- name: outbox.publisher.published.total
type: counter
unit: total
tags:
- name: event_type
cardinality_limit: 50
- name: outcome
cardinality_limit: 5
# 행 상태가 아니라 relay 한 바퀴의 결과(OutboxRelayResult.Outcome)다. IN_FLIGHT는 상태라 세지 않는다.
# STALE: relay의 claim을 결과를 쓰기 전에 다른 쪽이 넘겨받았다(V17 lease fence). RELEASED: 멈추는 relay가
# 쓰지 않은 claim을 돌려줬다.
allowed_values: [PUBLISHED, FAILED, DEAD, STALE, RELEASED]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "FAILED 비율 > 1%가 10m 동안, 또는 STALE > 0이 10m 동안(in-flight timeout이 relay 정지보다 짧다)"
owner_branch: feature-domain-event-outbox-contract
log_field_mapping: [event_type, outcome, event_id]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/outbox-relay/src/main/java/dev/caskeleton/composition/outbox/OutboxMetrics.java"
# source: feature-domain-event-outbox-contract — 행 상태 enum PENDING/IN_FLIGHT/PUBLISHED/FAILED/DEAD
- name: outbox.publisher.lag
type: gauge
unit: seconds
tags:
- name: event_type
cardinality_limit: 50
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "lag > 60s가 10m 동안"
p1: "lag > 300s가 5m 동안"
owner_branch: feature-domain-event-outbox-contract
log_field_mapping: [event_type]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/outbox-relay/src/main/java/dev/caskeleton/composition/outbox/OutboxMetrics.java"
# source: feature-domain-event-outbox-contract — row status enum + Outbox Defaults attemptCount
# PARKED: 끝없이 재시도되던 행을 운영자가 붙잡아 둠 (re-review 2026-11-03 RR-05-03).
- name: outbox.pending.size
type: gauge
unit: total
tags:
- name: status
cardinality_limit: 6
allowed_values: [PENDING, IN_FLIGHT, PUBLISHED, FAILED, DEAD, PARKED]
percentiles: null
histogram_buckets: null
# DEAD > 0: claim은 내주지 않을 행을 relay 결과 없이 DEAD로 옮기므로
# outbox.publisher.published.total{outcome=DEAD}가 그것을 놓친다 (re-review round 2, RR-02-12).
alert_severity_thresholds:
p1: "DEAD > 0 (runbook://outbox/dead-letter)"
p2: "PENDING 크기가 10m 동안 늘어남"
owner_branch: feature-domain-event-outbox-contract
log_field_mapping: [status]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/outbox-relay/src/main/java/dev/caskeleton/composition/outbox/OutboxMetrics.java"
# source: re-review 2026-11-03 RR-05-03 — 지금의 거절과 답이 없는 발행은 끝없이 재시도된다. 이 둘은
# 10번 이상 미뤄진 FAILED 행을 세고(OutboxMetrics LONG_RETRY_DEFERRED_CLAIMS, publish-failed runbook §4.1
# 조회), 그중 가장 오래된 것의 나이를 잰다.
- name: outbox.retry.long.size
type: gauge
unit: total
tags: []
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "> 0이 10m 동안 (runbook://outbox/publish-failed §4.1)"
owner_branch: feature-domain-event-outbox-contract
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/outbox-relay/src/main/java/dev/caskeleton/composition/outbox/OutboxMetrics.java"
- name: outbox.retry.long.age
type: gauge
unit: seconds
tags: []
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "> 3600 (runbook://outbox/publish-failed §4.1)"
owner_branch: feature-domain-event-outbox-contract
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/outbox-relay/src/main/java/dev/caskeleton/composition/outbox/OutboxMetrics.java"
# === Redis 연결 lane ===
# source: review 2026-11-03 RR-04-02 — 캐시의 조건부 쓰기는 자기 lane(CACHE_SCRIPT)을 받았다. 캐시 채우기가
# idempotency·rate limiting·lease의 SCRIPT lane 연결을 가져가지 못하게 하려는 것이다. 이 meter들이 lane마다
# 그것이 지켜지는지 보여 준다. redis-runtime RedisLaneMetrics가 RedisRuntimeOwner가 pool로 가진 모든 lane에
# 대해, context에 MeterRegistry가 있을 때만 낸다. 모든 counter 계열은 기동 때 0으로 등록한다.
- name: redis.lane.acquire.wait.seconds
type: timer
unit: seconds
tags:
- name: lane
# lane 이름: REGULAR, SCRIPT (redis-runtime), CACHE_SCRIPT (cache-redis), BLOCKING,
# TRANSACTION, ADMIN (redis-sdk), 그리고 서비스가 RedisLaneContribution으로 조립한 lane.
cardinality_limit: 12
- name: outcome
cardinality_limit: 2
allowed_values: [admitted, refused]
# RedisLaneMetrics가 등록하는 모양: percentile histogram(publishPercentileHistogram, 예상 범위
# 1ms..10s)이고, client 쪽 percentile과 SLO 경계는 없다. 아래 p99는 bucket 위의 histogram_quantile이다
# (re-review 2026-11-04 RR-03-17).
percentiles: null
histogram_buckets: percentile_histogram
alert_severity_thresholds:
p2: "SCRIPT admitted p99 > 100ms가 10m 동안(정확성 lane이 줄을 서고 있다)"
p3: "CACHE_SCRIPT admitted p99 > 100ms가 30m 동안"
owner_branch: redis-production-capability
log_field_mapping: [lane, outcome]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/config/RedisLaneMetrics.java"
- name: redis.lane.acquire.refused.total
type: counter
unit: total
tags:
- name: lane
# lane 이름: REGULAR, SCRIPT (redis-runtime), CACHE_SCRIPT (cache-redis), BLOCKING,
# TRANSACTION, ADMIN (redis-sdk), 그리고 서비스가 RedisLaneContribution으로 조립한 lane.
cardinality_limit: 12
- name: reason
cardinality_limit: 4
allowed_values: [saturated, closing, interrupted, connect_failed]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p1: "정확성 role을 고른 상태에서 SCRIPT 또는 REGULAR의 saturated나 connect_failed가 0보다 큰 상태가 2m 동안"
p2: "CACHE_SCRIPT saturated가 기준선보다 높은 상태가 10m 동안"
owner_branch: redis-production-capability
log_field_mapping: [lane, reason]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/config/RedisLaneMetrics.java"
- name: redis.lane.connections.opened.total
type: counter
unit: total
tags:
- name: lane
# lane 이름: REGULAR, SCRIPT (redis-runtime), CACHE_SCRIPT (cache-redis), BLOCKING,
# TRANSACTION, ADMIN (redis-sdk), 그리고 서비스가 RedisLaneContribution으로 조립한 lane.
cardinality_limit: 12
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p3: "warm-up 뒤 opened 비율이 기준선보다 높은 상태가 15m 동안(느린 Redis에 다시 연결하며 흔들림)"
owner_branch: redis-production-capability
log_field_mapping: [lane]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/config/RedisLaneMetrics.java"
- name: redis.lane.connections.discarded.total
type: counter
unit: total
tags:
- name: lane
# lane 이름: REGULAR, SCRIPT (redis-runtime), CACHE_SCRIPT (cache-redis), BLOCKING,
# TRANSACTION, ADMIN (redis-sdk), 그리고 서비스가 RedisLaneContribution으로 조립한 lane.
cardinality_limit: 12
- name: reason
cardinality_limit: 2
allowed_values: [invalidated, broken]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p3: "invalidated 비율이 기준선보다 높은 상태가 15m 동안(timeout·실패한 호출이 연결을 버림)"
owner_branch: redis-production-capability
log_field_mapping: [lane, reason]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/config/RedisLaneMetrics.java"
- name: redis.lane.connections.active
type: gauge
unit: total
tags:
- name: lane
# lane 이름: REGULAR, SCRIPT (redis-runtime), CACHE_SCRIPT (cache-redis), BLOCKING,
# TRANSACTION, ADMIN (redis-sdk), 그리고 서비스가 RedisLaneContribution으로 조립한 lane.
cardinality_limit: 12
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "SCRIPT active == 설정한 maximum-script-connections가 5m 동안"
owner_branch: redis-production-capability
log_field_mapping: [lane]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/config/RedisLaneMetrics.java"
- name: redis.lane.connections.pending
type: gauge
unit: total
tags:
- name: lane
# lane 이름: REGULAR, SCRIPT (redis-runtime), CACHE_SCRIPT (cache-redis), BLOCKING,
# TRANSACTION, ADMIN (redis-sdk), 그리고 서비스가 RedisLaneContribution으로 조립한 lane.
cardinality_limit: 12
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "SCRIPT pending > 0이 5m 동안"
owner_branch: redis-production-capability
log_field_mapping: [lane]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/config/RedisLaneMetrics.java"
# === 로그 appender ===
# source: feature-log-management-contract — Sampling Policy (final)
# "async appender overflow default: drop oldest INFO/DEBUG with counter metric (log.appender.dropped.total)"
- name: log.appender.dropped.total
type: counter
unit: total
tags:
- name: appender
cardinality_limit: 5
- name: level
cardinality_limit: 2
allowed_values: [INFO, DEBUG]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "dropped > 0이 10m 동안 계속"
owner_branch: feature-log-management-contract
log_field_mapping: [appender, level]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/app/src/main/java/dev/caskeleton/bootstrap/logging/MetricsAsyncAppender.java"
# === 분산 추적 ===
# source: feature-distributed-tracing-contract — decisions
# "trace sampling rate default = prod 1%, dev/local 100%; shipped runtime profiles are local|dev|prod"
- name: tracing.sampling.rate
type: gauge
unit: total
tags:
- name: profile
cardinality_limit: 3
allowed_values: [prod, dev, local]
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p3: "실제 비율이 설정값과 1h 동안 어긋남"
owner_branch: feature-distributed-tracing-contract
log_field_mapping: [profile]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/bootstrap/service-runtime/src/main/java/dev/caskeleton/composition/runtime/tracing/TracingSamplingRateGauge.java"
# === JVM 기본 ===
# source: feature-metrics-alerting-contract — In scope "JVM/process metric"
- name: jvm.memory.used
type: gauge
unit: bytes
tags:
- name: area
cardinality_limit: 2
allowed_values: [heap, nonheap]
- name: id
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p2: "heap used / max > 0.85가 10m 동안"
owner_branch: feature-metrics-alerting-contract
log_field_mapping: [area, id]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: Micrometer JVM binder(Spring Boot)"
# source: feature-metrics-alerting-contract — In scope "JVM/process metric"
- name: jvm.gc.pause
type: timer
unit: seconds
tags:
- name: action
cardinality_limit: 10
- name: cause
cardinality_limit: 10
percentiles: [0.5, 0.9, 0.95, 0.99]
histogram_buckets: slo_driven
alert_severity_thresholds:
p2: "p99 pause > 500ms가 10m 동안"
owner_branch: feature-metrics-alerting-contract
log_field_mapping: [action, cause]
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: Micrometer JVM binder(Spring Boot)"
# source: feature-metrics-alerting-contract — In scope "JVM/process metric"
- name: jvm.threads.live
type: gauge
unit: total
tags: []
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p3: "thread 수 > 기준선의 2배가 30m 동안"
owner_branch: feature-metrics-alerting-contract
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: Micrometer JVM binder(Spring Boot)"
# source: feature-metrics-alerting-contract — In scope "JVM/process metric" (process uptime)
- name: process.uptime
type: gauge
unit: seconds
tags: []
percentiles: null
histogram_buckets: null
alert_severity_thresholds:
p1: "uptime이 예상 밖으로 < 60s로 초기화됨(crash loop 신호)"
owner_branch: feature-metrics-alerting-contract
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: Micrometer process binder(Spring Boot)"
# === GraphQL (adapter:inbound:graphql를 켤 때) ===
# observation 이름이다. timer 하나와 long-task timer(<이름>.active) 하나가 된다.
# operation 이름은 observed-operation-names 허용 목록 밖이면 하나로 묶인다(GraphQlOperationNameCardinality).
- name: graphql.request
type: timer
unit: seconds
tags:
- name: graphql.operation.name
cardinality_limit: 50
- name: graphql.operation.type
cardinality_limit: 3
allowed_values: [QUERY, MUTATION, SUBSCRIPTION]
- name: graphql.client.profile
cardinality_limit: 10
- name: graphql.persisted
cardinality_limit: 2
allowed_values: [true, false]
- name: graphql.outcome
cardinality_limit: 5
- name: error.type
# 오류가 있을 때만 붙는다.
cardinality_limit: 10
- name: graphql.complexity.bucket
# 복잡도를 셌을 때만 붙는다.
cardinality_limit: 6
- name: graphql.depth.bucket
cardinality_limit: 6
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: graphql-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/observation/GraphQlObservationNames.java"
constant: GraphQlObservationNames.REQUEST
registered_by: "src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/observation/GraphQlRequestObservationConvention.java"
# Spring for GraphQL 기본 observation. tag는 Spring 기본 convention(DefaultDataFetcherObservationConvention)
# 그대로다. 이 저장소의 convention bean은 이 두 observation에 붙지 않는다.
- name: graphql.datafetcher
type: timer
unit: seconds
tags:
- name: graphql.outcome
cardinality_limit: 2
allowed_values: [SUCCESS, ERROR]
- name: graphql.field.name
# schema의 field 이름. schema의 field 수가 상한이다.
cardinality_limit: 500
- name: graphql.error.type
# 예외 클래스의 단순 이름, 없으면 NONE.
cardinality_limit: 20
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: graphql-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: Spring for GraphQL observation(이름은 GraphQlObservationNames와 같다)"
- name: graphql.dataloader
type: timer
unit: seconds
tags:
- name: graphql.outcome
cardinality_limit: 2
allowed_values: [SUCCESS, ERROR]
- name: graphql.loader.name
# 등록한 DataLoader 이름, 모르면 unknown.
cardinality_limit: 50
- name: graphql.error.type
# 예외 클래스의 단순 이름, 없으면 NONE.
cardinality_limit: 20
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: graphql-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "framework: Spring for GraphQL observation(이름은 GraphQlObservationNames와 같다)"
# DataLoader 없이 부모마다 풀린 field. 임계를 넘은 요청에 한 번 기록한다(GraphQlPerParentFetchInstrumentation).
- name: graphql.per.parent.fetch
type: timer
unit: seconds
tags:
- name: graphql.schema.coordinate
cardinality_limit: 200
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: graphql-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/observation/GraphQlObservationNames.java"
constant: GraphQlObservationNames.PER_PARENT_FETCH
registered_by: "src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlPerParentFetchInstrumentation.java"
# === 알림 platform (composition:notification-platform을 켤 때) ===
- name: notification.requested
type: counter
unit: total
tags:
- name: notificationCategory
cardinality_limit: 20
- name: strategy
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.REQUESTED
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionService.java"
- name: notification.suppressed
type: counter
unit: total
tags:
- name: channel
cardinality_limit: 5
- name: reason
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.SUPPRESSED
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipeline.java"
- name: notification.dispatch
type: counter
unit: total
tags:
- name: channel
cardinality_limit: 5
- name: provider
cardinality_limit: 20
- name: result
cardinality_limit: 8
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.DISPATCH
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java"
- name: notification.provider.accepted
type: counter
unit: total
tags:
- name: channel
cardinality_limit: 5
- name: provider
cardinality_limit: 20
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.PROVIDER_ACCEPTED
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java"
- name: notification.ambiguous
type: counter
unit: total
tags:
- name: channel
cardinality_limit: 5
- name: provider
cardinality_limit: 20
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.AMBIGUOUS
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java"
- name: notification.delivery
type: counter
unit: total
tags:
- name: channel
cardinality_limit: 5
- name: provider
cardinality_limit: 20
- name: outcome
cardinality_limit: 6
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.DELIVERY
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectionService.java"
- name: notification.callback
type: counter
unit: total
tags:
- name: provider
cardinality_limit: 20
- name: result
cardinality_limit: 8
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.CALLBACK
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java"
- name: notification.reconciliation
type: counter
unit: total
tags:
- name: provider
cardinality_limit: 20
- name: correction
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.RECONCILIATION
registered_by: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java"
- name: notification.queue.depth
type: gauge
unit: total
tags: []
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: notification-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/application/notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java"
constant: NotificationMetricName.QUEUE_DEPTH
registered_by: "src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/NotificationSchedulerWorker.java"
# === outbound HTTP client (adapter:outbound:httpclient를 켤 때) ===
# Spring의 RestClient observation은 끄고 이 이름으로 기록한다(tag 이름도 이 leaf 것이다). attempt의 outcome은
# success|failure, 논리 호출은 ambiguous도 있다.
- name: http.client.attempts
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
- name: transport
cardinality_limit: 3
- name: protocol
cardinality_limit: 3
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.ATTEMPT_COUNTER
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/AttemptObservation.java"
- name: http.client.requests
type: timer
unit: seconds
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
- name: transport
cardinality_limit: 3
- name: protocol
cardinality_limit: 3
- name: status
cardinality_limit: 40
- name: evidence
cardinality_limit: 5
- name: outcome
cardinality_limit: 2
allowed_values: [success, failure]
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.ATTEMPT_TIMER
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/AttemptObservation.java"
- name: http.client.timeout
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
- name: transport
cardinality_limit: 3
- name: protocol
cardinality_limit: 3
- name: timeoutType
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.TIMEOUT
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/AttemptObservation.java"
- name: http.client.request.bytes
type: distribution_summary
unit: bytes
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
- name: transport
cardinality_limit: 3
- name: protocol
cardinality_limit: 3
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.REQUEST_BYTES
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/AttemptObservation.java"
- name: http.client.response.bytes
type: distribution_summary
unit: bytes
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
- name: transport
cardinality_limit: 3
- name: protocol
cardinality_limit: 3
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.RESPONSE_BYTES
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/AttemptObservation.java"
- name: http.client.logical.calls
type: timer
unit: seconds
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
- name: status
cardinality_limit: 40
- name: evidence
cardinality_limit: 5
- name: outcome
cardinality_limit: 3
allowed_values: [success, failure, ambiguous]
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.LOGICAL_CALL_TIMER
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/LogicalCallObservation.java"
- name: http.client.retry.count
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
- name: retryReason
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.RETRY_COUNT
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/LogicalCallObservation.java"
- name: http.client.retry.exhausted
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.RETRY_EXHAUSTED
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/LogicalCallObservation.java"
- name: http.client.ambiguous
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: operationName
cardinality_limit: 100
- name: method
cardinality_limit: 8
- name: uriTemplate
cardinality_limit: 200
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.AMBIGUOUS
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/LogicalCallObservation.java"
# 값 1 = open, 0 = 그 밖.
- name: http.client.circuit.state
type: gauge
unit: total
tags:
- name: clientName
cardinality_limit: 50
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.CIRCUIT_STATE
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRejectionRecorder.java"
- name: http.client.circuit.state.rejected
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.CIRCUIT_REJECTED
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRejectionRecorder.java"
- name: http.client.ratelimit.rejected
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.RATE_LIMIT_REJECTED
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRejectionRecorder.java"
- name: http.client.bulkhead.rejected
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.BULKHEAD_REJECTED
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRejectionRecorder.java"
- name: http.client.ssrf.rejected
type: counter
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: outcome
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.SSRF_REJECTED
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DefaultDynamicTargetGateway.java"
- name: http.client.pool.connections
type: gauge
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: transport
cardinality_limit: 3
- name: state
cardinality_limit: 3
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.POOL_CONNECTIONS
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/apache/ApachePoolMetricsBinder.java"
- name: http.client.pool.pending
type: gauge
unit: total
tags:
- name: clientName
cardinality_limit: 50
- name: transport
cardinality_limit: 3
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: httpclient
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/HttpClientObservationNames.java"
constant: HttpClientObservationNames.POOL_PENDING
registered_by: "src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/apache/ApachePoolMetricsBinder.java"
# === 파일 서버 (composition:fileserver-platform을 켤 때) ===
- name: fileserver.upload.duration
type: timer
unit: seconds
tags:
- name: mode
cardinality_limit: 5
- name: storage
cardinality_limit: 5
- name: result
cardinality_limit: 6
- name: size_bucket
cardinality_limit: 6
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.download.duration
type: timer
unit: seconds
tags:
- name: transfer_mode
cardinality_limit: 5
- name: range_type
cardinality_limit: 4
- name: result
cardinality_limit: 6
- name: size_bucket
cardinality_limit: 6
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.transfer.bytes
type: counter
unit: bytes
tags:
- name: direction
cardinality_limit: 2
allowed_values: [upload, download]
- name: storage
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.transfer.active
type: gauge
unit: total
tags:
- name: direction
cardinality_limit: 2
allowed_values: [upload, download]
- name: instance
cardinality_limit: 50
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.transfer.interruption
type: counter
unit: total
tags:
- name: direction
cardinality_limit: 2
allowed_values: [upload, download]
- name: reason
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.upload.offset.mismatch
type: counter
unit: total
tags:
- name: mode
cardinality_limit: 5
- name: client_type
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.checksum.failure
type: counter
unit: total
tags:
- name: algorithm
cardinality_limit: 5
- name: stage
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.verification.queue
type: counter
unit: total
tags:
- name: verifier
cardinality_limit: 5
- name: verdict
cardinality_limit: 5
- name: age_bucket
cardinality_limit: 6
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.quota
type: counter
unit: total
tags:
- name: scope_type
cardinality_limit: 5
- name: result
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.cleanup
type: counter
unit: total
tags:
- name: type
cardinality_limit: 5
- name: result
cardinality_limit: 5
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.download.delegation
type: counter
unit: total
tags:
- name: size_bucket
cardinality_limit: 6
- name: delegated
cardinality_limit: 2
allowed_values: [true, false]
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
- name: fileserver.access.denial
type: counter
unit: total
tags:
- name: operation
cardinality_limit: 10
- name: policy_code
cardinality_limit: 20
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: fileserver-platform
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/observability/MicrometerFileserverMetrics.java"
# === MongoDB (adapter:outbound:persistence-mongo를 켤 때) ===
- name: mongodb.driver.command
type: timer
unit: seconds
tags:
- name: mongoProfile
cardinality_limit: 10
- name: operationType
cardinality_limit: 20
- name: result
cardinality_limit: 3
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-mongo
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/observation/MongoCommandObservationListener.java"
- name: mongodb.driver.pool.checkedout
type: gauge
unit: total
tags:
- name: mongoProfile
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-mongo
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/observation/MongoPoolObservationListener.java"
- name: mongodb.driver.pool.checkout.waiting
type: gauge
unit: total
tags:
- name: mongoProfile
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-mongo
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/observation/MongoPoolObservationListener.java"
- name: mongodb.driver.pool.checkout.failed
type: counter
unit: total
tags:
- name: mongoProfile
cardinality_limit: 10
- name: failureCategory
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-mongo
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/observation/MongoPoolObservationListener.java"
- name: mongodb.driver.topology.changed
type: counter
unit: total
tags:
- name: mongoProfile
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-mongo
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/observation/MongoSdamObservationListener.java"
- name: mongodb.driver.primary.changed
type: counter
unit: total
tags:
- name: mongoProfile
cardinality_limit: 10
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-mongo
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/observation/MongoSdamObservationListener.java"
- name: mongodb.operation
type: timer
unit: seconds
tags:
- name: mongoProfile
cardinality_limit: 10
- name: databaseProfile
cardinality_limit: 10
- name: collectionProfile
cardinality_limit: 50
- name: operationName
cardinality_limit: 50
- name: operationType
cardinality_limit: 20
- name: consistencyProfile
cardinality_limit: 5
- name: result
cardinality_limit: 8
- name: failureCategory
cardinality_limit: 21
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-mongo
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/observation/MicrometerMongoOperationObserver.java"
# === JPA query 관측 (adapter:outbound:persistence-jpa, 실행기가 MicrometerQueryObservation을 쓸 때) ===
- name: jpa.query.duration
type: timer
unit: seconds
tags:
- name: persistence.unit
cardinality_limit: 5
- name: persistence.operation
cardinality_limit: 10
- name: persistence.query
# 등록한 QueryName이다(SQL 원문이 아니다).
cardinality_limit: 200
- name: outcome
cardinality_limit: 6
- name: failure.category
cardinality_limit: 20
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-jpa
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/observation/MicrometerQueryObservation.java"
- name: jpa.query.rows
type: distribution_summary
unit: total
tags:
- name: persistence.unit
cardinality_limit: 5
- name: persistence.operation
cardinality_limit: 10
- name: persistence.query
cardinality_limit: 200
- name: outcome
cardinality_limit: 6
- name: failure.category
cardinality_limit: 20
percentiles: null
histogram_buckets: null
alert_severity_thresholds: {}
owner_branch: persistence-jpa
log_field_mapping: []
compatibility_impact: additive
required_test: contract-verification:metrics-cardinality
source: "src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/observation/MicrometerQueryObservation.java"