모니터 부분에서 뉴렐릭으로의 데이터 흐름을 관리하기 위해 파이프라인 제어 게이트웨이를 설정하고 구현합니다.
제한된 클러스터 관리자 액세스
이 가이드는 cluster-admin 권한이 필요한 전체 관리 설치를 다룹니다. 조직의 보안 정책이 이 수준의 액세스를 제한하는 경우, Flux 없이 파이프라인 컨트롤 게이트웨이 설치를 참조하십시오.
해당 설정에서, 뉴렐릭은 여전히 UI를 통해 모든 파이프라인 설정을 제공하지만, 게이트웨이 확장 및 버전 업그레이드는 사용자가 수동으로 관리해야 합니다.
게이트웨이 사용 시 고려 사항
게이트웨이 구성 요소를 통합하고 사용할 때 염두에 두어야 할 몇 가지 중요한 고려 사항은 다음과 같습니다.
속성 및 데이터 관리
- 속성 지원: 게이트웨이는 속성에 대해 OpenTelemetry 의미 규칙을 사용합니다. 지원되는 속성에 대한 자세한 내용은 게이트웨이 설명서를 참조하십시오.
- 데이터/속성 처리: 게이트웨이는 지수 타임커버 데이터, 트레이스 및 트레이스에 대한 데이터 또는 속성 삭제 requests 수정 없이 뉴렐릭에 직접 전달합니다.
파싱 및 데이터 통합
- 로그 구문 분석: 게이트웨이에는 로그에 대한 Grok 구문 분석 기능이 포함되어 있지 않습니다. 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 설정을 사용하여 파이프라인 처리를 구성하십시오. 게이트웨이 설정을 참조하세요.