• 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

HashiCorp 영사 모니터링 통합

HashiCorp Consul 온-호스트 통합 은 Consul 환경의 인벤토리 및 메트릭을 수집하여 Consul 데이터 센터 환경의 상태를 볼 수 있는 New Relic으로 보냅니다. 데이터 센터와 에이전트/노드 수준 모두에서 데이터를 수집합니다.

통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.

호환성 및 요구 사항

우리의 통합은 HashiCorp Consul 1.0 이상과 호환됩니다.

통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.

  • Consul이 Kubernetes 또는 Amazon ECS에서 실행되고 있지 않으면 Consul을 실행하는 호스트에 인프라 에이전트를 설치 해야 합니다. 그렇지 않으면:

  • ACL을 사용하는 경우 Consul 통합을 위한 자격 증명에는 agent:read , node:readservice:read 정책이 있어야 합니다.

빠른 시작

Consul 환경을 신속하게 계측하고 안내 설치를 통해 원격 측정 데이터를 보내십시오. 가이드 설치는 New Relic CLI 및 인프라 에이전트를 다운로드하고 설치하는 사용자 환경에 대한 사용자 정의 CLI 명령을 생성합니다.

시작할 준비가 되셨습니까? 이 버튼 중 하나를 클릭하여 사용해 보십시오.

안내 설치

가이드 설치는 인프라 에이전트를 사용하여 HashiCorp Consul 통합을 설정합니다. 뿐만 아니라 사용자 환경에서 실행 중인 다른 애플리케이션 및 로그 소스를 검색한 다음 계측해야 할 항목을 추천합니다.

안내 설치는 대부분의 설정에서 작동합니다. 그러나 귀하의 요구 사항에 맞지 않는 경우 아래에서 다른 방법을 찾아 Consul 환경 모니터링을 시작할 수 있습니다.

설치 및 활성화

HashiCorp Consul 통합을 설치하려면 환경에 대한 지침을 따르세요.

' '

추가 참고 사항:

  • 고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
  • 호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지인프라 에이전트 를 정기적으로 업데이트하십시오.

While you wait for your data to come in...

Did this doc help you install?

구성

통합 구성

설치 방법에 따라 통합을 구성하는 몇 가지 방법이 있습니다.

통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다.

구성 파일에는 interval , timeout , inventory_source 와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대한 모든 내용을 보려면 구성 형식 문서를 참조하십시오.

중요

레거시 구성/정의 파일을 계속 사용하고 있다면 이 문서 에서 도움을 받으십시오.

Consul과 관련된 특정 설정은 구성 파일의 env 섹션을 사용하여 정의됩니다. 이러한 설정은 Consul 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다. 유효한 설정 목록은 이 문서의 다음 섹션에 설명되어 있습니다.

영사 인스턴스 설정

Consul 통합은 메트릭( M ) 및 인벤토리( I ) 정보를 모두 수집합니다. 표에서 각 컬렉션에 사용할 수 있는 설정에 대해 적용 대상 열을 사용합니다.

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

환경

설명

기본값

에 적용

호스트 이름

Consul이 실행 중인 호스트 이름 또는 IP입니다.

로컬 호스트

포트

영사가 수신 대기 중인 포트입니다.

8500

토큰

토큰 인증이 활성화된 경우 ACL 토큰입니다.

해당 없음

ENABLE_SSL

SSL을 사용하여 연결합니다.

잘못된

CA_BUNDLE_FILE

대체 인증 기관 번들 파일.

해당 없음

CA_BUNDLE_DIR

대체 인증 기관 번들 디렉토리.

해당 없음

TRUST_SERVER_CERTIFICATE

true로 설정하면 SSL에 대해 서버 인증서가 확인되지 않습니다.

잘못된

_아웃

true이면 Consul 클러스터의 다른 모든 노드에서 메트릭을 수집하려고 시도합니다.

진정한

CHECK_리더십

영사 서버에서 리더십을 확인하십시오. 이것은 클라이언트 모드의 영사에서 비활성화되어야 합니다.

