모니터 부분에서 뉴렐릭으로의 데이터 흐름을 관리하기 위해 파이프라인 제어 게이트웨이를 설정하고 구현합니다.
제한된 클러스터 관리자 액세스
이 가이드는 cluster-admin 권한이 필요한 전체 관리 설치를 다룹니다. 조직의 보안 정책이 이 수준의 액세스를 제한하는 경우, Flux 없이 파이프라인 컨트롤 게이트웨이 설치를 참조하십시오.
해당 설정에서, 뉴렐릭은 여전히 UI를 통해 모든 파이프라인 설정을 제공하지만, 게이트웨이 확장 및 버전 업그레이드는 사용자가 수동으로 관리해야 합니다.
게이트웨이 사용 시 고려 사항
게이트웨이 구성 요소를 통합하고 사용할 때 염두에 두어야 할 몇 가지 중요한 고려 사항은 다음과 같습니다.
속성 및 데이터 관리
- 속성 지원: 게이트웨이는 속성에 대해 OpenTelemetry 의미 규칙을 사용합니다. 지원되는 속성에 대한 자세한 내용은 게이트웨이 설명서를 참조하십시오.
- 데이터/속성 처리: 게이트웨이는 지수 타임커버 데이터, 트레이스 및 트레이스에 대한 데이터 또는 속성 삭제 requests 수정 없이 뉴렐릭에 직접 전달합니다.
파싱 및 데이터 통합
- 로그 구문 분석: 게이트웨이는 변환 프로세서의
ExtractGrokPatternsOTTL 함수를 통해 로그에 대한 Grok 구문 분석을 지원합니다. 하지만 게이트웨이에는 뉴렐릭의 사전 구성된 내장 Grok 구문 분석 규칙이 포함되어 있지 않습니다. 구조화되지 않은 로그 메시지에서 구조화된 데이터를 추출하려면ExtractGrokPatterns을(를) 사용하여 자체 Grok 패턴을 정의해야 합니다. - Prometheus 통합: 게이트웨이는 Prometheus 원격 쓰기에 대한 메트릭을 지원하지 않으므로 Prometheus 기반 시스템과의 통합에 영향을 줄 수 있습니다.
라이센싱 및 규정 준수
- 인스턴스 키 관리: OpenTelemetry 게이트웨이는 에이전트 수집기 또는 APM SDK와 같은 기본 OTLP( Protocol) 소스의 여러 인스턴스 키를 수용하지 않습니다. 라이선스를 관리할 때 이 점을 고려하세요.
- 규정 준수 기준: 게이트웨이는 FedRAMP와 호환되지 않으므로 연방 보안 기준을 충족해야 하는 경우 사용에 영향을 미칠 수 있습니다.
전제 조건
Kubernetes 권한: 이 설치 모드에서는 Flux 컨트롤러가 게이트웨이 수명 주기(설치, 업그레이드, 확장)를 관리하기 위해 클러스터 관리자(cluster-admin) 권한이 필요합니다.
필수 툴:
- Helm v3.x 이상(helm version으로 확인)
kubectl쿠버네티스 클러스터에 액세스할 수 있는 CLI
뉴렐릭 인프라 에이전트(선택 사항): 파이프라인 컨트롤 게이트웨이는 더 이상 뉴렐릭 인프라 에이전트를 번들로 제공하지 않습니다. 게이트웨이 상태 대시보드에서 클러스터 상태 메트릭(CPU 사용량, 메모리 및 리전)을 보려면 인프라 에이전트를 별도로 설치하십시오. 설치 지침은 Kubernetes 통합 설치 를 참조하십시오.
인프라 에이전트가 없을 때 발생하는 일:
- 게이트웨이 상태 테이블은 CPU 사용량, 메모리 사용량 및 리전에 대해 "N/A"를 표시합니다.
- Pipeline 설정 및 데이터 처리는 계속해서 정상적으로 작동합니다.
중요
이 변경 사항 이전에 게이트웨이를 설치한 경우, 인프라 에이전트는 그대로 유지되며 계속 작동합니다. 이 요구 사항은 새 게이트웨이 설치에만 영향을 미칩니다.
파이프라인 제어 게이트웨이 설정

