코어 시스템 텔레메트리

코어 시스템 텔레메트리는 Vault 인스턴스의 운영 상태에 대한 정보를 제공합니다.

출처: 문서

본문

기본 메트릭

vault.core.active

Metric type	Value	Description
gauge	boolean	Vault 노드가 활성(active)인지 여부를 나타냄

A value of 1 indicates that the node is active.
A value of 0 indicates that the node is in standby.

vault.core.activity.fragment_size

Metric type	Value	Description
counter	number	로컬 노드가 관측한 `type` 객체 수

fragment size 메트릭에는 개수 세어진 객체가 엔티티인지 토큰인지 나타내는 라벨이 포함됩니다.

vault.core.activity.segment_write

Metric type	Value	Description
summary	ms	활동 로그 세그먼트를 스토리지에 기록하는 데 필요한 시간

vault.core.check_token

Metric type	Value	Description
summary	ms	토큰 검사를 완료하는 데 필요한 시간

vault.core.fetch_acl_and_token

Metric type	Value	Description
summary	ms	ACL과 토큰 엔트리를 가져오는 데 필요한 시간

vault.core.handle_login_request

Metric type	Value	Description
summary	ms	로그인 요청을 완료하는 데 필요한 시간

vault.core.handle_request

Metric type	Value	Description
summary	ms	비-로그인 요청을 완료하는 데 필요한 시간

vault.core.in_flight_requests

Metric type	Value	Description
gauge	requests	현재 진행 중인 요청 수

vault.core.response_status_code

Metric type	Value	Description
counter	number	로컬 노드가 발행한 응답 수

응답 코드 메트릭에는 다음 라벨이 포함됩니다.

code - exact HTTP status code of the response, for example, 429.
type - HTTP response class of the response status, for example 4xx.

vault.core.leadership_lost

Metric type	Value	Description
summary	ms	고가용성(HA) 클러스터 노드가 마지막으로 리더십을 유지한 총 시간

리더십 시간 갱신은 리더십이 바뀔 때마다 발생합니다. 낮은 리더십 시간으로 vault.core.leadership_lost가 자주 갱신되면 리더 상태가 노드 간에 회전하면서 리더가 흔들리는(flapping) 것을 나타냅니다.

vault.core.leadership_setup_failed

Metric type	Value	Description
summary	ms	가장 최근 리더십 설정 실패에 걸린 시간

설정 실패 시간은 고가용성(HA) Vault 설치 환경의 중요한 상태 메트릭입니다. vault.core.leadership_setup_failed를 면밀히 모니터링하고 전체 클러스터 리더십 상태를 알려주는 알림을 설정하시길 강력히 권합니다.

vault.core.license.expiration_time_epoch

Metric type	Value	Description
gauge	timestamp	라이선스가 만료될 시점의 에포크 시간(1970-01-01 이후 초)

vault.core.license.termination_time_epoch

Metric type	Value	Description
gauge	timestamp	라이선스가 종료될 시점의 에포크 시간(1970-01-01 이후 초)

vault.core.locked_users

Metric type	Value	Description
gauge	users	현재 Vault에서 잠긴(locked out) 사용자 수

잠긴 사용자 수는 15분마다 새로고침됩니다.

vault.core.mount_table.num_entries

Metric type	Value	Description
gauge	objects	주어진 마운트 테이블의 마운트 수

마운트포인트 수 메트릭에는 해당 테이블이 인증 테이블인지 논리 테이블인지, 그리고 복제되는지 로컬인지를 나타내는 라벨이 포함됩니다.

vault.core.mount_table.size

Metric type	Value	Description
gauge	bytes	해당 마운트 테이블의 현재 크기

테이블 크기 메트릭에는 해당 테이블이 인증 테이블인지 논리 테이블인지, 그리고 복제되는지 로컬인지를 나타내는 라벨이 포함됩니다.

vault.core.performance_standby

Metric type	Value	Description
gauge	boolean	보고 노드가 성능 대기(performance standby)인지 여부를 나타냄

A value of 1 indicates the node is a performance standby
A value of 0 indicates the node is not a performance standby

vault.core.replication.dr.primary

Metric type	Value	Description
gauge	boolean	Vault 노드가 재해 복구 프라이머리인지 여부를 나타냄

A value of 1 indicates that the node is a disaster recovery primary.
A value of 0 indicates that the node is not a disaster recovery primary.