진정한

시간 초과

각 영사 클라이언트 호출에 대한 시간 초과입니다.

30대

측정항목

측정항목 전용 수집을 활성화하려면 true 으로 설정합니다.

잘못된

목록

인벤토리 전용 컬렉션을 활성화하려면 true 으로 설정합니다.

잘못된

이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.

  • 구성 파일에 직접 값을 추가합니다. 이것은 가장 일반적인 방법입니다.
  • {{}} 표기법을 사용하여 환경 변수의 값 바꾸기. 이를 위해서는 인프라 에이전트 v1.14.0 이상이 필요합니다. 여기에서 자세한 내용을 읽거나 아래 의 예를 참조하십시오.
  • 비밀 관리를 사용합니다. 이를 사용하여 구성 파일에서 일반 텍스트로 노출될 암호와 같은 민감한 정보를 보호하십시오. 자세한 내용은 비밀 관리 를 참조하십시오.

라벨/맞춤 속성

레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 레이블을 사용하면 키/값 쌍 속성을 메트릭에 추가할 수 있으며, 이 속성을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.
기본 샘플 구성 파일에는 레이블의 예가 포함되어 있습니다. 그러나 필수 항목이 아니므로 원하는 항목을 제거, 수정 또는 추가할 수 있습니다.

labels:
env: production
role: load_balancer

구성 예

데이터 찾기 및 사용

이 서비스의 데이터는 통합 대시보드 에 보고됩니다.

메트릭은 다음 이벤트 유형 에 연결됩니다.

  • ConsulDatacenterSample
  • ConsulAgentSample

문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.

데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.

측정항목 데이터

HashiCorp Consul 통합은 다음 메트릭 데이터 속성을 수집합니다.

Consul 데이터 센터 샘플 메트릭

다음 속성은 ConsulDatacenterSample 이벤트 유형에 연결됩니다.

미터법

설명

consul.catalog.nodes_critical

등록된 노드 중 서비스 상태가 critical 인 노드 수입니다.

consul.catalog.nodes_passing

등록된 노드 중 서비스 상태가 passing 인 노드 수입니다.

consul.catalog.nodes_up

노드 수입니다.

consul.catalog.nodes_warning

등록된 노드 중 서비스 상태가 warning 인 노드 수입니다.

consul.catalog.total_nodes

영사 클러스터에 등록된 노드의 수입니다.

consul.memberlist.msg.suspect

에이전트가 가십 프로토콜 동안 프로빙하는 동안 다른 에이전트가 실패한 것으로 의심하는 횟수입니다.

consul.raft.apply

발생하는 뗏목 거래의 수입니다.

consul.raft.commitTime.avg

리더의 뗏목 로그에 새 항목을 커밋하는 데 걸리는 평균 시간입니다.

consul.raft.commitTime.count

raft.commitTime 의 샘플 수입니다.

consul.raft.commitTime.max

리더의 래프트 로그에 새 항목을 커밋하는 데 걸리는 최대 시간입니다.

consul.raft.commitTime.median

리더의 래프트 로그에 새 항목을 커밋하는 데 걸리는 중앙값 시간입니다.

consul.raft.leader.dispatchLog.avg

리더가 디스크에 로그 항목을 쓰는 데 걸리는 평균 시간입니다.

consul.raft.leader.dispatchLog.count

raft.leader.dispatchLog 의 샘플 수입니다.

consul.raft.leader.dispatchLog.max

리더가 디스크에 로그 항목을 쓰는 데 걸리는 최대 시간입니다.

consul.raft.leader.dispatchLog.median

리더가 디스크에 로그 항목을 쓰는 데 걸리는 중앙값 시간입니다.

consul.raft.leader.lastContact.avg

리더가 팔로워와의 임대를 마지막으로 확인할 수 있었던 이후 경과한 평균 시간입니다.

consul.raft.leader.lastContact.count

raft.leader.lastContact 의 샘플 수입니다.

consul.raft.leader.lastContact.max

