HashiCorp 영사 모니터링 통합

HashiCorp Consul 온-호스트 통합은 귀하의 Consul 데이터센터 환경에서 인벤토리와 지표를 수집하여 뉴렐릭으로 보내며, 여기에서 귀하의 환경 상태를 확인할 수 있습니다. 우리는 데이터 센터와 에이전트/노드 수준 모두에서 데이터를 수집합니다.

팁

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

호환성 및 요구 사항

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

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

빠른 시작

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

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

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

안내 설치, 미국 지역

가이드 설치, EU 지역

설치

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

' '

인프라 에이전트를 설치하고 INTEGRATION_FILE_NAME 변수를 nri-consul 로 바꿉니다.
디렉토리를 통합 폴더로 변경하십시오.
```
cd /etc/newrelic-infra/integrations.d
```

샘플 구성 파일을 복사합니다.

sudo cp consul-config.yml.sample consul-config.yml

구성 설정 에 설명된 대로 consul-config.yml 파일을 편집합니다.

다음에서 nri-consul .MSI 설치 프로그램 이미지를 다운로드합니다.
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-consul/nri-consul-amd64.msi
Windows 명령 프롬프트에서 설치하려면 다음을 실행하십시오.
```
msiexec.exe /qn /i PATH\TO\nri-consul-amd64.msi
```
Integrations 디렉터리 C:\Program Files\New Relic\newrelic-infra\integrations.d\ 에서 다음을 실행하여 샘플 구성 파일의 복사본을 만듭니다.
```
copy consul-config.yml.sample consul-config.yml
```
구성 설정 에 설명된 대로 consul-config.yml 파일을 편집합니다.

통합 업데이트

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

설치 후 작업

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

통합 구성

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

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

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

중요

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

영사 구성 옵션

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

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

환경	설명	기본값	에 적용
HOSTNAME	Consul이 실행 중인 호스트 이름 또는 IP입니다.	로컬 호스트	미
PORT	영사가 수신 대기 중인 포트입니다.	8500	미
TOKEN	토큰 인증이 활성화된 경우 ACL 토큰입니다.	해당 없음	미
ENABLE_SSL	SSL을 사용하여 연결합니다.	잘못된	미
CA_BUNDLE_FILE	대체 인증 기관 번들 파일.	해당 없음	미
CA_BUNDLE_DIR	대체 인증 기관 번들 디렉토리.	해당 없음	미
TRUST_SERVER_CERTIFICATE	true로 설정하면 SSL에 대해 서버 인증서가 확인되지 않습니다.	잘못된	미
FAN_OUT	true이면 Consul 클러스터의 다른 모든 노드에서 메트릭을 수집하려고 시도합니다.	진정한	중
CHECK_LEADERSHIP	영사 서버에서 리더십을 확인하십시오. 이것은 클라이언트 모드의 영사에서 비활성화되어야 합니다.	진정한	중
TIMEOUT	각 영사 클라이언트 호출에 대한 시간 초과입니다.	30대	미
METRICS	측정항목 전용 수집을 활성화하려면 `true` 으로 설정합니다.	잘못된
INVENTORY	인벤토리 전용 컬렉션을 활성화하려면 `true` 으로 설정합니다.	잘못된

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

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

라벨

레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 라벨을 사용하면 측정항목에 속성(키/값 쌍)을 추가할 수 있으며 이를 사용하여 측정항목을 쿼리, 필터링 또는 그룹화할 수 있습니다.

기본 샘플 구성 파일에는 레이블의 예가 포함되어 있지만 필수가 아니므로 선택한 레이블을 제거, 수정 또는 추가할 수 있습니다.

labels:
   env: production
   role: load_balancer

구성 예

다음은 localhost에서 메트릭 및 인벤토리를 수집하는 데 사용되는 기본 구성입니다.

integrations:
  - name: nri-consul
    env:
      HOSTNAME: localhost
      PORT: 8500
    interval: 15s
    labels:
      environment: production
    inventory_source: config/consul

이 구성은 30초마다 메트릭을 수집하고 시간 초과가 있는 60초마다 인벤토리를 수집합니다.

integrations:
  - name: nri-consul
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 8500
      TIMEOUT: 10s
    interval: 15s
    labels:
      environment: production

  - name: nri-consul
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 8500
      TIMEOUT: 10s
    interval: 60s
    labels:
      environment: production
    inventory_source: config/consul

이 구성에서는 환경 변수 CONSUL_HOST 를 사용하여 통합의 HOSTNAME 설정을 채웁니다.

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: {{CONSUL_HOST}}
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer

이 구성에서는 ACL 토큰을 사용하여 연결하고 연결된 다른 영사 노드(FAN_OUT: false)에서 메트릭을 수집하지 않습니다.

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: localhost
      PORT: 8500
      TOKEN: my_token
      FAN_OUT: false
    interval: 15s
    labels:
      env: production
      role: load_balancer

이 구성에서는 동일한 통합에서 여러 Consul 서버를 모니터링하고 있습니다. 첫 번째 인스턴스( HOSTNAME: 1st_consul_host )의 경우 측정항목과 인벤토리를 수집하는 반면 두 번째 인스턴스( HOSTNAME: 2nd_consul_host )의 경우 측정항목만 수집합니다.

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: 1st_consul_host
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-consul
    env:
      INVENTORY: "true"
      HOSTNAME: 1st_consul_host
      PORT: 8500
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/consul

  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: 2nd_consul_host
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer

데이터 찾기 및 사용

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

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

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

측정항목 데이터

HashiCorp 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 엔드포인트의 결과를 수집합니다. 해당 응답에서 Config 및 DebugConfig 섹션을 가져옵니다.

팁

Note: Config 및 DebugConfig 내의 중첩 섹션은 수집되지 않습니다.

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

소스 코드 확인

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

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

팁

호환성 및 요구 사항

빠른 시작

설치

ECS

Kubernetes

Linux

윈도우

통합 업데이트

설치 후 작업

통합 구성

중요

영사 구성 옵션

라벨

구성 예

기본 구성

다른 메트릭/인벤토리 간격의 기본 구성

환경 변수 교체

토큰이 있고 팬아웃이 없는 메트릭 전용

다중 인스턴스 모니터링

데이터 찾기 및 사용

측정항목 데이터

영사 데이터센터 샘플 지표

영사 상담원 샘플 측정항목

인벤토리 데이터

팁

소스 코드 확인

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

HashiCorp 영사 모니터링 통합

팁

호환성 및 요구 사항 .css-21sua1{background:none;border:none;width:0;padding:0;}

빠른 시작

설치

Kubernetes

Linux

윈도우

통합 업데이트

설치 후 작업

통합 구성

중요

영사 구성 옵션

라벨

구성 예

기본 구성

다른 메트릭/인벤토리 간격의 기본 구성

환경 변수 교체

토큰이 있고 팬아웃이 없는 메트릭 전용

다중 인스턴스 모니터링

데이터 찾기 및 사용

측정항목 데이터

영사 데이터센터 샘플 지표

영사 상담원 샘플 측정항목

인벤토리 데이터

팁

소스 코드 확인

호환성 및 요구 사항