• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

HashiCorp 영사 모니터링 통합

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

HashiCorp Cloud Platform Consul 통합 도 있습니다.

호환성 및 요구 사항

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

  • 우리의 통합은 HashiCorp Consul 1.0 이상과 호환됩니다.
  • ACL을 사용하는 경우 Consul 통합을 위한 사용자 인증 정보에는 agent:read, node:readservice:read 정책이 있어야 합니다.

빠른 시작

Consul 환경을 빠르게 계측하고 안내 설치를 통해 원격 측정 데이터를 보내세요. 설치 안내에서는 인프라 에이전트와 CLI를 사용하여 HashiCorp 통합을 설정하고, 귀하의 환경에서 실행 중인 다른 애플리케이션과 로그 소스를 검색한 다음 어떤 항목을 계측해야 하는지 추천합니다.

가이드 설치는 대부분의 설정에서 작동합니다. 그러나 필요에 맞지 않으면 아래에 다른 설치 옵션이 있습니다.

시작할 준비가 되셨습니까? 사용하는 데이터 센터 지역 에 따라 관련 버튼을 클릭합니다. 설치가 완료되면 이 설명서로 돌아와서 구성 옵션을 검토하십시오.

안내 설치, 미국 지역

설치

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

' '

통합 업데이트

이 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으려면 통합 패키지인프라 에이전트를 정기적으로 업데이트하십시오.

설치 후 작업

설치가 완료되면 구성 옵션을 설정할 수 있습니다. 통합이 작동하려면 일부 구성이 필요하고 일부는 선택 사항입니다.

통합 구성

ECS 또는 Kubernetes 통합을 통해 이 통합을 활성화한 경우 해당 문서를 참조하십시오.

표준 온호스트 설치의 경우 이 통합은 YAML 구성 파일 apache-config.yml 과 함께 제공됩니다. 이 구성에서 필요한 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있습니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다. 복사 및 편집할 수 있는 샘플 구성 파일 apache-config.yml.sample 과 함께 제공됩니다.

Consul과 관련된 특정 설정은 구성 파일의 env 섹션을 사용하여 정의됩니다. 이러한 설정은 Consul 인스턴스에 대한 연결은 물론 기타 보안 설정 및 기능을 제어합니다.

중요

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

영사 구성 옵션

Consul 통합은 측정항목과 인벤토리 정보를 모두 수집합니다. 이 표에서는 각 구성 옵션이 적용되는 항목을 보여줍니다.

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

환경

설명

기본값

에 적용

호스트 이름

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

구성 예

데이터 찾기 및 사용

이 통합의 데이터는 one.newrelic.com > Infrastructure > Third-party services > Apache 로 이동하여 찾을 수 있습니다.

Apache 데이터는 ConsulDatacenterSampleConsulAgentSample 이벤트 유형 에 연결됩니다. 문제 해결 목적으로 또는 사용자 정의 차트 및 대시보드를 생성하기 위해 이 데이터를 쿼리 할 수 있습니다.

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

측정항목 데이터

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 © 2024 New Relic Inc.

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