vault.core.replication.dr.secondary

Metric type	Value	Description
gauge	boolean	Vault 노드가 재해 복구 세컨더리인지 여부를 나타냄

A value of 1 indicates that the node is a disaster recovery secondary.
A value of 0 indicates that the node is not a disaster recovery secondary.

vault.core.replication.performance.primary

Metric type	Value	Description
gauge	boolean	Vault 노드가 성능 프라이머리인지 여부를 나타냄

A value of 1 indicates that the node is a performance primary.
A value of 0 indicates that the node is not a performance primary.

vault.core.replication.performance.secondary

Metric type	Value	Description
gauge	boolean	Vault 노드가 성능 세컨더리인지 여부를 나타냄

A value of 1 indicates that the node is a performance secondary.
A value of 0 indicates that the node is not a performance secondary.

vault.core.replication.write_undo_logs

Metric type	Value	Description
gauge	boolean	undo 로그가 활성화되었는지 여부를 나타냄

A value of 1 indicates that Vault is generating undo logs.
A value of 0 indicates that Vault is not generating undo logs.

vault.core.step_down

Metric type	Value	Description
summary	ms	클러스터 리더십을 내려놓는(step down) 데 필요한 시간

Barrier metrics

vault.barrier.delete

Metric type	Value	Description
summary	ms	배리어(barrier)에서 `DELETE` 작업을 완료하는 데 필요한 시간

vault.barrier.estimated_encryptions

Metric type	Value	Description
counter	number	마지막 키 로테이션 이후 수행된 추정 암호화 수

vault.barrier.get

Metric type	Value	Description
summary	ms	배리어에서 `GET` 작업을 완료하는 데 필요한 시간

vault.barrier.list

Metric type	Value	Description
summary	ms	배리어에서 `LIST` 작업을 완료하는 데 필요한 시간

vault.barrier.put

Metric type	Value	Description
summary	ms	배리어에서 `PUT` 작업을 완료하는 데 필요한 시간

Caching metrics

vault.cache.delete

Metric type	Value	Description
counter	number	LRU 캐시에서의 삭제 수

vault.cache.hit

Metric type	Value	Description
counter	number	구성된 스토리지 읽기를 피한 LRU 캐시 히트 수

vault.cache.miss

Metric type	Value	Description
counter	number	구성된 스토리지 읽기를 요구한 LRU 캐시 미스 수

vault.cache.write

Metric type	Value	Description
counter	number	LRU 캐시에 대한 쓰기 수

Metric collection metrics

vault.metrics.collection

Metric type	Value	Description
summary	ms	게이지 유형별로 사용량 데이터를 수집하는 데 필요한 평균 시간

vault.metrics.collection.error

Metric type	Value	Description
counter	number	Vault가 게이지 유형별로 사용량 데이터를 수집하면서 발생한 총 오류 수

vault.metrics.collection.interval

Metric type	Units	Description
summary	time duration	`usage_gauge_period`의 현재 값

Quota metrics

쿼터 메트릭은 속도 제한 및 임대 수 쿼터와 관련됩니다. 각 메트릭에는 특정 쿼터를 식별하는 name 라벨이 붙습니다.

vault.quota.lease_count.counter

Metric type	Value	Description
gauge	lease	명명된 쿼터 규칙과 연결된 임대 총 수

보고되는 임대 수는 name 라벨에 나열된 쿼터 규칙에 한정된 값이지, 일반적인 임대 수가 아닙니다. 예를 들어 명명된 규칙이 최대 50개의 임대를 허용하고 그 쿼터 규칙 범위에 현재 40개의 임대가 있다면, 범위가 없거나 다른 쿼터 규칙 범위에 있는 임대가 1000개 있더라도 vault.quota.lease_count.counter 값은 40입니다.

vault.quota.lease_count.max

Metric type	Value	Description
gauge	lease	명명된 쿼터 규칙이 허용하는 최대 임대 수

vault.quota.lease_count.violation

Metric type	Value	Description
counter	number	명명된 임대 수 쿼터를 초과해 거부된 요청 수

vault.quota.rate_limit.violation

Metric type	Value	Description
counter	number	명명된 속도 제한 쿼터 규칙을 초과해 거부된 요청 수

Request limiter metrics

