HCP Consul 지표 모니터링을 위한 수집기

이 가이드에서는 OpenTelemetry 수집기를 사용하여 HCP 관리 Consul 구현에서 지표를 수집하는 방법을 설명합니다. 수집기는 뉴렐릭을 포함한 다양한 옵저버빌리티 백앤드에 텔레메트리 데이터(메트릭, 로그 및 트레이스 포함)를 수집, 처리하고 보냅니다.

아래 설정 예에서는 수집기 내의 Prometheus 수신기를 활용합니다. HCP Consul의 서비스 메트릭 API 에서 직접 서비스 메트릭을 검색하고 이를 뉴렐릭의 OpenTelemetry 엔드포인트로 내보냅니다.

HCP Consul은 두 가지 유형의 옵저버빌리티 등급을 제공합니다.

서버 지표: Consul 서버 성능 및 리소스 사용량을 추적합니다.
Envoy 프록시 지표: Consul 내의 Envoy 서비스 메시를 모니터링합니다.

HCP Consul 지표를 수집하여 뉴렐릭으로 내보내려면 아래 단계를 따르세요.

요구 사항 검토

시작하기 전에 다음이 필요합니다.

실행 중인 docker 데몬 서비스
설치된 Docker Compose 도구
HCP Consul ACL 관리 토큰
데이터를 보고하려는 계정의 뉴렐릭

예제 설정을 다운로드하거나 복제하세요

예제 설정을 다운로드하세요.
다운로드한 후 저장소의 other-examples/collector 폴더 내에서 hcp-consul 이라는 디렉터리를 찾습니다. 이 디렉토리에는 HCP 영사 지표 수집을 위한 특정 설정이 포함되어 있습니다.
(선택사항) HCP Consul 예시와 관련된 추가 세부정보 및 지침은 README를 참조하세요.

환경 변수 설정 및 수집기 실행

.env 파일에서:

HCP 액세스 토큰 및 액세스 URL 값 설정

뉴렐릭 API 키 변수를 뉴렐릭 라이선스 키로 설정하세요.

bash

$# Open the HCP Consul example directory
$  cd newrelic-opentelemetry-examples/other-examples/collector/hcp-consul
$
$  # Set environment variables.
$
$  # run the collector in docker
$  docker compose up

환경변수 정보

위에 설정된 환경 변수에 대한 자세한 정보가 필요한 경우 다음 표의 설명서를 참조하세요.

변하기 쉬운	설명	문서
`NEW_RELIC_API_KEY`	New Relic 수집 API 키	API 키에 대해 알아보기
`NEW_RELIC_OTLP_ENDPOINT`	기본 US 뉴켈릭 OTLP 엔드포인트는 `https://otlp.nr-data.net:4318` 입니다.	OTLP 끝점 설정 검토
`HCP_ACCESS_TOKEN`	HCP Consul용 ACL 관리 토큰	ACL 관리 토큰 만들기
`HCP_ACCESS_URL`	특정 Consul 서버에 액세스하기 위한 URL	액세스 URL 찾기

HCP Consul Envoy 지표를 뉴렐릭으로 전달

뉴렐릭에서 HCP Consul Envoy 지표를 모니터링하려면 지표를 자체 수집기로 전달하도록 HCP Consul 클러스터에 내장된 OpenTelemetry 수집기를 구성하면 됩니다. 여기에는 이 예에서 실행되는 수집기가 포함될 수 있습니다.

OpenTelemetry 수집기에 HTTP 수신기를 추가합니다. 예시 collector.yaml 파일의 receivers 그룹에 이를 추가할 수 있습니다.
```
receivers:
    otlp:
      protocols:
        http:
```
그러면 0.0.0.0:4318 에서 수신 중인 수신기가 추가됩니다.

Envoy 지표를 이 수신기에 전달하도록 HCP Consul 클러스터를 구성하세요. 이는 HCP Consul 설정 파일의 telemetryCollector 스탠자에서 구성할 수 있습니다. 예를 들어:

telemetryCollector:
      enabled: true
      customExporterConfig: |-
        {
          "exporter_config": {
            "otlphttp": {
              "endpoint": "0.0.0.0:4318",
              "headers": {
                "authorization": "<auth>"
              },
              "timeout": "2s"
            }
          }
        }

New Relic에서 데이터 보기

뉴켈릭에서는 다음과 같은 여러 위치에서 HCP Consul 데이터를 볼 수 있습니다.

뉴렐릭 마켓플레이스 로 이동하여 "consul"을 검색하세요. 대시보드 중 하나를 클릭하여 계정에 빠르게 설치하세요.
지표 탐색기로 이동하여 consul 에 대해 필터하거나 Envoy 지표에 대해 envoy 필터링합니다. 이 데이터는 모든 사용자 정의 알림 또는 대시보드에 추가될 수 있습니다.
팁
이 HCP Consul 서버 통합에서 사용할 수 있는 모든 지표를 보려면 여기에서 설명서를 참조하세요.