파이프라인 컨트롤 게이트웨이를 설정 전용 모드로 설치하면, Kubernetes 및 Helm 명령을 사용하여 게이트웨이 인프라(확장, 버전)를 관리하는 동시에 뉴렐릭 UI를 통해 Pipeline 설정 수명 주기(샘플링, 필터링, 변환)를 계속 관리할 수 있습니다.
이 설치 모드를 사용하는 경우
다음의 경우 이 설치 모드를 선택합니다:
- 보안 정책이 클러스터 관리자 액세스를 제한합니다.
- 인프라 확장 및 업그레이드에 대한 직접적인 제어가 필요합니다.
- kubectl과 Helm 명령어를 사용하여 Kubernetes 리소스를 관리하는 데 익숙합니다.
- 규정 준수 중심 환경에 배포하고 있습니다.
사용할 수 있는 혜택:
- UI를 통해 파이프라인 설정(샘플링, 필터링, 변환) 관리하기.
- 더 낮은 권한 요구 사항. 뉴렐릭은 파이프라인 설정을 배포하기 위해
ConfigMap액세스(cluster-admin 아님)만 필요합니다. - 게이트웨이 스케일링 및 버전에 대한 직접 제어.
직접 관리하는 항목:
- Kubernetes 수평 파드 오토스케일러(HPA)를 통한 게이트웨이 인프라 스케일링
- Helm 명령어를 통한 게이트웨이 버전 업그레이드
팁
완전한 자동화가 필요하신가요? UI를 통해 모든 게이트웨이 인프라 관리(확장, 버전, 업그레이드)를 처리하고자 하고 보안 팀이 클러스터 관리자 권한을 승인하는 경우, 전체 관리 설치를 위해 파이프라인 컨트롤 게이트웨이 설정 및 배포 를 참조하세요.
게이트웨이 사용 시 고려 사항
게이트웨이 구성 요소를 통합하고 사용할 때 다음 고려 사항을 염두에 두십시오:
속성 및 데이터 관리
- 속성 지원: 게이트웨이는 속성에 대해 OpenTelemetry 의미 규칙을 사용합니다. 지원되는 속성에 대한 자세한 내용은 게이트웨이 설명서를 참조하십시오.
- 데이터/속성 처리: 게이트웨이는 지수 타임커버 데이터, 트레이스 및 트레이스에 대한 데이터 또는 속성 삭제 requests 수정 없이 뉴렐릭에 직접 전달합니다.
파싱 및 데이터 통합
- 로그 구문 분석: 게이트웨이에는 로그에 대한 Grok 구문 분석이 포함되어 있지 않습니다. 쿼리 및 시각화를 위해 로그 데이터를 구조화하는 대체 방법이 필요할 수 있습니다.
- Prometheus 통합: 게이트웨이는 메트릭에 대한 Prometheus 원격 쓰기를 지원하지 않습니다.
라이센싱 및 규정 준수
- 라이선스 키 관리: 게이트웨이는 에이전트 수집기 또는 APM SDK와 같은 네이티브 OpenTelemetry 프로토콜(OTLP) 소스의 여러 라이선스 키를 수용하지 않습니다.
- 규정 준수 기준: 게이트웨이는 FedRAMP와 호환되지 않으므로 연방 보안 기준을 충족해야 하는 경우 사용에 영향을 미칠 수 있습니다.
전제 조건
Kubernetes 권한: 이 설치 모드는 ConfigMap CREATE/UPDATE 권한만 필요합니다(cluster-admin 아님).
필수 툴:
- Helm v3.x 이상(helm version으로 확인)
kubectl쿠버네티스 클러스터에 액세스할 수 있는 CLI
뉴렐릭 인프라 에이전트(선택 사항): 파이프라인 컨트롤 게이트웨이는 더 이상 뉴렐릭 인프라 에이전트를 번들로 제공하지 않습니다. 게이트웨이 상태 대시보드에서 클러스터 상태 메트릭(CPU 사용량, 메모리 및 리전)을 보려면 인프라 에이전트를 별도로 설치하십시오. 설치 지침은 Kubernetes 통합 설치 를 참조하십시오.
인프라 에이전트가 없을 때 발생하는 일:
- 게이트웨이 상태 테이블은 CPU 사용량, 메모리 사용량 및 리전에 대해 "N/A"를 표시합니다.
- Pipeline 설정 및 데이터 처리는 계속해서 정상적으로 작동합니다.
중요
이 변경 사항 이전에 게이트웨이를 설치한 경우, 인프라 에이전트는 그대로 유지되며 계속 작동합니다. 이 요구 사항은 새 게이트웨이 설치에만 영향을 미칩니다.
파이프라인 컨트롤 게이트웨이 설치
Flux 없이 파이프라인 컨트롤 게이트웨이를 설치하려면:
New Relic 계정의 통합 및 에이전트에서 Set up Pipeline Control [파이프라인 제어 설정] 을 클릭하거나 gateway [게이트웨이] 를 검색하여 Pipeline Control gateway [파이프라인 제어 게이트웨이]를 선택합니다.
선택한 계정이 파이프라인 위험에 사용하려는 계정인지 확인하세요. 그렇지 않은 경우 Select an account [계정 선택을] 클릭하고 원하는 계정을 선택한 다음 Continue [계속을] 클릭합니다.
자격 증명을 입력하려면 기존 라이선스 키를 제공하거나 새 키를 만드세요. 새 키를 생성하는 경우, 키를 복사하세요. 그런 다음 Continue [계속을] 클릭하세요.
게이트웨이 플릿을 선택하거나 생성하세요:
- 새 게이트웨이가 조직의 다른 게이트웨이와 기존 설정(샘플링, 필터링 및 변환 규칙)을 공유하도록 하려면 기존 플릿을 선택하세요.
- 특정 환경이나 비즈니스 단위를 위해 새롭고 격리된 설정이 필요한 경우, 고유한 게이트웨이 플릿 이름을 입력하십시오.
Configuration only (without Flux) [설정만(Flux 제외)]을 선택합니다.
게이트웨이 구성:
- 클러스터 이름을 입력하세요.
- 게이트웨이 및 에이전트 컨트롤 설치를 위한 네임스페이스를 입력하십시오. 기본값은
newrelic입니다.
에이전트 컨트롤 설치:
bash$helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && helm upgrade --install agent-control-deployment newrelic/agent-control-deployment -n newrelic --create-namespace --values agent-control-deployment-values.yaml팁
UI 마법사는 특정 설정이 포함된 전체 values 파일(
agent-control-deployment-values.yaml)을 제공합니다. 이 파일을 다운로드하여 Helm 명령과 함께 사용하십시오.에이전트 컨트롤 설치를 확인하고 Continue [계속]을 클릭하세요.
게이트웨이 설정(최소 복제본, 최대 복제본, CPU 임계값)을 구성합니다. 이 설정은 초기 Kubernetes HPA 설정을 생성합니다. 설치 후, UI를 통한 이러한 설정 변경은 적용되지 않습니다. HPA를 통해 스케일링을 직접 관리해야 합니다.
게이트웨이 설치:
bash$helm upgrade --install newrelic-pcg newrelic/pipeline-control-gateway -n newrelic --create-namespace --values pipeline-control-gateway-values.yaml팁
UI 마법사는 특정 설정이 포함된 전체 values 파일(
pipeline-control-gateway-values.yaml)을 제공합니다. 이 파일을 다운로드하여 Helm 명령과 함께 사용하십시오.계속 을 클릭합니다.
Test connection [연결 테스트를] 클릭하고 연결이 성공할 때까지 기다리세요.
게이트웨이 설정에 대한 세부 정보를 보려면 뉴렐릭 제어로 이동하여 Gateway 클릭하세요.
여러 플릿을 사용하는 이유는 무엇인가요?
한 기업(The Corp)에 두 개의 부서가 있다고 가정해 보겠습니다: OrgA (감사 목적으로 데이터의 100%가 필요함) 및 OrgB (대용량 비용을 제어하기 위해 1% 샘플링이 필요함).
단 하나의 플릿만으로는 The Corp 가 꼼짝할 수 없습니다. OrgB 가 비용을 절감하기 위해 1% 샘플링을 적용하면, OrgA 는 성능 데이터의 99%를 잃게 됩니다. 한 팀의 비용 통제가 다른 팀의 미션 크리티컬 모니터링을 중단시킵니다.
여러 플릿을 사용하여 The Corp 는 "두뇌"를 분리할 수 있습니다:
- 미션 크리티컬 플릿: OrgA 는 100% 데이터 보존을 위해 이 플릿에 합류합니다.
- 대용량 플릿: OrgB 는 1% 샘플링 및 개인 데이터 교정을 위해 이 플릿에 합류합니다.
그 결과, 이제 개별 팀은 조직의 나머지 부분에 영향을 주지 않고 고유한 샘플링, 보안 및 규정 준수 규칙을 관리할 수 있습니다.
설치 후 게이트웨이 관리
설치 후, 뉴렐릭 UI의 게이트웨이 설정 페이지에 다음이 표시됩니다:
게이트웨이 버전 - 읽기 전용으로 표시됨
두 개의 편집 가능한 토글:
- 게이트웨이에 대한 진단 로그 수집 - 진단 로깅 활성화/비활성화
- 가용 CPU가 낮아질 경우 게이트웨이 규칙 우회 - 리소스 제약 시 규칙 우회 토글
게이트웨이 인프라(확장 및 버전)를 관리하려면 다음 접근 방식을 사용하세요:
게이트웨이 스케일링 설정 변경
최소/최대 레플리카 또는 CPU 임계값을 수정하려면 Kubernetes HPA를 업데이트하십시오:
옵션 1: HPA 직접 편집 빠른 테스트나 임시 조정, 스케일링 문제에 대한 즉각적인 대응 또는 Helm 업그레이드가 필요하지 않은 경우에 이를 사용합니다.
현재 HPA 보기:
bash$kubectl get hpa -n newrelic이 예시에서는 네임스페이스가
newrelic이라고 가정합니다. 다른 네임스페이스를 사용하는 경우, 여기와 다음 명령어에서 그에 맞게 변경하십시오.HPA 직접 편집:
bash$kubectl edit hpa pipeline-control-gateway-hpa -n newrelic여기서 pipeline-control-gateway-hpa는 편집 중인 HPA입니다. 사용 중인 HPA의 이름으로 변경합니다.
편집기에서 필요한 필드를 수정한 다음, 저장하고 종료합니다. 변경 사항이 즉시 적용됩니다.
변경 사항을 확인합니다:
bash$kubectl get hpa pipeline-control-gateway-hpa -n newrelic출력에 수정한 설정의 새 값이 표시되는지 확인하여 변경 사항이 적용되었는지 확인합니다.
옵션 2: Helm을 통한 업데이트
pipeline-control-gateway-values.yaml파일을 수정하세요.운영:
bash$helm upgrade newrelic-pcg newrelic/pipeline-control-gateway -n newrelic --values pipeline-control-gateway-values.yaml변경 사항을 확인합니다:
bash$kubectl get hpa -n newrelic
게이트웨이 버전 업그레이드
파이프라인 컨트롤 게이트웨이 버전을 업그레이드하려면:
Helm 명령어에서 차트 버전을 업데이트하십시오:
bash$helm upgrade newrelic-pcg newrelic/pipeline-control-gateway --namespace newrelic --version <NEW_VERSION> --values pipeline-control-gateway-values.yaml업그레이드 확인:
bash$helm list -n newrelic$kubectl get pods -n newrelic
Pipeline 설정 변경
이는 UI를 통해 처리됩니다:
- 샘플링 규칙
- 드롭 필터
- Transform 규칙
- 조건부 샘플링
이 모드에서도 파이프라인 설정 변경 사항은 ConfigMap 업데이트를 통해 자동으로 배포됩니다.
더 많은 클러스터 추가
게이트웨이 설정에 새 클러스터를 추가하려면:
- 뉴렐릭 컨트롤을 열고 Gateway 선택하세요.
- 클러스터 테이블에서 Add a cluster [클러스터 추가를] 클릭합니다.
- 위의 설치 지침을 따릅니다.
- 게이트웨이 요약 페이지로 돌아가세요. 새로 추가된 클러스터가 표시됩니다.
게이트웨이 컨테이너를 생성한 후 YAML 설정을 사용하여 파이프라인 처리를 구성하십시오. 게이트웨이 설정을 참조하세요.