리더가 팔로워와의 임대를 마지막으로 확인할 수 있었던 이후 경과된 최대 시간입니다.

consul.raft.leader.lastContact.median

리더가 팔로워와의 임대를 마지막으로 확인할 수 있었던 이후 경과된 중앙값 시간입니다.

consul.raft.state.candidate

시작된 리더 선거의 수입니다.

consul.raft.state.leader

완료된 리더 선거의 수입니다.

consul.serf.member.flap

에이전트가 죽은 것으로 표시된 다음 빠르게 복구되는 횟수입니다.

영사 상담원 샘플 측정항목

다음 속성은 ConsulAgentSample 이벤트 유형에 연결됩니다.

미터법

설명

agent.aclCacheHit

ACL 캐시 적중.

agent.aclCacheMiss

ACL 캐시가 누락되었습니다.

agent.kvStores

kvs.apply 의 샘플 수입니다.

agent.kvStoresAvgInMilliseconds

KV 저장소 업데이트를 완료하는 데 걸리는 평균 시간입니다.

agent.kvStoresMaxInMilliseconds

KV 저장소 업데이트를 완료하는 데 걸리는 최대 시간입니다.

agent.kvStoresMedianInMilliseconds

KV 저장소 업데이트를 완료하는 데 걸리는 중앙값 시간입니다.

agent.peers

피어 집합의 피어 수입니다.

agent.staleQueries

허용된 부실 임계값 내에서 쿼리를 제공했습니다.

agent.txnAvgInMilliseconds

트랜잭션 작업을 적용하는 데 걸리는 평균 시간입니다.

agent.txnMaxInMilliseconds

트랜잭션 작업을 적용하는 데 걸리는 최대 시간입니다.

agent.txnMedianInMilliseconds

트랜잭션 작업을 적용하는 데 걸리는 중앙값 시간입니다.

agent.txns

txn.apply 의 샘플 수입니다.

client.rpcFailed

실패한 RPC 요청의 측정값입니다.

client.rpcLoad

에이전트가 Consul 서버를 로드하는 정도를 측정합니다.

client.rpcRateLimited

속도가 제한되는 RPC 요청의 측정값입니다.

net.agent.maxLatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 최대 지연 시간입니다.

net.agent.medianLatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 중간 지연 시간입니다.

net.agent.minLatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 최소 지연 시간입니다.

net.agent.p25LatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 P25 지연 시간.

net.agent.p75LatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 P75 대기 시간입니다.

net.agent.p90LatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 P90 대기 시간입니다.

net.agent.p95LatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 P95 지연 시간입니다.

net.agent.p99LatencyInMilliseconds

이 노드에서 다른 모든 노드까지의 P99 지연 시간입니다.

runtime.allocations

할당된 힙 개체의 누적 개수입니다.

runtime.allocationsInBytes

Consul 프로세스에서 할당한 현재 바이트입니다.

runtime.frees

해제된 힙 개체의 누적 개수입니다.

runtime.gcCycles

완료된 GC 주기의 수입니다.

runtime.gcPauseInMilliseconds

Consul이 시작된 이후 GC stop-the-world 일시 중지의 누적 나노초입니다.

runtime.goroutines

실행 중인 이동 루틴의 수입니다.

runtime.heapObjects

힙에 할당된 객체의 수

runtime.virtualAddressSpaceInBytes

go 런타임에서 예약한 가상 주소 공간의 총 크기입니다.

인벤토리 데이터

HashiCorp Consul 통합은 Consul Agent 노드의 구성 매개변수 및 현재 설정을 캡처합니다. /v1/agent/self REST API 엔드포인트의 결과를 수집합니다. 해당 응답에서 ConfigDebugConfig 섹션을 가져옵니다.

참고 : ConfigDebugConfig 내의 중첩 섹션은 수집되지 않습니다.

데이터는 인벤토리 페이지 config/consul 소스 아래에서 사용할 수 있습니다. 인벤토리 데이터에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.

소스 코드 확인

이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.