Consul 에이전트 텔레메트리(지표) 참조
Consul 에이전트 텔레메트리(지표) 참조
이 페이지는 Consul 에이전트가 발생시키는 이벤트와 지표(metrics)에 대한 참조 정보를 제공해요. 서비스 메시 트래픽 지표에 대한 정보는 서비스 메시 텔레메트리 관찰을 참조하세요.
출처: 문서
본문
ACL 지표 (ACL metrics)
ACL 하위 시스템과 관련된 지표로, ACL 작업에 필요한 시간과 차단된 작업을 측정해요.
| Metric | Description | Unit | Type |
| consul.acl.blocked.check.deregistration | deregistration이 ACL에 의해 차단되어 체크 등록 해제가 실패할 때마다 증가해요. | requests | counter |
| consul.acl.blocked.check.registration | (ACL에 의해 차단되어) 체크 등록이 실패할 때마다 증가해요. | requests | counter |
| consul.acl.blocked.node.registration | (ACL에 의해 차단되어) 노드 등록이 실패할 때마다 증가해요. | requests | counter |
| consul.acl.blocked.service.deregistration | (ACL에 의해 차단되어) 서비스 등록 해제가 실패할 때마다 증가해요. | requests | counter |
| consul.acl.blocked.service.registration | (ACL에 의해 차단되어) 서비스 등록이 실패할 때마다 증가해요. | requests | counter |
| consul.acl.ResolveToken | ACL 토큰을 해석하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.authmethod.delete | 인증 메서드를 삭제하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.authmethod.upsert | 인증 메서드를 생성하거나 갱신하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.bindingrule.delete | 바인딩 규칙을 삭제하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.bindingrule.upsert | 바인딩 규칙을 생성하거나 갱신하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.login | 인증 메서드를 사용해 ACL 로그인 작업을 완료하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.acl.logout | 세션을 무효화하는 ACL 로그아웃 작업을 완료하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.acl.policy.delete | ACL 정책을 삭제하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.policy.upsert | ACL 정책을 생성하거나 갱신하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.role.delete | ACL 역할을 삭제하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.role.upsert | ACL 역할을 생성하거나 갱신하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.token.cache_hit | 캐시에서 토큰의 정체성 또는 레거시 토큰을 해석할 수 있을 때 증가해요. | cache hits | count |
| consul.acl.token.cache_miss | 캐시에서 토큰의 정체성 또는 레거시 토큰을 해석할 수 없을 때 증가해요. | cache misses | count |
| consul.acl.token.clone | ACL 토큰을 복제하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.token.delete | ACL 토큰을 삭제하는 데 걸리는 시간이에요. | ms | summary |
| consul.acl.token.upsert | ACL 토큰을 생성하거나 갱신하는 데 걸리는 시간이에요. | ms | summary |
API 지표 (API metrics)
consul.api.http는 데이터센터에서 조회된 모든 API 엔드포인트에 대한 정보를 담고 있는 집계된 지표예요.
서로 다른 엔드포인트를 구분하기 위해 path와 method 레이블을 포함해요.
path에는 서비스나 키 이름 같은 세부 정보가 포함되지 않으며, 이런 경우 밑줄(_)이 자리표시자로 표시돼요 (예: path=v1.kv._).
| Metric | Description | Unit | Type |
| consul.api.http | 주어진 동사와 경로에 대해 주어진 HTTP 요청을 처리하는 데 걸리는 시간을 샘플링해요. | ms | timer |
Autopilot 지표 (Autopilot metrics)
autopilot 하위 시스템과 관련된 지표로, Consul 데이터센터의 전반적인 상태를 파악하는 데 사용할 수 있어요.
| Metric | Description | Unit | Type |
| consul.autopilot.failure_tolerance | 클러스터가 기능을 유지하면서 손실할 수 있는 투표 서버 수를 추적해요. | servers | gauge |
| consul.autopilot.healthy | 로컬 서버 클러스터의 전반적인 상태를 추적해요. 모든 서버가 정상이면 1, 하나 이상이 비정상이면 0. | health | gauge |
캐시 지표 (Cache metrics)
캐시 효율성을 모니터링하는 데 사용할 수 있는 Consul 캐시 관련 지표예요.
| Metric | Description | Unit | Type |
| consul.cache.bypass | 캐시 키가 제공되지 않아 요청이 캐시를 우회한 횟수를 세요. | requests | counter |
| consul.cache.entries_count | 이 캐시의 항목 수를 나타내요. | entries | gauge |
| consul.cache.evict_expired | 축출된 만료 항목 수를 세요. | entries | counter |
| consul.cache.fetch_error | 캐시의 실패한 fetch 수를 세요. | failed fetches | counter |
| consul.cache.fetch_success | 캐시의 성공한 fetch 수를 세요. | successful fetches | counter |
| consul.consul.cache.bypass | 더 이상 사용되지 않아요. 대신 cache.bypass를 사용하세요. | requests | counter |
| consul.consul.cache.entries_count | 더 이상 사용되지 않아요. 대신 cache.entries_count를 사용하세요. | entries | gauge |
| consul.consul.cache.evict_expired | 더 이상 사용되지 않아요. 대신 cache.evict_expired를 사용하세요. | entries | counter |
| consul.consul.cache.fetch_error | 더 이상 사용되지 않아요. 대신 cache.fetch_error를 사용하세요. | failed fetches | counter |
| consul.consul.cache.fetch_success | 더 이상 사용되지 않아요. 대신 cache.fetch_success를 사용하세요. | successful fetches | counter |
카탈로그 및 KV 스토어 지표 (Catalog and KV store metrics)
Consul catalog 및 KV store와 관련된 지표로, 요청 수와 쿼리 성능에 대한 정보를 담고 있어요.
| Metric | Description | Unit | Type |
| consul.catalog.connect.not_found | 주어진 서비스를 찾을 수 없는 connect 기반 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.catalog.connect.query | 주어진 서비스에 대한 connect 기반 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.catalog.connect.query_tag | 주어진 태그가 있는 서비스에 대한 connect 기반 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.catalog.connect.query_tags | 주어진 태그들이 있는 서비스에 대한 connect 기반 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.catalog.deregister | 카탈로그 등록 해제 작업을 완료하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.catalog.register | 카탈로그 등록 작업을 완료하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.catalog.service.not_found | 주어진 서비스를 찾을 수 없는 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.catalog.service.query | 주어진 서비스에 대한 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.catalog.service.query_tag | 주어진 태그가 있는 서비스에 대한 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.catalog.service.query_tags | 주어진 태그들이 있는 서비스에 대한 카탈로그 쿼리마다 증가해요. | queries | counter |
| consul.discovery_chain.get | 서비스 발견 체인 구성을 검색하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.kvs.apply | KV 스토어에 대한 업데이트를 완료하는 데 걸리는 시간을 측정해요. | ms | summary |
인증서 만료 지표 (Certificate expiration metrics)
다음 지표는 인증서 만료 및 갱신 상태를 위해 발생돼요.
| Metric | Description | Unit | Type |
| consul.mesh.active-root-ca.expiry | 활성 서비스 메시 루트 CA가 만료될 때까지의 초 수를 보고하는 리더 전용 게이지예요. datacenter 레이블을 포함해요. | seconds | gauge |
| consul.mesh.active-signing-ca.expiry | 활성 서비스 메시 서명 CA가 만료될 때까지의 초 수를 보고하는 리더 전용 게이지예요. datacenter 레이블을 포함해요. | seconds | gauge |
| consul.agent.tls.cert.expiry | 로컬 에이전트 TLS 인증서가 만료될 때까지의 초 수를 보고하는 게이지예요. datacenter, partition, node 레이블을 포함해요. | seconds | gauge |
| consul.leaf-certs.cert_expiry | 캐시된 서비스 리프 인증서가 만료될 때까지의 초 수를 보고하는 게이지예요. datacenter, partition, namespace, service, kind 레이블을 포함해요. | seconds | gauge |
| consul.leaf-certs.cert_renewal_failure | 캐시된 서비스 리프 인증서의 갱신이 실패하는 동안 1로 설정되고 복구 후 0으로 설정되는 게이지예요. 활성 실패에는 reason 레이블도 포함돼요. | 0 or 1 | gauge |
| consul.leaf-certs.renewal_success | 리프 인증서 갱신이 성공할 때 증가하는 카운터예요. | renewals | counter |
| consul.leaf-certs.renewal_failed | 비율 제한이 아닌 이유로 리프 인증서 갱신이 실패할 때 증가하는 카운터예요. | failures | counter |
| consul.leaf-certs.renewal_failed.rate_limited | 리프 인증서 갱신이 비율 제한될 때 증가하는 카운터예요. | failures | counter |
| consul.leaf-certs.consecutive_rate_limit_errors | 리프 인증서 갱신의 연속적인 비율 제한 실패를 추적하는 게이지예요. | errors | gauge |
자세한 내용은 인증서 만료 모니터링을 참조하세요.
클라이언트 에이전트 지표 (Client agent metrics)
Consul 클라이언트의 API 및 RPC 요청과 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.client.api.catalog_datacenters | Consul 에이전트가 카탈로그의 데이터센터를 나열하는 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_deregister | Consul 에이전트가 카탈로그 등록 해제 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_gateway_services | Consul 에이전트가 게이트웨이와 연결된 서비스를 나열하는 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_node_service_list | Consul 에이전트가 노드의 등록된 서비스를 나열하는 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_node_services | Consul 에이전트가 서비스를 제공하는 노드를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_nodes | Consul 에이전트가 카탈로그에서 노드를 나열하는 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_register | Consul 에이전트가 카탈로그 등록 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_service_nodes | Consul 에이전트가 서비스를 제공하는 노드를 나열하는 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.catalog_services | Consul 에이전트가 카탈로그에서 서비스를 나열하는 요청을 받을 때마다 증가해요. | requests | counter |
| consul.client.api.error.catalog_service_nodes | Consul 에이전트가 서비스를 제공하는 노드를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_datacenters | Consul 에이전트가 데이터센터를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_deregister | Consul 에이전트가 카탈로그 등록 해제 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_gateway_services | Consul 에이전트가 게이트웨이와 연결된 서비스를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_node_service_list | Consul 에이전트가 노드의 등록된 서비스를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_node_services | Consul 에이전트가 노드의 서비스를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_nodes | Consul 에이전트가 노드를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_register | Consul 에이전트가 카탈로그 등록 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_service_nodes | Consul 에이전트가 서비스를 제공하는 노드를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.api.success.catalog_services | Consul 에이전트가 서비스를 나열하는 요청에 성공적으로 응답할 때마다 증가해요. | requests | counter |
| consul.client.rpc | Consul 에이전트가 Consul 서버에 RPC 요청을 할 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_datacenters | Consul 에이전트가 데이터센터를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_deregister | Consul 에이전트가 카탈로그 등록 해제 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_gateway_services | Consul 에이전트가 게이트웨이와 연결된 서비스를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_node_service_list | Consul 에이전트가 노드의 등록된 서비스를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_node_services | Consul 에이전트가 노드의 서비스를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_nodes | Consul 에이전트가 노드를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_register | Consul 에이전트가 카탈로그 등록 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_service_nodes | Consul 에이전트가 서비스를 제공하는 노드를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.error.catalog_services | Consul 에이전트가 서비스를 나열하는 요청에 대해 RPC 오류를 받을 때마다 증가해요. | requests | counter |
| consul.client.rpc.exceeded | Consul 에이전트가 Consul 서버에 RPC 요청을 할 때 해당 에이전트의 limits 구성에 의해 비율 제한될 때마다 증가해요. | requests | counter |
| consul.client.rpc.failed | Consul 에이전트가 Consul 서버에 RPC 요청을 하고 실패할 때마다 증가해요. | requests | counter |
페더레이션 지표 (Federation metrics)
Consul 데이터센터의 WAN federation 상태와 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.federation.state.apply | WAN 페더레이션 데이터센터 간 페더레이션 상태 변경을 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.federation.state.get | 특정 데이터센터의 페더레이션 상태 정보를 검색하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.federation.state.list | WAN 페더레이션 데이터센터 간 모든 페더레이션 상태를 나열하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.federation.state.list_mesh_gateways | 페더레이션 상태와 연결된 메시 게이트웨이를 나열하는 데 걸리는 시간을 측정해요. | ms | summary |
FSM 지표 (FSM metrics)
Finite State Machine (FSM)은 Raft 인덱스의 동작을 포착해요. 이 지표들은 주어진 이벤트를 FSM에 적용하는 데 걸리는 시간을 측정해요.
FSM 성능과 관련된 다른 지표는 Raft 지표에서 찾을 수 있어요.
| Metric | Description | Unit | Type |
| consul.fsm.acl | 주어진 ACL 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.acl.authmethod | ACL authmethod 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.acl.bindingrule | ACL 바인딩 규칙 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.acl.policy | ACL 정책 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.acl.token | ACL 토큰 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.autopilot | 주어진 autopilot 업데이트를 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.ca | CA 구성 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.ca.leaf | 리프 인증서에 서명하는 동안 작업을 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.coordinate.batch_update | 주어진 배치 좌표 업데이트를 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.deregister | 카탈로그 등록 해제 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.intention | intention 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.kvs | 주어진 KV 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.peering | peering 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.persist | FSM을 raft 스냅샷으로 영구화하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.prepared_query | 주어진 prepared query 갱신 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.register | 카탈로그 등록 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.session | 주어진 세션 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.system_metadata | 시스템 메타데이터 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.tombstone | 주어진 tombstone 작업을 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.fsm.txn | 주어진 트랜잭션 업데이트를 FSM에 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.consul.fsm.ca | 더 이상 사용되지 않아요. 대신 fsm.ca를 사용하세요. | ms | summary |
| consul.consul.fsm.intention | 더 이상 사용되지 않아요. 대신 fsm.intention을 사용하세요. | ms | summary |
gRPC 지표 (GRPC metrics)
Consul 데이터센터가 처리하는 gRPC 연결 수와 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.grpc.client.connection.count | 클라이언트 에이전트가 Consul 서버로 연 새 gRPC 연결 수를 세요. | connections | counter |
| consul.grpc.client.connections | 클라이언트 에이전트에서 Consul 서버로 열린 활성 gRPC 연결 수를 측정해요. | connections | gauge |
| consul.grpc.client.request.count | 클라이언트 에이전트가 Consul 서버로 보낸 gRPC 요청 수를 세요. | requests | counter |
| consul.grpc.server.connection.count | 서버가 받은 새 gRPC 연결 수를 세요. | connections | counter |
| consul.grpc.server.connections | 서버에서 열린 활성 gRPC 연결 수를 측정해요. | connections | gauge |
| consul.grpc.server.request.count | 서버가 받은 gRPC 요청 수를 세요. | requests | counter |
| consul.grpc.server.stream.count | 서버가 받은 새 gRPC 스트림 수를 세요. | streams | counter |
| consul.grpc.server.streams | 서버가 처리하는 활성 gRPC 스트림 수를 측정해요. | streams | gauge |
호스트 지표 (Host metrics)
Consul 서버는 호스트의 시스템 리소스에 대한 다음 지표를 보고할 수 있어요. 이 기능은 에이전트 텔레메트리 구성에서 활성화해야 해요. Consul 서버가 컨테이너 내부에서 실행 중이라면 이 지표는 여전히 호스트 리소스 사용량을 보고하며 컨테이너에 부과된 리소스 제한은 보고하지 않는다는 점을 참고하세요.
호스트 지표 (Host metrics)
Consul 에이전트가 실행 중인 호스트와 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.host.cpu.idle | 유휴 CPU 사용량이에요. CPU마다 하나의 항목. | percentage | gauge |
| consul.host.cpu.iowait | I/O 대기 CPU 사용량이에요. CPU마다 하나의 항목. | percentage | gauge |
| consul.host.cpu.system | 시스템 CPU 사용량이에요. CPU마다 하나의 항목. | percentage | gauge |
| consul.host.cpu.total | 총 CPU 사용량이에요. CPU마다 하나의 항목. | percentage | gauge |
| consul.host.cpu.user | 사용자 CPU 사용량이에요. CPU마다 하나의 항목. | percentage | gauge |
| consul.host.disk.available | 디스크 사용 가능 바이트예요. | bytes | gauge |
| consul.host.disk.inodes_percent | 디스크 inode 사용 백분율이에요. | percentage | gauge |
| consul.host.disk.size | 디스크 크기(바이트)예요. | bytes | gauge |
| consul.host.disk.used | 디스크 사용량(바이트)이에요. | bytes | gauge |
| consul.host.disk.used_percent | 디스크 공간 사용 백분율이에요. | percentage | gauge |
| consul.host.memory.available | 사용 가능한 물리 메모리(바이트)예요. | bytes | gauge |
| consul.host.memory.free | 사용 가능한 물리 메모리(바이트)예요. | bytes | gauge |
| consul.host.memory.total | 총 물리 메모리(바이트)예요. | bytes | gauge |
| consul.host.memory.used | 사용 중인 물리 메모리(바이트)예요. | bytes | gauge |
| consul.host.memory.used_percent | 사용 중인 물리 메모리 백분율이에요. | percentage | gauge |
| consul.host.uptime | 시스템 가동 시간이에요. | seconds | gauge |
Golang 지표 (Golang metrics)
Consul 프로세스를 실행하는 데 사용되는 Golang 런타임과 관련된 지표예요.
| Metric | Description | Unit | Type |
| go_gc_duration_seconds | 가비지 컬렉션 주기의 일시 중지 기간 요약이에요. | seconds | summary |
| go_goroutines | 현재 존재하는 goroutine 수예요. | goroutines | gauge |
| go_info | Go 환경에 대한 정보예요. | string | gauge |
| go_memstats_alloc_bytes | 할당되어 여전히 사용 중인 바이트 수예요. | bytes | gauge |
| go_memstats_alloc_bytes_total | 해제된 경우를 포함한 총 할당 바이트 수예요. | bytes | counter |
| go_memstats_buck_hash_sys_bytes | 프로파일링 버킷 해시 테이블이 사용하는 바이트 수예요. | bytes | gauge |
| go_memstats_frees_total | 총 해제 수예요. | frees | counter |
| go_memstats_gc_sys_bytes | 가비지 컬렉션 시스템 메타데이터에 사용된 바이트 수예요. | bytes | gauge |
| go_memstats_heap_alloc_bytes | 할당되어 여전히 사용 중인 힙 바이트 수예요. | bytes | gauge |
| go_memstats_heap_idle_bytes | 사용을 기다리는 힙 바이트 수예요. | bytes | gauge |
| go_memstats_heap_inuse_bytes | 사용 중인 힙 바이트 수예요. | bytes | gauge |
| go_memstats_heap_objects | 할당된 객체 수예요. | objects | gauge |
| go_memstats_heap_released_bytes | OS로 해제된 힙 바이트 수예요. | bytes | gauge |
| go_memstats_heap_sys_bytes | 시스템에서 얻은 힙 바이트 수예요. | bytes | gauge |
| go_memstats_last_gc_time_seconds | 마지막 가비지 컬렉션 이후 1970년 기준 초 수예요. | seconds | gauge |
| go_memstats_lookups_total | 포인터 조회 총 수예요. | lookups | counter |
| go_memstats_mallocs_total | 총 malloc 수예요. | mallocs | counter |
| go_memstats_mcache_inuse_bytes | mcache 구조가 사용 중인 바이트 수예요. | bytes | gauge |
| go_memstats_mcache_sys_bytes | 시스템에서 얻은 mcache 구조에 사용된 바이트 수예요. | bytes | gauge |
| go_memstats_mspan_inuse_bytes | mspan 구조가 사용 중인 바이트 수예요. | bytes | gauge |
| go_memstats_mspan_sys_bytes | 시스템에서 얻은 mspan 구조에 사용된 바이트 수예요. | bytes | gauge |
| go_memstats_next_gc_bytes | 다음 가비지 컬렉션이 발생할 때의 힙 바이트 수예요. | bytes | gauge |
| go_memstats_other_sys_bytes | 다른 시스템 할당에 사용된 바이트 수예요. | bytes | gauge |
| go_memstats_stack_inuse_bytes | 스택 할당자가 사용 중인 바이트 수예요. | bytes | gauge |
| go_memstats_stack_sys_bytes | 스택 할당자를 위해 시스템에서 얻은 바이트 수예요. | bytes | gauge |
| go_memstats_sys_bytes | 시스템에서 얻은 바이트 수예요. | bytes | gauge |
| go_threads | 생성된 OS 스레드 수예요. | threads | gauge |
런타임 지표 (Runtime metrics)
이 지표들 대부분은 Golang 지표에서 중복된 것이에요.
| Metric | Description | Unit | Type |
| consul.runtime.alloc_bytes | Consul 프로세스가 할당한 바이트 수를 측정해요. 때때로 증가할 수 있지만 안정 상태 값으로 돌아와야 해요. | bytes | gauge |
| consul.runtime.free_count | Consul 프로세스가 수행한 메모리 할당 해제(free) 총 수예요. | frees | gauge |
| consul.runtime.gc_pause_ns | 나노초 단위의 가비지 컬렉션 일시 중지 이벤트 기간을 측정해요. | nanoseconds | summary |
| consul.runtime.heap_objects | 힙에 할당된 객체 수를 측정하며 일반적인 메모리 압력 지표예요. 때때로 증가할 수 있지만 안정 상태 값으로 돌아와야 해요. | heap objects | gauge |
| consul.runtime.malloc_count | Consul 프로세스가 수행한 메모리 할당(malloc) 총 수예요. | mallocs | gauge |
| consul.runtime.num_goroutines | 실행 중인 goroutine 수를 추적하며 일반적인 부하 압력 지표예요. 때때로 증가할 수 있지만 안정 상태 값으로 돌아와야 해요. | number of goroutines | gauge |
| consul.runtime.sys_bytes | Consul 프로세스가 운영 체제에서 얻은 총 메모리 바이트를 측정해요. | bytes | gauge |
| consul.runtime.total_gc_pause_ns | 프로세스 시작 이후 가비지 컬렉션 일시 중지에 소요된 누적 나노초예요. | nanoseconds | gauge |
| consul.runtime.total_gc_runs | 프로세스 시작 이후 완료된 가비지 컬렉션 주기 총 수예요. | garbage collection cycles | gauge |
프로세스 지표 (Process metrics)
Consul 프로세스와 관련된 지표예요.
| Metric | Description | Unit | Type |
| process.cpu_seconds_total | 사용자 및 시스템 CPU 시간 총합(초)이에요. | seconds | counter |
| process.max_fds | 최대 열린 파일 디스크립터 수예요. | file descriptors | gauge. |
| process.open_fds | 열린 파일 디스크립터 수예요. | file descriptors | gauge. |
| process.resident_memory_bytes | 상주 메모리 크기(바이트)예요. | bytes | gauge. |
| process.start_time_seconds | Unix epoch 이후 프로세스 시작 시간(초)이에요. | seconds | gauge. |
| process.virtual_memory_bytes | 가상 메모리 크기(바이트)예요. | bytes | gauge. |
| process.virtual_memory_max_bytes | 사용 가능한 최대 가상 메모리 양(바이트)이에요. | bytes | gauge. |
Intention 지표 (Intentions metrics)
intention을 Consul 서비스 메시로 전파하는 데 필요한 시간을 측정하는 지표예요.
| Metric | Description | Unit | Type |
| consul.intention.apply | 서비스 메시 intention(권한 부여 정책) 변경을 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.consul.intention.apply | 더 이상 사용되지 않아요. 대신 intention_apply를 사용하세요. | ms | summary |
리더 지표 (Leader metrics)
서버 리더십 추적과 페더레이션 데이터센터 간 데이터 복제 성능 측정과 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.leader.barrier | 리더십 획득 시 raft barrier를 기다리는 데 소요된 시간을 측정해요. | ms | summary |
| consul.leader.reapTombstones | tombstone을 정리하는 데 소요된 시간을 측정해요. | ms | summary |
| consul.leader.reconcile | serf 멤버 정보에서 raft 스토어를 업데이트하는 데 소요된 시간을 측정해요. | ms | summary |
| consul.leader.reconcileMember | 단일 serf 멤버의 정보에 대해 raft 스토어를 업데이트하는 데 소요된 시간을 측정해요. | ms | summary |
| consul.leader.replication.acl_policies.index | 보조 데이터센터의 리더만 발생해요. 보조 데이터센터가 성공적으로 복제한 기본 데이터센터의 ACL 정책 인덱스를 추적해요. | index | gauge |
| consul.leader.replication.acl_policies.status | 보조 데이터센터의 리더만 발생해요. 리더에서 ACL 정책 복제의 현재 상태를 추적해요. 마지막 복제 라운드가 성공했으면 1, 오류가 있었으면 0이에요. | health | gauge |
| consul.leader.replication.acl_roles.index | 보조 데이터센터의 리더만 발생해요. 보조 데이터센터가 성공적으로 복제한 기본 데이터센터의 ACL 역할 인덱스를 추적해요. | index | gauge |
| consul.leader.replication.acl_roles.status | 보조 데이터센터의 리더만 발생해요. 리더에서 ACL 역할 복제의 현재 상태를 추적해요. 마지막 복제 라운드가 성공했으면 1, 오류가 있었으면 0이에요. | health | gauge |
| consul.leader.replication.acl_tokens.index | 보조 데이터센터의 리더만 발생해요. 보조 데이터센터가 성공적으로 복제한 기본 데이터센터의 ACL 토큰 인덱스를 추적해요. | index | gauge |
| consul.leader.replication.acl_tokens.status | 보조 데이터센터의 리더만 발생해요. 리더에서 ACL 토큰 복제의 현재 상태를 추적해요. 마지막 복제 라운드가 성공했으면 1, 오류가 있었으면 0이에요. | health | gauge |
| consul.leader.replication.config_entries.index | 보조 데이터센터의 리더만 발생해요. 보조 데이터센터가 성공적으로 복제한 기본 데이터센터의 구성 항목 인덱스를 추적해요. | index | gauge |
| consul.leader.replication.config_entries.status | 보조 데이터센터의 리더만 발생해요. 리더에서 구성 항목 복제의 현재 상태를 추적해요. 마지막 복제 라운드가 성공했으면 1, 오류가 있었으면 0이에요. | health | gauge |
| consul.leader.replication.federation_state.index | 보조 데이터센터의 리더만 발생해요. 보조 데이터센터가 성공적으로 복제한 기본 데이터센터의 페더레이션 상태 인덱스를 추적해요. | index | gauge |
| consul.leader.replication.federation_state.status | 보조 데이터센터의 리더만 발생해요. 리더에서 페더레이션 상태 복제의 현재 상태를 추적해요. 마지막 복제 라운드가 성공했으면 1, 오류가 있었으면 0이에요. | health | gauge |
| consul.leader.replication.namespaces.index | Enterprise 보조 데이터센터의 리더만 발생해요. 보조 데이터센터가 성공적으로 복제한 기본 데이터센터의 페더레이션 상태 인덱스를 추적해요. | index | gauge |
| consul.leader.replication.namespaces.status | Enterprise 보조 데이터센터의 리더만 발생해요. 리더에서 페더레이션 상태 복제의 현재 상태를 추적해요. 마지막 복제 라운드가 성공했으면 1, 오류가 있었으면 0이에요. | health | gauge |
| consul.server.isLeader | 서버가 리더인지 추적해요. | leadership | gauge |
멤버십 지표 (Membership metrics)
클러스터의 멤버십 관리와 메시지 브로드캐스트에 사용되는 Serf gossip 프로토콜의 성능과 관련된 지표예요.
gossip 프로토콜과 관련된 더 많은 지표는 Serf 지표도 참조하세요.
| Metric | Description | Unit | Type |
| consul.memberlist.gossip | gossip 메시지가 무작위로 선택된 노드 집합에 브로드캐스트되는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.memberlist.node.instances | 노드 상태(alive, dead, suspect, left) 각각의 인스턴스 수를 추적해요. | nodes | gauge |
| consul.memberlist.probeNode | 선택된 에이전트에 대해 한 라운드의 장애 감지를 수행하는 데 걸리는 시간을 측정해요. | nodes / interval | summary |
| consul.memberlist.pushPullNode | 이 에이전트와 상태를 교환한 에이전트 수를 측정해요. | nodes / interval | summary |
| consul.memberlist.queue.broadcasts | 다른 gossip 참가자에게 브로드캐스트를 기다리는 메시지 수를 측정해요. | messages | summary |
| consul.memberlist.size.local | 다른 gossip 수신자에게 보내기 전 memberlist의 바이트 크기를 측정해요. | bytes | gauge |
| consul.memberlist.size.remote | 다른 gossip 참가자로부터 수신한 들어오는 memberlist의 바이트 크기를 측정해요. | bytes | summary |
| consul.memberlist.tcp.accept | 에이전트가 들어오는 TCP 스트림 연결을 수락한 횟수를 세요. | connections accepted / interval | counter |
| consul.memberlist.tcp.connect | 에이전트가 다른 에이전트와 push/pull 동기화를 시작한 횟수를 세요. | push/pull initiated / interval | counter |
| consul.memberlist.tcp.sent | 에이전트가 TCP 프로토콜을 통해 보낸 총 바이트 수를 측정해요. | bytes sent / interval | counter |
| consul.memberlist.udp.received | 에이전트가 UDP 프로토콜을 통해 받은 총 바이트 수를 측정해요. | bytes received / interval | counter |
| consul.memberlist.udp.sent | 에이전트가 UDP 프로토콜을 통해 보낸 총 바이트 수를 측정해요. | bytes sent / interval | counter |
| consul.members.clients | Consul에 등록된 현재 클라이언트 에이전트 수를 측정해요. Consul 서버에서만 발생돼요. v1.9.6에 추가됨. | number of clients | gauge |
| consul.members.servers | Consul에 등록된 현재 서버 에이전트 수를 측정해요. Consul 서버에서만 발생돼요. v1.9.6에 추가됨. | number of servers | gauge |
지표에는 서로 다른 gossip 풀 간 데이터를 더 구분하기 위해 특정 레이블을 추가할 수 있어요. CE에서 지원되는 레이블은 network이고, Enterprise에서는 segment, partition, area가 허용돼요.
메시 인증서 지표 (Mesh certificate metrics)
서비스 메시 인증서의 만료 시간을 노출하는 지표예요.
| Metric | Description | Unit | Type |
| consul.mesh.active_root_ca.expiry | 서비스 메시 루트 인증서가 만료될 때까지의 초 수예요. 매시간 업데이트돼요. | seconds | gauge |
| consul.mesh.active_signing_ca.expiry | 서비스 메시 서명 인증서가 만료될 때까지의 초 수예요. 매시간 업데이트돼요. | seconds | gauge |
Peering 지표 (Peering metrics)
클러스터 peering은 페더레이션 연결이 아닌 피어 연결을 통해 통신하는 Consul 클러스터를 말해요. Consul은 peered 클러스터로 내보낸 서비스 수를 설명하는 지표를 수집해요. Peering 지표는 리더 서버에서만 발생돼요. 이 지표들은 9초마다 발생돼요.
| Metric | Description | Unit | Type |
| consul.peering.exported_services | peering에 대해 내보낸 서비스 수를 추적하는 게이지예요. 레이블은 peer_name, peer_id, Enterprise에서는 partition이에요. 이 지표는 9초마다 발생돼요. | services | gauge |
| consul.peering.healthy | peering이 정상(1)인지 아닌지(0)를 추적하는 게이지예요. 레이블은 peer_name, peer_id, Enterprise에서는 partition이에요. 이 지표는 9초마다 발생돼요. | health | gauge |
| consul.consul.peering.exported_services | 더 이상 사용되지 않아요. 대신 peering_exported_services를 사용하세요. | services | gauge |
| consul.consul.peering.healthy | 더 이상 사용되지 않아요. 대신 peering_healthy를 사용하세요. | health | gauge |
레이블 (Labels)
Consul은 지표 값에 다음 레이블을 첨부해요.
| Label Name | Description | Possible values |
| peer_name | 보고하는 클러스터 또는 리더에서의 peering 이름이에요. | 클러스터에서 정의된 모든 피어 이름 |
| peer_id | 보고하는 클러스터 또는 리더에 연결된 피어의 ID예요. | 모든 UUID |
| partition | Enterprise peering이 생성된 파티션 이름이에요. | 클러스터에서 정의된 모든 파티션 이름 |
Prepared queries 지표 (Prepared queries metrics)
prepared queries' 성능과 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.prepared_query.apply | prepared query 업데이트를 적용하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.prepared_query.execute | prepared query 실행 요청을 처리하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.prepared_query.execute_remote | 다른 데이터센터로 전달된 prepared query 실행 요청을 처리하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.prepared_query.explain | prepared query explain 요청을 처리하는 데 걸리는 시간을 측정해요. | ms | summary |
Raft 지표 (Raft Metrics)
Consul 클러스터의 합의를 유지하는 데 사용되는 Raft 프로토콜과 관련된 지표예요. 이 지표에는 Bolt DB 또는 WAL일 수 있는 Raft의 LogStore에 대한 지표가 포함돼요. Consul 설치에서 활성화된 logstore와 관련된 지표만 볼 수 있어요.
Raft 성능과 관련된 다른 지표는 FSM 지표에서 찾을 수 있어요.
| Metric | Description | Unit | Type |
| consul.raft.applied_index | raft 적용 인덱스를 나타내요. | index | gauge |
| consul.raft.apply | 해당 구간에서 발생하는 Raft 트랜잭션 수를 세며, Consul 서버의 쓰기 부하를 나타내는 일반적인 지표예요. | transactions/interval | counter |
| consul.raft.barrier | 에이전트가 모든 보류 작업이 적용되도록 raft barrier를 시작한 횟수를 세요. | blocks / interval | counter |
| consul.raft.boltdb.freelistBytes | freelist 메타데이터를 인코딩하는 데 필요한 바이트 수를 나타내요. raft_logstore.boltdb.no_freelist_sync가 false로 설정되면 이 메타데이터 바이트도 커밋된 로그마다 디스크에 기록되어야 해요. | bytes | gauge |
| consul.raft.boltdb.freePageBytes | raft.db 파일 내 여유 공간 바이트 수를 나타내요. | bytes | gauge |
| consul.raft.boltdb.getLog | db에서 로그를 읽는 데 소요된 시간을 측정해요. | ms | timer |
| consul.raft.boltdb.logBatchSize | 단일 배치로 db에 기록되는 로그의 총 바이트 크기를 측정해요. | bytes | sample |
| consul.raft.boltdb.logsPerBatch | db에 배치당 기록되는 로그 수를 측정해요. | logs | sample |
| consul.raft.boltdb.logSize | db에 기록되는 로그의 크기를 측정해요. | bytes | sample |
| consul.raft.boltdb.numFreePages | raft.db 파일 내 여유 페이지 수를 나타내요. | pages | gauge |
| consul.raft.boltdb.numPendingPages | raft.db 내에서 곧 여유가 될 보류 페이지 수를 나타내요. | pages | gauge |
| consul.raft.boltdb.openReadTxn | db에 대한 열린 읽기 트랜잭션 수를 나타내요. | transactions | gauge |
| consul.raft.boltdb.totalReadTxn | db에 대해 시작된 읽기 트랜잭션 총 수를 나타내요. | transactions | gauge |
| consul.raft.boltdb.storeLogs | db에 로그를 쓰는 데 소요된 시간을 측정해요. | ms | timer |
| consul.raft.boltdb.txstats.cursorCount | Consul 시작 이후 생성된 커서 수를 세요. | cursors | counter |
| consul.raft.boltdb.txstats.nodeCount | Consul 시작 이후 db 내 노드 할당 수를 세요. | allocations | counter |
| consul.raft.boltdb.txstats.nodeDeref | Consul 시작 이후 db 내 노드 역참조 수를 세요. | dereferences | counter |
| consul.raft.boltdb.txstats.pageAlloc | Consul 시작 이후 db 내 할당된 바이트 수를 나타내요. 해제되어 재사용된 공간은 고려하지 않는다는 점을 참고하세요. 그런 경우에도 이 지표의 값은 계속 증가해요. | bytes | gauge |
| consul.raft.boltdb.txstats.pageCount | Consul 시작 이후 할당된 페이지 수를 나타내요. 해제되어 재사용된 공간은 고려하지 않는다는 점을 참고하세요. 그런 경우에도 이 지표의 값은 계속 증가해요. | pages | gauge |
| consul.raft.boltdb.txstats.rebalance | Consul 시작 이후 db에서 수행된 노드 리밸런스 수를 세요. | rebalances | counter |
| consul.raft.boltdb.txstats.rebalanceTime | db에서 노드를 리밸런스하는 데 소요된 시간을 측정해요. | ms | timer |
| consul.raft.boltdb.txstats.spill | Consul 시작 이후 db에서 spill된 노드 수를 세요. | spills | counter |
| consul.raft.boltdb.txstats.spillTime | db에서 노드를 spill하는 데 소요된 시간을 측정해요. | ms | timer |
| consul.raft.boltdb.txstats.split | Consul 시작 이후 db에서 분할된 노드 수를 세요. | splits | counter |
| consul.raft.boltdb.txstats.write | Consul 시작 이후 db에 대한 쓰기 수를 세요. | writes | counter |
| consul.raft.boltdb.txstats.writeTime | db에 쓰기를 수행하는 데 소요된 시간을 측정해요. | ms | timer |
| consul.raft.boltdb.writeCapacity | 초당 기록할 수 있는 로그 수 측면의 이론적 쓰기 용량이에요. 각 샘플은 향후 배치 로그 쓰기 작업이 이와 유사하다면 용량이 어떻게 될지 출력해요. 이 유사성은 배치 크기, 바이트 크기, 디스크 성능, boltdb 성능의 4가지를 포함해요. 이 중 어느 것도 정적이지 않고 개별 샘플이 달라질 가능성이 높지만, 더 큰 시간 창에 걸쳐 이 지표를 집계하면 이 BoltDB 스토어가 어떻게 수행될 수 있는지에 대한 좋은 그림을 제공해요. | logs/second | sample |
| consul.raft.commitNumLogs | 단일 배치에서 FSM에 적용하기 위해 처리된 로그 수를 측정해요. | logs | gauge |
| consul.raft.commitTime | 리더의 Raft 로그에 새 항목을 커밋하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.raft.fsm.apply | Finite State Machine (FSM)에 로그 항목을 적용하는 데 걸린 시간을 측정해요. | ms | summary |
| consul.raft.fsm.enqueue | FSM이 적용할 로그 배치를 대기열에 넣는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.raft.fsm.lastRestoreDuration | 에이전트 재시작 시나 리더가 installSnapshot을 호출할 때 스냅샷에서 FSM을 복원하는 데 걸린 시간을 측정해요. 대부분의 서버는 일반적으로 드문 재시작 중에만 복원하므로 값을 유지하는 게이지예요. | ms | gauge |
| consul.raft.last_index | raft 마지막 인덱스를 나타내요. | index | gauge |
| consul.raft.leader.dispatchLog | 리더가 로그 항목을 디스크에 쓰는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.raft.leader.dispatchNumLogs | 배치로 디스크에 커밋된 로그 수를 측정해요. | logs | gauge |
| consul.raft.leader.lastContact | 리더가 리더 리스를 확인할 때 팔로워 노드에 마지막으로 연락할 수 있었던 이후의 시간을 측정해요. | ms | summary |
| consul.raft.leader.oldestLogAge | 리더의 로그 스토어에서 가장 오래된 로그의 나이를 측정해요. | ms | gauge |
| consul.raft.logstore.verifier.checkpoints_written | 검증 목적으로 LogStore에 기록된 체크포인트 항목 수를 세요. | checkpoints | counter |
| consul.raft.logstore.verifier.ranges_verified | 검증 보고서가 완료된 로그 범위 수를 세요. | log ranges verifications | counter |
| consul.raft.rpc.installSnapshot | raft 리더가 다운 후 따라잡고 있거나 방금 클러스터에 합류한 팔로워에 스냅샷을 설치하는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.raft.snapshot.persist | raft가 새 스냅샷을 디스크에 쓰는 데 걸리는 시간을 측정해요. | ms | summary |
| consul.raft.state.candidate | Consul 서버가 선거를 시작할 때마다 증가해요. | election attempts / interval | counter |
| consul.raft.state.leader | Consul 서버가 리더가 될 때마다 증가해요. | leadership transitions / interval | counter |
| consul.raft.thread.fsm.saturation | raft FSM 스레드의 포화 수준을 측정하여 처리 부하를 나타내요. | percentage | summary |
| consul.raft.thread.main.saturation | 메인 raft 스레드의 포화 수준을 측정하여 처리 부하를 나타내요. | percentage | summary |
| consul.raft.wal.head_truncations | head에서 잘라낸 로그 항목 수를 세요. 즉 가장 오래된 항목이에요. 시간 경과에 따른 변화율을 그래프로 그리면 개별 truncate 호출을 스파이크로 볼 수 있어요. | log entries truncated | counter |
| consul.raft.wal.last_segment_age_seconds | 세그먼트를 회전할 때마다 설정되며, 해당 세그먼트 파일이 처음 생성된 때와 밀봉된 때 사이의 초 수를 설명해요. 이것은 쓰기가 디스크를 얼마나 빨리 채우는지에 대한 대략적인 추정치를 제공해요. | seconds | gauge |
| consul.raft.wal.log_appends | StoreLog(s) 호출 수, 즉 추가된 항목 배치 수를 세요. | calls | counter |
| consul.raft.wal.log_entries_read | get_log 호출 수를 세요. | log entries reads | counter |
| consul.raft.wal.log_entries_written | 기록된 항목 수를 세요. | log entries written | counter |
| consul.raft.wal.log_entry_bytes_read | 디코딩 전 세그먼트에서 읽은 로그 항목 바이트를 세요. 헤더와 인덱스 항목을 포함하고 버퍼에 맞지 않는 큰 항목에 대한 보조 읽기를 포함할 수 있으므로 디스크에서 실제로 읽은 바이트는 더 높을 수 있어요. | bytes | counter |
| consul.raft.wal.log_entry_bytes_written | Codec으로 인코딩 후 로그 항목 바이트를 세요. 헤더와 인덱스 항목을 포함하므로 디스크에 실제로 기록된 바이트는 약간 더 높을 수 있어요. | bytes | counter |
| consul.raft.wal.segment_rotations | 새 세그먼트 파일로 이동하는 횟수를 세요. | rotations | counter |
| consul.raft.wal.stable_gets | StableStore.Get 또는 GetUint64 호출 수를 세요. | calls | counter |
| consul.raft.wal.stable_sets | StableStore.Set 또는 SetUint64 호출 수를 세요. | calls | counter |
| consul.raft.wal.tail_truncations | head에서 잘라낸 로그 항목 수를 세요. 즉 가장 새로운 항목이에요. 시간 경과에 따른 변화율을 그래프로 그리면 개별 truncate 호출을 스파이크로 볼 수 있어요. | log entries truncates | counter |
RPC 지표 (RPC metrics)
Consul 서버에 대한 RPC 요청의 성능과 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.rpc.accept_conn | 서버가 RPC 연결을 수락할 때 증가해요. | connections | counter |
| consul.rpc.consistentRead | 일관된 읽기가 수행될 수 있는지 확인하는 데 소요된 시간을 측정해요. | ms | summary |
| consul.rpc.cross_dc | 서버가 (잠재적으로 차단하는) 데이터센터 간 RPC 쿼리를 보낼 때 증가해요. | query | counter |
| consul.rpc.queries_blocking | 서버가 처리 중인 블로킹 쿼리의 현재 수를 보여줘요. | query | gauge |
| consul.rpc.query | 서버가 읽기 요청을 받을 때 증가하며 새 읽기 쿼리의 비율을 나타내요. | query | counter |
| consul.rpc.raft_handoff | 서버가 Raft 관련 RPC 연결을 수락할 때 증가해요. | connections | counter |
| consul.rpc.rate_limit.exceeded | RPC가 구성된 비율 제한을 초과할 때마다 증가해요. 참고: 허용(permissive) 모드에서는 RPC가 여전히 진행되도록 허용되었을 거예요. | RCPs | counter |
| consul.rpc.rate_limit.log_dropped | RPC가 비율 제한을 초과했기 때문에 발생된 로그가 출력 버퍼가 가득 차서 버려질 때 증가해요. | log | counter |
| consul.rpc.request | 서버가 Consul 관련 RPC 요청을 받을 때 증가해요. | requests | counter |
| consul.rpc.request_error | 서버가 RPC 요청에서 오류를 반환할 때 증가해요. | errors | counter |
Serf 지표 (Serf metrics)
클러스터의 멤버십 관리와 메시지 브로드캐스트에 사용되는 Serf gossip 프로토콜의 성능과 관련된 지표예요.
gossip 프로토콜과 관련된 더 많은 지표는 멤버십 지표도 참조하세요.
| Metric | Description | Unit | Type |
| consul.serf.coordinate_adjustment_ms | 장애 감지 튜닝을 위한 네트워크 좌표 조정의 크기를 밀리초로 측정해요. | ms | summary |
| consul.serf.queue_Event | 현재 처리 대기 중인 serf 사용자 이벤트 수를 측정해요. | queued events | summary |
| consul.serf.queue_Intent | 브로드캐스트 대기 중인 serf intent 메시지 수를 측정해요. | queued messages | summary |
| consul.serf.queue_Query | 처리 대기 중인 serf 쿼리 수를 측정해요. | queued queries | summary |
지표에는 서로 다른 gossip 풀 간 데이터를 더 구분하기 위해 특정 레이블을 추가할 수 있어요. CE에서 지원되는 레이블은 network이고, Enterprise에서는 segment, partition, area가 허용돼요.
세션 지표 (Session metrics)
Consul sessions의 성능과 관련된 지표예요.
| Metric | Description | Unit | Type |
| consul.session.apply | 세션 업데이트를 적용하는 데 소요된 시간을 측정해요. | ms | summary |
| consul.session.renew | 세션을 갱신하는 데 소요된 시간을 측정해요. | ms | summary |
| consul.session_ttl.active | 추적 중인 활성 세션 수를 추적해요. | sessions | gauge |
| consul.session_ttl.invalidate | 만료된 세션을 무효화하는 데 소요된 시간을 측정해요. | ms | summary |
Consul 상태 지표 (Consul state metrics)
Consul 데이터센터에 존재하는 엔티티(kv 항목, 노드, 서비스, 구성 항목 등)의 수를 측정하는 지표예요.
| Metric | Description | Unit | Type |
| consul.state.billable_service_instances | 로컬 데이터센터의 청구 가능한 서비스 인스턴스 총 수예요. | number of objects | gauge |
| consul.state.config_entries | Kind별로 레이블링된, Consul에 등록된 고유 구성 항목의 현재 수를 측정해요. Consul 서버에서만 발생돼요. v1.10.4에 추가됨. | number of objects | gauge |
| consul.state.connect_instances | Kind별로 레이블링된, Consul에 등록된 고유 connect 서비스 인스턴스의 현재 수를 측정해요. Consul 서버에서만 발생돼요. v1.10.4에 추가됨. | number of objects | gauge |
| consul.state.kv_entries | Consul KV 스토어의 현재 항목 수를 측정해요. Consul 서버에서만 발생돼요. v1.10.3에 추가됨. | number of objects | gauge |
| consul.state.nodes | Consul에 등록된 현재 노드 수를 측정해요. Consul 서버에서만 발생돼요. v1.9.0에 추가됨. | number of objects | gauge |
| consul.state.peerings | Consul에 등록된 현재 peering 수를 측정해요. Consul 서버에서만 발생돼요. v1.13.0에 추가됨. | number of objects | gauge |
| consul.state.service_instances | 서비스 이름 기준으로 Consul에 등록된 고유 서비스의 현재 수를 측정해요. Consul 서버에서만 발생돼요. v1.9.0에 추가됨. | number of objects | gauge |
| consul.state.services | 서비스 이름 기준으로 Consul에 등록된 고유 서비스의 현재 수를 측정해요. Consul 서버에서만 발생돼요. v1.9.0에 추가됨. | number of objects | gauge |
기타 Consul 정보 지표 (Other Consul info metrics)
| Metric | Description | Unit | Type |
| consul.agent.tls.cert.expiry | 에이전트 tls 인증서가 만료될 때까지의 초 수예요. 매시간 업데이트돼요. | seconds | gauge |
| consul.version | Consul 버전을 나타내요. | version | gauge |
| consul.system.licenseExpiration | 현재 라이선스가 만료될 때까지의 시간 수예요. | hours | gauge |
트랜잭션 지표 (Transaction metrics)
Consul 클러스터 내부에서 트랜잭션을 수행하는 데 필요한 시간을 측정하는 지표예요.
| Metric | Description | Unit | Type |
| consul.txn.apply | 트랜잭션 작업을 적용하는 데 소요된 시간을 측정해요. | ms | summary |
| consul.txn.read | 읽기 트랜잭션을 반환하는 데 소요된 시간을 측정해요. | ms | summary |
xDS 지표 (xDS metrics)
Consul 서버의 xDS 스트림 수와 성능을 측정하는 지표예요.
| Metric | Description | Unit | Type |
| consul.xds.server.idealStreamsMax | 서버 간 부하를 대략 균등하게 분산하기 위해 선택된 서버당 최대 xDS 스트림 수예요. | streams | gauge |
| consul.xds.server.streamDrained | 서버 간 부하를 리밸런싱할 때 드레인되는 xDS 스트림 수를 세요. | streams | counter |
| consul.xds.server.streamStart | xDS 스트림이 열린 후 해당 스트림에 대해 xDS 리소스가 처음 생성될 때까지의 밀리초 시간을 측정해요. | ms | summary |
| consul.xds.server.streams | 프로토콜 버전별로 구분된 서버가 처리하는 활성 xDS 스트림 수를 측정해요. | streams | gauge |
| consul.xds.server.streamsUnauthenticated | ACL이 활성화되지 않았거나 ACL 토큰이 없어 인증되지 않은, 서버가 처리하는 활성 xDS 스트림 수를 세요. | streams | gauge |