가용성 텔레메트리
가용성 텔레메트리는 Vault 인스턴스의 대기(standby)·활성 노드에 대한 정보를 제공합니다. Enterprise 설치 환경에는 복제 메트릭도 포함됩니다.
출처: 문서
본문
기본 메트릭
vault.ha.rpc.client.echo
| Metric type |
Value |
Description |
| summary |
ms |
대기 노드에서 활성 노드로 에코 요청을 보내는 데 걸린 시간(성능 대기에도 함께 내보내짐) |
vault.ha.rpc.client.echo.errors
| Metric type |
Value |
Description |
| counter |
number |
대기(standby) 에코 요청 실패 수(성능 대기에도 함께 내보내짐) |
vault.ha.rpc.client.forward
| Metric type |
Value |
Description |
| summary |
ms |
대기 노드에서 활성 노드로 요청을 전달하는 데 걸린 시간 |
vault.ha.rpc.client.forward.errors
| Metric type |
Value |
Description |
| counter |
number |
대기 요청 전달 실패 수 |
Merkle tree metrics
vault.merkle.flushDirty
| Metric type |
Value |
Description |
| summary |
ms |
dirty 페이지를 스토리지로 플러시하는 데 필요한 평균 시간 |
vault.merkle.flushDirty.num_pages
| Metric type |
Value |
Description |
| gauge |
pages |
플러시된 페이지 수 |
vault.merkle.flushDirty.outstanding_pages
| Metric type |
Value |
Description |
| gauge |
pages |
플러시 대기 중인 dirty 페이지 수 |
vault.merkle.saveCheckpoint
| Metric type |
Value |
Description |
| summary |
ms |
체크포인트를 저장하는 데 필요한 평균 시간 |
vault.merkle.saveCheckpoint.num_dirty
| Metric type |
Value |
Description |
| gauge |
pages |
체크포인트 시점의 dirty 페이지 수 |
Write-ahead log (WAL) telemetry
vault.wal.deleteWALs
| Metric type |
Value |
Description |
| summary |
ms |
WAL을 완전히 삭제하는 데 필요한 시간 |
vault.wal.flushReady
| Metric type |
Value |
Description |
| summary |
ms |
스토리지에 준비된 WAL을 완전히 플러시하는 데 필요한 시간 |
vault.wal.flushReady.queue_len
| Metric type |
Value |
Description |
| summary |
number |
WAL 시스템의 쓰기 큐 현재 크기 |
vault.wal.gc.deleted
| Metric type |
Value |
Description |
| gauge |
number |
가비지 컬렉션 중 삭제된 WAL 수 |
vault.wal.gc.total
| Metric type |
Value |
Description |
| gauge |
number |
현재 디스크에 있는 WAL 총 수 |
vault.wal.loadWAL
| Metric type |
Value |
Description |
| summary |
ms |
WAL을 로드하는 데 필요한 시간 |
vault.wal.persistWALs
| Metric type |
Value |
Description |
| summary |
ms |
WAL을 영속화하는 데 필요한 시간 |
vault.wal.write_controller.d
| Metric type |
Value |
Description |
| gauge |
number |
쓰기 컨트롤러가 계산한 현재 미분 값 |
vault.wal.write_controller.d 메트릭은 운영 사용이 제한적이지만, Vault 개발자는 컨트롤러 동작 튜닝이나 디버깅에 유용하게 쓸 수 있습니다.
vault.wal.write_controller.i
| Metric type |
Value |
Description |
| gauge |
number |
쓰기 컨트롤러가 계산한 현재 적분 값 |
vault.wal.write_controller.i 메트릭은 운영 사용이 제한적이지만, Vault 개발자는 컨트롤러 동작 튜닝이나 디버깅에 유용하게 쓸 수 있습니다.
vault.wal.write_controller.p
| Metric type |
Value |
Description |
| gauge |
number |
쓰기 컨트롤러가 감지한 현재 비례 오류 값 |
vault.wal.write_controller.p 메트릭은 운영 사용이 제한적이지만, Vault 개발자는 컨트롤러 동작 튜닝이나 디버깅에 유용하게 쓸 수 있습니다.
vault.wal.write_controller.reject_fraction
| Metric type |
Value |
Description |
| gauge |
number |
클러스터 안정성을 유지하기 위해 거부해야 하는 쓰기 요청의 추정 비율 |
쓰기 컨트롤러의 거부 비율(reject fraction)은 0과 1 사이의 추정값입니다.
Log shipping metrics
vault.logshipper.buffer.length
| Metric type |
Value |
Description |
| gauge |
buffer entries |
로그 시퍼(log shipper) 버퍼의 현재 길이 |
vault.logshipper.buffer.max_length
| Metric type |
Value |
Description |
| gauge |
buffer entries |
현재까지 관측된 로그 시퍼 버퍼의 최대 길이 |
vault.logshipper.buffer.max_size
| Metric type |
Value |
Description |
| gauge |
bytes |
로그 시퍼 버퍼의 허용 최대 크기 |
vault.logshipper.buffer.size
| Metric type |
Value |
Description |
| gauge |
bytes |
로그 시퍼 버퍼의 현재 크기 |
vault.logshipper.streamWALs.guard_found
| Metric type |
Value |
Description |
| counter |
number |
Vault가 WAL 엔트리 스트리밍을 시작해 Merkle 트리에서 시작 인덱스를 찾은 횟수 |
vault.logshipper.streamWALs.missing_guard
| Metric type |
Value |
Description |
| counter |
number |
Vault가 WAL 엔트리 스트리밍을 시작했지만 Merkle 트리에서 시작 인덱스를 찾지 못한 횟수 |
vault.logshipper.streamWALs.scanned_entries
| Metric type |
Value |
Description |
| summary |
entries |
Vault가 올바른 엔트리를 찾기 전에 버퍼에서 스캔한 엔트리 수 |
복제 메트릭
참고(Note)
다음 메트릭은 복제가 비정상 상태일 때만 텔레메트리 결과에 나타납니다.
vault.replication.fetchRemoteKeys
| Metric type |
Value |
Description |
| summary |
ms |
Merkle 트리 델타 생성 전에 복제에 참여하는 원격 클러스터에서 키를 가져오는 데 필요한 시간 |
vault.replication.fsm.last_remote_wal
| Metric type |
Value |
Description |
| gauge |
number |
마지막 원격 WAL(write-ahead log) 인덱스 |
참고(Note)
대기 노드는 last\_remote\_wal 세부 정보를 내보내지 않습니다.
vault.replication.fsm.last_upstream_remote_wal
| Metric type |
Value |
Description |
| gauge |
number |
로컬 클러스터 리더가 업스트림 클러스터에서 받은 마지막 원격 WAL 세그먼트 인덱스 |
vault.replication.merkle.commit_index
| Metric type |
Value |
Description |
| gauge |
number |
Merkle 트리에 대한 마지막 커밋의 인덱스 |
vault.replication.merkleDiff
| Metric type |
Value |
Description |
| summary |
ms |
복제에 참여하는 클러스터 간 Merkle 트리 델타 비교를 수행하는 데 필요한 시간 |
vault.replication.merkleSync
| Metric type |
Value |
Description |
| summary |
ms |
복제에 참여하는 클러스터가 생성한 가장 최근 델타로 Merkle 트리 동기화를 수행하는 데 필요한 시간 |
vault.replication.rpc.client.conflicting_pages
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 충돌 페이지 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.create_token_register_auth_lease
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 인증 토큰 등록 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.fetch_keys
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 키 페치 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.forward
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 전달(forward) 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.guard_hash
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 가드 해시 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.persist_alias
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 별칭을 영속화하는 데 필요한 시간 |
vault.replication.rpc.client.persist_pending_login_mfa_secret
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트가 대기 중인 로그인 MFA TOTP 시크릿을 영속화하는 데 필요한 시간 |
vault.replication.rpc.client.register_auth
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 인증 등록 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.register_lease
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 임대를 등록하는 데 필요한 시간 |
vault.replication.rpc.client.save_mfa_response_auth
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트가 MFA 인증 응답을 저장하는 데 필요한 시간 |
vault.replication.rpc.client.stream_wals
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트를 위해 WAL을 스트리밍하는 데 필요한 시간 |
vault.replication.rpc.client.sub_page_hashes
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 서브페이지 해시 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.sync_counter
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 카운터 동기화 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.upsert_group
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 그룹 upsert 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.client.wrap_in_cubbyhole
| Metric type |
Value |
Description |
| summary |
ms |
클라이언트의 cubbyhole 래핑 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.dr.server.echo
| Metric type |
Value |
Description |
| summary |
ms |
재해 복구용 에코 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.dr.server.fetch_keys_request
| Metric type |
Value |
Description |
| summary |
ms |
재해 복구용 키 페치(fetch) 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.auth_request
| Metric type |
Value |
Description |
| summary |
ms |
인증 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.bootstrap_request
| Metric type |
Value |
Description |
| summary |
ms |
부트스트랩 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.conflicting_pages_request
| Metric type |
Value |
Description |
| summary |
ms |
충돌 페이지 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.echo
| Metric type |
Value |
Description |
| summary |
ms |
에코 작업을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.last_heartbeat
| Metric type |
Value |
Description |
| gauge |
timestamp |
연결된 클러스터에서 마지막으로 받은 하트비트의 에포크 시간(1970-01-01 이후 초) |
vault.replication.rpc.server.forwarding_request
| Metric type |
Value |
Description |
| summary |
ms |
전달(forwarding) 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.guard_hash_request
| Metric type |
Value |
Description |
| summary |
ms |
가드 해시 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.persist_alias_request
| Metric type |
Value |
Description |
| summary |
ms |
별칭(alias)을 영속화하는 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.persist_persona_request
| Metric type |
Value |
Description |
| summary |
ms |
별칭(alias)을 영속화하는 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.save_mfa_response_auth
| Metric type |
Value |
Description |
| summary |
ms |
MFA 인증 응답을 저장하는 데 필요한 시간 |
vault.replication.rpc.server.stream_wals_request
| Metric type |
Value |
Description |
| summary |
ms |
WAL을 스트리밍하는 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.sub_page_hashes_request
| Metric type |
Value |
Description |
| summary |
ms |
서브페이지 해시 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.sync_counter_request
| Metric type |
Value |
Description |
| summary |
ms |
카운터 동기화 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.server.upsert_group_request
| Metric type |
Value |
Description |
| summary |
ms |
그룹 upsert 요청을 완료하는 데 필요한 시간 |
vault.replication.rpc.standby.server.create_token_register_auth_lease_request
| Metric type |
Value |
Description |
| summary |
ms |
대기(standby) 노드의 토큰 생성 요청을 처리하는 데 필요한 시간 |
vault.replication.rpc.standby.server.echo
| Metric type |
Value |
Description |
| summary |
ms |
대기 노드의 에코 요청을 처리하는 데 필요한 시간 |
vault.replication.rpc.standby.server.register_auth_request
| Metric type |
Value |
Description |
| summary |
ms |
대기 노드의 인증 등록 요청을 처리하는 데 필요한 시간 |
vault.replication.rpc.standby.server.register_lease_request
| Metric type |
Value |
Description |
| summary |
ms |
대기 노드의 임대 등록 요청을 처리하는 데 필요한 시간 |
vault.replication.rpc.standby.server.wrap_token_request
| Metric type |
Value |
Description |
| summary |
ms |
대기 노드의 래핑 토큰 요청을 처리하는 데 필요한 시간 |
vault.replication.wal.gc
| Metric type |
Value |
Description |
| summary |
ms |
WAL 가비지 컬렉션 프로세스의 한 번 실행을 완료하는 데 필요한 시간 |
vault.replication.wal.last_dr_wal
| Metric type |
Value |
Description |
| gauge |
number |
재해 복구용 마지막 WAL 인덱스. 클러스터 유형과 관계없이 모든 Vault Enterprise 클러스터에서 내보냅니다. |
| Metric type |
Value |
Description |
| gauge |
number |
성능용 마지막 WAL 인덱스 |
vault.replication.wal.last_wal
| Metric type |
Value |
Description |
| gauge |
number |
마지막 WAL 인덱스 |
더 알아보기 (Learn more)
