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