요청 제한기(Request Limiter) 메트릭은 요청 제한기가 관측한 요청 성공 신호와 현재 상태와 관련됩니다. 참고로 요청 제한기는 폐기(deprecated)되어 향후 Vault 버전에서 제거될 예정입니다.

vault.core.limits.concurrency.write

Metric type	Value	Description
gauge	number	현재 허용된 진행 중 쓰기 요청 수

vault.core.limits.concurrency.special_path

Metric type	Value	Description
gauge	number	현재 허용된 진행 중(in-flight) 특수 경로 요청 수

vault.core.limits.concurrency.service_unavailable

Metric type	Value	Description
counter	number	요청 제한기가 거부한 요청 수

vault.core.limits.concurrency.success

Metric type	Value	Description
counter	number	요청 제한기가 관측한 성공한 요청 수

vault.core.limits.concurrency.dropped

Metric type	Value	Description
counter	number	요청 제한기가 관측한 심각한 요청 오류 수

vault.core.limits.concurrency.ignored

Metric type	Value	Description
counter	number	요청 제한기(request limiter)가 관측한 무시된 요청 오류 수

무시된 요청 오류는 요청이 일찍 취소되어 발생합니다. 이 오류들은 지연 시간 측정을 왜곡하지 않도록 요청 제한기 측정에서 제외됩니다.

Rollback metrics

기본적으로 Vault는 롤백 메트릭을 마운트포인트별로 구분하지 않습니다. 마운트포인트에 대해 명시적으로 명명된 메트릭을 활성화하려면 telemetry 구성 스탠자에서 add_mount_point_rollback_metrics 옵션을 켜세요.

마운트포인트에 대해 명명된 메트릭을 활성화하면 메트릭 이름은 마운트 이름의 슬래시(/)를 대시(-)로 변환합니다. 예를 들어 auth/token 백엔드가 구성되고 마운트포인트 이름이 텔레메트리용으로 활성화되어 있으면 해당 마운트 포인트 메트릭 문자열은 auth-token입니다.

vault.rollback.attempt.{MOUNTPOINT}

Metric type	Value	Description
summary	ms	주어진 마운트 지점에서 롤백 작업을 수행하는 데 필요한 시간

vault.rollback.attempt

Metric type	Value	Description
summary	ms	롤백 작업을 수행하는 데 필요한 시간

vault.rollback.inflight

Metric type	Value	Description
gauge	number	진행 중(in-flight)인 롤백 작업 수

vault.rollback.queued

Metric type	Value	Description
guage	number	시작을 기다리는 롤백 작업 수

vault.rollback.waiting

Metric type	Value	Description
summary	ms	롤백 작업을 큐에 넣고 작업이 시작될 때까지의 시간

Route metrics

각 구성된 마운트 포인트에 대한 마운트별 라우트 메트릭입니다. 메트릭 이름은 마운트 이름의 슬래시(/)를 대시(-)로 변환합니다. 예를 들어 auth/token 백엔드가 구성되어 있으면 해당 마운트 포인트 메트릭 문자열은 auth-token입니다.

vault.route.create.{MOUNTPOINT}

Metric type	Value	Description
summary	ms	주어진 마운트 지점에 대해 백엔드로 생성 요청을 보내고 백엔드가 작업을 완료하는 데 필요한 시간

vault.route.delete.{MOUNTPOINT}

Metric type	Value	Description
summary	ms	주어진 마운트 지점에 대해 백엔드로 삭제 요청을 보내고 백엔드가 작업을 완료하는 데 필요한 시간

vault.route.list.{MOUNTPOINT}

Metric type	Value	Description
summary	ms	주어진 마운트 지점에 대해 백엔드로 목록 요청을 보내고 백엔드가 작업을 완료하는 데 필요한 시간

vault.route.read.{MOUNTPOINT}

Metric type	Value	Description
summary	ms	주어진 마운트 지점에 대해 백엔드로 읽기 요청을 보내고 백엔드가 작업을 완료하는 데 필요한 시간

vault.route.rollback.{MOUNTPOINT}

Metric type	Value	Description
summary	ms	주어진 마운트 지점에 대해 백엔드로 롤백 요청을 보내고 백엔드가 작업을 완료하는 데 필요한 시간

Vault는 부분 오류를 정리하기 위해 마운트 포인트 롤백 작업을 자동으로 예약·수행합니다.

