# 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"