모니터 부분에서 뉴렐릭으로의 데이터 흐름을 관리하기 위해 파이프라인 제어 게이트웨이를 설정하고 구현합니다.
Restricted cluster-admin access
This guide covers a full-management installation that requires cluster-admin permissions. If your organizational security policies restrict this level of access, see Install Pipeline Control gateway without Flux.
In that configuration, New Relic still delivers all pipeline configurations through the UI, but you will be responsible for manually managing gateway scaling and version upgrades.
게이트웨이 사용 시 고려 사항
게이트웨이 구성 요소를 통합하고 사용할 때 염두에 두어야 할 몇 가지 중요한 고려 사항은 다음과 같습니다.
속성 및 데이터 관리
- 속성 지원: 게이트웨이는 속성에 대해 OpenTelemetry 의미 규칙을 사용합니다. 지원되는 속성에 대한 자세한 내용은 게이트웨이 설명서를 참조하십시오.
- 데이터/속성 처리: 게이트웨이는 지수 타임커버 데이터, 트레이스 및 트레이스에 대한 데이터 또는 속성 삭제 requests 수정 없이 뉴렐릭에 직접 전달합니다.
파싱 및 데이터 통합
- 로그 구문 분석: 게이트웨이에는 로그에 대한 Grok 구문 분석 기능이 포함되어 있지 않습니다. Grok 파싱은 사전 정의된 패턴과 정규 표현식을 사용하여 구조화되지 않은 로그 메시지에서 구조화된 데이터를 추출하는 데 사용되는 방법입니다. 쿼리 및 시각화를 위해 로그 데이터를 구조화하기 위한 대체 방법이 필요할 수 있습니다.
- Prometheus 통합: 게이트웨이는 Prometheus 원격 쓰기에 대한 메트릭을 지원하지 않으므로 Prometheus 기반 시스템과의 통합에 영향을 줄 수 있습니다.
라이센싱 및 규정 준수
- 인스턴스 키 관리: OpenTelemetry 게이트웨이는 에이전트 수집기 또는 APM SDK와 같은 기본 OTLP( Protocol) 소스의 여러 인스턴스 키를 수용하지 않습니다. 라이선스를 관리할 때 이 점을 고려하세요.
- 규정 준수 기준: 게이트웨이는 FedRAMP와 호환되지 않으므로 연방 보안 기준을 충족해야 하는 경우 사용에 영향을 미칠 수 있습니다.
전제 조건
Kubernetes permissions: This installation mode requires cluster-admin permissions for Flux controllers to manage gateway lifecycle (installation, upgrades, scaling).
Required tools:
- Helm v3.x or higher (verify with helm version)
kubectlCLI with access to your Kubernetes cluster
New Relic infrastructure agent (optional): Pipeline Control gateway no longer bundles the New Relic infrastructure agent. To view cluster health metrics (CPU usage, memory, and region) in the gateway health dashboard, install the infrastructure agent separately. Refer to Install the Kubernetes integration for installation instructions.
What happens without infrastructure agent:
- Gateway health table will show "N/A" for: CPU usage, memory usage, and region.
- Pipeline configuration and data processing continues to work normally.
중요
If you installed gateway before this change, your infrastructure agent remains in place and continues to work. This requirement only affects new gateway installations.
파이프라인 제어 게이트웨이 설정
To set up gateway:
New Relic 계정의 통합 및 에이전트에서 Set up Pipeline Control [파이프라인 제어 설정] 을 클릭하거나 gateway [게이트웨이] 를 검색하여 Pipeline Control gateway [파이프라인 제어 게이트웨이]를 선택합니다.
선택한 계정이 파이프라인 위험에 사용하려는 계정인지 확인하세요. 그렇지 않은 경우 Select an account [계정 선택을] 클릭하고 원하는 계정을 선택한 다음 Continue [계속을] 클릭합니다.
자격 증명을 입력하려면 기존 라이선스 키를 제공하거나 새 키를 만드세요. 새 키를 생성하는 경우, 키를 복사하세요. 그런 다음 Continue [계속을] 클릭하세요.
게이트웨이 플릿을 선택하거나 생성하세요:
- 새 게이트웨이가 조직의 다른 게이트웨이와 기존 설정(샘플링, 필터링 및 변환 규칙)을 공유하도록 하려면 기존 플릿을 선택하세요.
- 특정 환경이나 비즈니스 단위를 위해 새롭고 격리된 설정이 필요한 경우, 고유한 게이트웨이 플릿 이름을 입력하십시오.
Select Full management (with Flux).
Configure the gateway:
- Enter your cluster name.
- Enter the dedicated Kubernetes namespace where the core gateway infrastructure and manager services will reside. Default is
newrelic-agent-control. - Enter the specific namespace where individual collection agents will run. Default is
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팁
The UI wizard provides the complete value file,
values-newrelic-gateway.yaml, with your specific configuration. Download the file and use it with the Helm command.계속 을 클릭합니다.
Test connection [연결 테스트를] 클릭하고 연결이 성공할 때까지 기다리세요.
게이트웨이 설정에 대한 세부 정보를 보려면 뉴렐릭 제어로 이동하여 Gateway 클릭하세요.
여러 플릿을 사용하는 이유는 무엇인가요?
Imagine a corporation (The Corp) has two divisions: OrgA (needs 100% of data for audit reasons) and OrgB (needs 1% sampling to control high-volume costs).
With only one fleet, The Corp is stuck. If OrgB applies 1% sampling to save money, OrgA loses 99% of its performance data. One team's cost-control breaks the other team's mission-critical monitoring.
여러 플릿을 사용하여 The Corp 는 "두뇌"를 분리할 수 있습니다:
- 미션 크리티컬 플릿: OrgA 는 100% 데이터 보존을 위해 이 플릿에 합류합니다.
- High-volume fleet: OrgB joins this fleet for 1% sampling and personal data redaction.
그 결과, 이제 개별 팀은 조직의 나머지 부분에 영향을 주지 않고 고유한 샘플링, 보안 및 규정 준수 규칙을 관리할 수 있습니다.
더 많은 클러스터 추가
게이트웨이 설정에 새 클러스터를 추가하려면
- 뉴렐릭 컨트롤을 열고 Gateway 선택하세요.
- 클러스터 테이블에서 Add a cluster [클러스터 추가를] 클릭합니다.
- 게이트웨이 설정 의 지침을 따르세요.
- 게이트웨이 요약 페이지로 돌아가세요. 새로 추가된 클러스터가 표시됩니다.
게이트웨이 컨테이너를 생성한 후 YAML 설정을 사용하여 파이프라인 처리를 구성하십시오. 게이트웨이 설정을 참조하세요.