vault.route.rollback

Metric type	Value	Description
summary	ms	백엔드로 롤백 요청을 보내고 백엔드가 작업을 완료하는 데 필요한 시간

Vault는 부분 오류를 정리하기 위해 마운트 포인트 롤백 작업을 자동으로 예약·수행합니다.

런타임 메트릭

런타임 메트릭은 Vault 인스턴스의 Go 런타임과 구체적으로 관련됩니다.

vault.runtime.alloc_bytes

Metric type	Value	Description
gauge	bytes	현재 Vault 프로세스에 할당된 공간

할당된 바이트 수는 때때로 정점을 찍을 수 있지만, 정상 Vault 설치 환경에서는 항상 안정 상태 값으로 돌아와야 합니다.

vault.runtime.free_count

Metric type	Value	Description
gauge	number	해제된 객체 수

vault.runtime.gc_pause_ns

Metric type	Value	Description
summary	ns	마지막 가비지 컬렉션 실행을 완료하는 데 필요한 시간

vault.runtime.heap_objects

Metric type	Value	Description
gauge	number	메모리 힙의 객체 총 수

vault.runtime.heap_objects 메트릭은 좋은 메모리 압박 지표입니다. Vault 설치 환경의 상태에 대한 정확한 기준선과 알림 임계값을 세우기 위해 vault.runtime.heap_objects를 모니터링하시길 권합니다.

vault.runtime.malloc_count

Metric type	Value	Description
gauge	number	메모리에 할당된 힙 객체 총 수

vault.runtime.num_goroutines

Metric type	Value	Description
gauge	number	메모리에서 실행 중인 Go 루틴 총 수

vault.runtime.num_goroutines 메트릭은 좋은 시스템 부하 지표입니다. Vault 설치 환경의 상태에 대한 정확한 기준선과 알림 임계값을 세우기 위해 vault.runtime.num_goroutines를 모니터링하시길 권합니다.

vault.runtime.sys_bytes

Metric type	Value	Description
gauge	number	Vault에 할당된 총 바이트 수

할당된 시스템 바이트 총 수는 힙이 현재 사용하는 공간에 운영 체제가 회수했지만 반환하지 않은 공간을 더한 값입니다.

vault.runtime.total_gc_pause_ns

Metric type	Value	Description
gauge	ns	Vault가 마지막으로 시작된 이후의 총 가비지 컬렉터 중단 시간

vault.runtime.total_gc_runs

Metric type	Value	Description
gauge	number	Vault가 마지막으로 시작된 이후의 총 가비지 컬렉션 실행 수

Seal metrics

vault.core.post_unseal

Metric type	Value	Description
summary	ms	post-unseal 작업을 완료하는 데 필요한 시간

vault.core.pre_seal

Metric type	Value	Description
summary	ms	pre-seal 작업을 완료하는 데 필요한 시간

vault.core.seal.encrypt

Metric type	Value	Description
counter	number	seal 래핑된 값이 암호화된 횟수

vault.core.seal.encrypt.time

Metric type	Value	Description
summary	ms	seal 래핑된 값을 seal 암호화하는 데 걸린 시간

vault.core.seal.decrypt

Metric type	Value	Description
counter	number	seal 래핑된 값이 복호화된 횟수

vault.core.seal.decrypt.time

Metric type	Value	Description
summary	ms	seal 래핑된 값을 seal 복호화하는 데 걸린 시간

vault.core.seal-internal

Metric type	Value	Description
summary	ms	내부 Vault 시일(seal) 작업을 완료하는 데 필요한 시간

vault.core.seal.unreachable.time

Metric type	Value	Description
summary	ms	건강 검사(health check)로 시일이 도달 불가능했던 총 시간

vault.core.seal-with-request

Metric type	Value	Description
summary	ms	명시적 요청으로 트리거된 시일(seal) 작업을 완료하는 데 필요한 시간

vault.core.unseal

Metric type	Value	Description
summary	ms	unseal 작업을 완료하는 데 필요한 시간

vault.core.unsealed

Metric type	Value	Description
gauge	boolean	Vault가 현재 unseal 상태인지 여부를 나타냄

A value of 1 indicates Vault is currently unsealed and clients can

시크릿을 읽을 수 있습니다.

A value of 0 indicates Vault is currently sealed and clients cannot

시크릿을 읽을 수 있습니다.