Files
clean-architecture-backend-…/docs/registries/metrics.yaml
T
DongHyeonka e69c321eca fix(graphql)!: GraphQL 지표에 플랫폼 tag를 붙이고 key 묶음을 고정한다
GraphQlResolverObservationConvention·GraphQlDataLoaderObservationConvention
bean이 있지만 Spring for GraphQL observation에 붙지 않는다. 그래서
graphql.datafetcher·graphql.dataloader timer는 Spring 기본 tag
(graphql.field.name, graphql.loader.name, graphql.error.type)를 달고,
플랫폼이 정한 schema 좌표·resolver 무게·batch 크기 tag는 아무 지표에도
없다. 두 convention의 tag 이름도 뜻과 맞지 않는다: 무게를
graphql.operation.type으로, batch 크기를 graphql.complexity.bucket으로
단다. graphql.request는 오류가 없거나 복잡도를 세기 전에 끝난 요청에서
error.type·graphql.complexity.bucket을 빼는데, Prometheus registry는
이름이 같고 key 묶음이 다른 meter를 버린다. 먼저 등록된 쪽만 남고
성공이나 실패 한쪽이 /actuator/prometheus에서 사라진다.

Spring의 DataFetcherObservationConvention·DataLoaderObservationConvention을
구현한 adapter 둘(runtime 패키지)을 두고 GraphQlObservationConfiguration이
@ConditionalOnMissingBean으로 등록한다. resolver는 부모 타입과 field
이름으로 schema 좌표(Type.field)를 만들고, 좌표로 이름 붙일 수 없는
field(_Service.sdl 같은 federation field)는 unnamed와 기본 무게로 같은
key를 단다. DataLoader는 등록한 loader 이름, 또는 Spring이
@BatchMapping loader에 붙이는 schema 좌표(Book.author)를 이름으로 쓰고,
둘 다 아니면 unknown이다. graphql.request는 오류가 없으면
error.type=NONE, 복잡도를 세지 않았으면 graphql.complexity.bucket=unknown을
단다. tag 이름을 graphql.resolver.weight·graphql.batch.size.bucket으로
고치고 cardinality 허용 목록, metrics.yaml 세 행(Micrometer가 다는 error
tag 포함), 공개 API 스냅숏을 맞춘다. 응답 path와 batch key는 싣지 않는다.

버린 안: Spring 기본 convention을 두고 registry만 그 tag로 적기. 플랫폼
convention이 죽은 코드로 남고, field 이름만으로는 타입이 다른 같은 이름
field를 가를 수 없다. 기본 convention을 감싸 tag만 더하는 안은
graphql.error.type이 Micrometer의 error tag와 같은 값을 한 번 더 싣는다.

위험: 세 timer의 tag가 바뀐다. 옛 tag로 거른 대시보드·경보는 비고,
docs/upgrade/2026-11-round9-followups.md 1~4행이 옮기는 법을 적는다.
클래스 이름으로 등록한 loader는 unknown 하나로 묶인다. 자기
DataFetcherObservationConvention·DataLoaderObservationConvention bean을
둔 서비스는 그 bean이 그대로 쓰인다.

검증: desktop :adapter:inbound:graphql:check :adapter:inbound:graphql:systemTest
:adapter:inbound:graphql:verifyGraphQlApiSurface, scripts/verify.sh pr.

BREAKING CHANGE: graphql.datafetcher·graphql.dataloader timer의 tag가
graphql.schema.coordinate·graphql.outcome·graphql.resolver.weight와
graphql.dataloader.name·graphql.outcome·graphql.batch.size.bucket으로
바뀐다. graphql.request는 error.type=NONE·graphql.complexity.bucket=unknown을
단다. 두 convention의 tag key도 바뀐다.
Refs: round9 그룹 A 범위 밖 후속 1
2026-11-13 19:30:12 +09:00

1671 lines
68 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
# 오류 분류(REQUEST·INTERNAL), 오류가 없으면 NONE. 요청마다 같은 key 셋을 단다(Prometheus는 key 묶음이
# 다른 meter를 버린다).
cardinality_limit: 10
- name: graphql.complexity.bucket
# 복잡도 구간, 복잡도를 세기 전에 끝난 요청은 unknown.
cardinality_limit: 6
- name: graphql.depth.bucket
cardinality_limit: 6
- name: error
# Micrometer가 observation timer마다 단다: 예외 클래스의 단순 이름, 없으면 none.
cardinality_limit: 50
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"
# resolver·DataLoader observation. Spring for GraphQL이 내고, tag는 플랫폼 convention이 정한다
# (GraphQlResolverObservationConventionAdapter·GraphQlDataLoaderObservationConventionAdapter, 상한은
# GraphQlMetricCardinalityPolicy 허용 목록). response path와 batch key는 싣지 않는다.
- name: graphql.datafetcher
type: timer
unit: seconds
tags:
- name: graphql.schema.coordinate
# schema 좌표(Type.field). schema의 field 수가 상한이다. 좌표로 이름 붙일 수 없는 field는 unnamed.
cardinality_limit: 500
- name: graphql.outcome
cardinality_limit: 2
allowed_values: [SUCCESS, ERROR]
- name: graphql.resolver.weight
# cost 단계가 매긴 resolver 무게(등록 안 한 field는 EXTERNAL_BATCH).
cardinality_limit: 6
allowed_values: [PROPERTY, INDEXED_LOOKUP, BATCHED_RELATION, BOUNDED_AGGREGATION, EXTERNAL_BATCH, EXTERNAL_PER_OBJECT]
- name: error
# Micrometer가 observation timer마다 단다: 예외 클래스의 단순 이름, 없으면 none.
cardinality_limit: 50
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.RESOLVER
registered_by: "src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/observation/GraphQlResolverObservationConvention.java"
- name: graphql.dataloader
type: timer
unit: seconds
tags:
- name: graphql.dataloader.name
# 등록한 loader 이름, 또는 Spring이 @BatchMapping loader에 붙이는 schema 좌표(Book.author).
# 둘 다 아니면(클래스 이름 등) unknown. 등록한 loader와 schema field 수가 상한이다.
cardinality_limit: 500
- name: graphql.outcome
cardinality_limit: 2
allowed_values: [SUCCESS, ERROR]
- name: graphql.batch.size.bucket
cardinality_limit: 4
allowed_values: ["1", "2-10", "11-100", "100+"]
- name: error
# Micrometer가 observation timer마다 단다: 예외 클래스의 단순 이름, 없으면 none.
cardinality_limit: 50
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.DATA_LOADER
registered_by: "src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/observation/GraphQlDataLoaderObservationConvention.java"
# DataLoader 없이 부모마다 풀린 field. 임계를 넘은 요청에 한 번 기록한다(GraphQlPerParentFetchInstrumentation).
- name: graphql.per.parent.fetch
type: timer
unit: seconds
tags:
- name: graphql.schema.coordinate
cardinality_limit: 200
- name: error
# Micrometer가 observation timer마다 단다: 예외 클래스의 단순 이름, 없으면 none.
cardinality_limit: 50
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"