쿠버네티스 클러스터에 뉴렐릭 eBPF 에이전트를 설치하여 전체 시스템 상태를 모니터링할 수 있습니다. eBPF 에이전트는 코드 변경이나 구현, 배포할 필요 없이 언어별 에이전트에 대한 심층적인 가시성을 제공합니다.
뉴렐릭 eBPF 에이전트 설치
시작하기 전에
쿠버네티스를 사용하려면 eBPF 호환성 및 요구 사항 문서에 설명된 전제 조건을 충족해야 합니다.
eBPF 에이전트 설치
eBPF 에이전트를 설치하려면:
New Relic 계정에 로그인하세요.
계정 선택 화면에서 eBPF 에이전트를 설치할 계정을 선택하고 Continue [계속을] 클릭합니다.
설치 방법 선택 페이지에서 Kubernetes를 선택하고 Continue [계속을] 클릭합니다.
사용자 키 입력 화면에서 다음 옵션 중 하나를 선택한 다음 Continue [계속을] 클릭합니다.
- 기존 키 사용: 이미 사용자 키가 있는 경우 사용자 키를 제공하세요. 자세한 내용은 사용자 키를 참조하세요.
- 새 키 만들기: 사용자 키가 없으면 Create a new key [새 키 만들기를] 클릭하여 키를 만듭니다.
Kubernetes 통합 구성 화면에서:
- Kubernetes 의 구현, 배포 이름을 입력합니다.
- (선택 사항) 통합에 대한 네임스페이스를 입력합니다. 기본 네임스페이스는
newrelic입니다. - 계속 을 클릭합니다.
팁
뉴럴릭 측정에 대해 사용자 정의 쿼리스페이스를 선택하는 경우(기본값
newrelic대신) 해당 쿼리스페이스를dropDataForNamespaces설정 변수에 추가하여 모델링에서 제외하는 것이 좋습니다. 이는 eBPF 에이전트가 측정, 로그 필드 자체를 모니터링하는 것을 방지합니다. 예를 들어,newrelic-mon네임스페이스로 사용하는 경우dropDataForNamespaces: ["kube-system", "newrelic-mon"]설정합니다.Kubernetes 통합 설치 화면에서:
Helm 사용하여 쿠버네티스 클러스터에 eBPF 에이전트를 설치하려면 표시된 명령을 복사하여 붙여넣으세요.
(선택 사항)
values.yaml설정 파일을 다운로드하려면 Download [다운로드]를 클릭하세요. 설정 방법에 대한 자세한 내용은 K8s 설정 방법을 참조하세요.(선택 사항) 필요에 따라
values.yaml파일을 업데이트하고 저장합니다.(선택 사항) 설정 변경 사항을 적용하려면 다음 명령을 실행하십시오.
bash$helm repo update ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --values values.yaml설치를 확인하려면 다음 명령을 실행하세요.
bash$kubectl get pods -n newrelic
뉴렐릭에서 eBPF 데이터에 액세스
eBPF 에이전트가 설치되면 Linux 호스트에서 자동으로 데이터를 수집하기 시작합니다. 이 데이터는 뉴렐릭의 OpenTelemetry UI 에서 액세스할 수 있습니다. 뉴렐릭 OpenTelemetry UI 에 대한 자세한 내용은 OpenTelemetry APM UI 참조하세요.
뉴렐릭에서 eBPF 데이터를 보려면:
- one.newrelic.com > APM & Services 로 이동하세요.
- 검색 배너에서 검색 기준을
instrumentation.name = nr_ebpf으로 설정합니다.
eBPF 에이전트 업그레이드
쿠버네티스 클러스터에서 eBPF 에이전트를 업그레이드하려면:
- 표준 업그레이드의 경우: 다음 Helm 명령을 사용하여 최신 버전으로 업그레이드하세요.
$KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic- 특정 버전 업그레이드의 경우: 특정 버전으로 업그레이드하려면
--version플래그를 사용하세요.
$KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic --version=0.2.5<key> 클러스터 이름으로 바꾸고 <cluster-name> 뉴렐릭 클러스터 키로 바꾸세요.
구성 매개변수
values.yaml 파일에는 다음 설정 섹션이 포함되어 있습니다.
팁
eBPF 에이전트는 환경에 따라 다음과 같이 이름을 자동으로 다르게 생성합니다.
호스트나 도커에서 이러한 이름은 프로세스 이름, 디렉토리 또는 컨테이너 ID, 수신 포트의 조합입니다. 예를 들어,
ruby:/home/ubuntu/app:[5678]또는java:f4aead533895:[8080].Kubernetes에서 이러한 이름은
mysql-database-service과 같은 서비스 이름에서 파생됩니다.애플리케이션에 사용자 정의 이름 지정:
Kubernetes 및 온호스트 제작 모두에 대해
NEW_RELIC_APP_NAME환경 변수를 설정하여 맞춤 이름을 할당할 수 있습니다.
eBPF 에이전트 제거
쿠버네티스 클러스터에서 eBPF 에이전트를 제거하려면:
$helm uninstall nr-ebpf-agent -n newrelic팁
이 명령을 실행하면 클러스터에서 모든 eBPF 에이전트 구성 요소가 제거됩니다. 네임스페이스는 명시적으로 삭제하지 않는 한 그대로 유지됩니다.