게이트웨이를 설정하려면:
New Relic 계정의 통합 및 에이전트에서 Set up Pipeline Control [파이프라인 제어 설정] 을 클릭하거나 gateway [게이트웨이] 를 검색하여 Pipeline Control gateway [파이프라인 제어 게이트웨이]를 선택합니다.
선택한 계정이 파이프라인 위험에 사용하려는 계정인지 확인하세요. 그렇지 않은 경우 Select an account [계정 선택을] 클릭하고 원하는 계정을 선택한 다음 Continue [계속을] 클릭합니다.
자격 증명을 입력하려면 기존 라이선스 키를 제공하거나 새 키를 만드세요. 새 키를 생성하는 경우, 키를 복사하세요. 그런 다음 Continue [계속을] 클릭하세요.
게이트웨이 플릿을 선택하거나 생성하세요:
- 새 게이트웨이가 조직의 다른 게이트웨이와 기존 설정(샘플링, 필터링 및 변환 규칙)을 공유하도록 하려면 기존 플릿을 선택하세요.
- 특정 환경이나 비즈니스 단위를 위해 새롭고 격리된 설정이 필요한 경우, 고유한 게이트웨이 플릿 이름을 입력하십시오.
Full management (with Flux) [전체 관리(Flux 포함)]를 선택합니다.
게이트웨이 구성:
- 클러스터 이름을 입력하세요.
- 핵심 게이트웨이 인프라 및 관리자 서비스가 위치할 전용 Kubernetes 네임스페이스를 입력하십시오. 기본값은
newrelic-agent-control입니다. - 개별 수집 에이전트가 실행될 특정 네임스페이스를 입력하십시오. 기본값은
newrelic입니다.
설정 파일
values-newrelic-gateway.yaml을 디렉토리에 다운로드합니다.화면에 표시된 설치 명령을 실행하세요.
bash$helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && helm upgrade --install agent-control-bootstrap -n newrelic-agent-control newrelic/agent-control-bootstrap --create-namespace --values values-newrelic-gateway.yaml팁
UI 마법사는 특정 설정이 포함된 전체 값 파일
values-newrelic-gateway.yaml을(를) 제공합니다. 파일을 다운로드하여 Helm 명령어와 함께 사용하십시오.계속 을 클릭합니다.
Test connection [연결 테스트를] 클릭하고 연결이 성공할 때까지 기다리세요.
게이트웨이 설정에 대한 세부 정보를 보려면 뉴렐릭 제어로 이동하여 Gateway 클릭하세요.
여러 플릿을 사용하는 이유는 무엇인가요?
한 기업(The Corp)에 두 개의 부서가 있다고 가정해 보겠습니다: OrgA (감사 목적으로 데이터의 100%가 필요함) 및 OrgB (대용량 비용을 제어하기 위해 1% 샘플링이 필요함).
단 하나의 플릿만으로는 The Corp 가 꼼짝할 수 없습니다. OrgB 가 비용을 절감하기 위해 1% 샘플링을 적용하면, OrgA 는 성능 데이터의 99%를 잃게 됩니다. 한 팀의 비용 통제가 다른 팀의 미션 크리티컬 모니터링을 중단시킵니다.
여러 플릿을 사용하여 The Corp 는 "두뇌"를 분리할 수 있습니다:
- 미션 크리티컬 플릿: OrgA 는 100% 데이터 보존을 위해 이 플릿에 합류합니다.
- 대용량 플릿: OrgB 는 1% 샘플링 및 개인 데이터 교정을 위해 이 플릿에 합류합니다.
그 결과, 이제 개별 팀은 조직의 나머지 부분에 영향을 주지 않고 고유한 샘플링, 보안 및 규정 준수 규칙을 관리할 수 있습니다.
더 많은 클러스터 추가
게이트웨이 설정에 새 클러스터를 추가하려면
- 뉴렐릭 컨트롤을 열고 Gateway 선택하세요.
- 클러스터 테이블에서 Add a cluster [클러스터 추가를] 클릭합니다.
- 게이트웨이 설정 의 지침을 따르세요.
- 게이트웨이 요약 페이지로 돌아가세요. 새로 추가된 클러스터가 표시됩니다.
게이트웨이 컨테이너를 생성한 후 YAML 설정을 사용하여 파이프라인 처리를 구성하십시오. 게이트웨이 설정을 참조하세요.