쿠버네티스 클러스터에 뉴렐릭 eBPF 에이전트를 설치하여 전체 시스템 상태를 모니터링할 수 있습니다. eBPF 에이전트는 코드 변경이나 구현, 배포할 필요 없이 언어별 에이전트에 대한 심층적인 가시성을 제공합니다.
뉴렐릭 eBPF 에이전트 설치
시작하기 전에
쿠버네티스를 사용하려면 eBPF 호환성 및 요구 사항 문서에 설명된 전제 조건을 충족해야 합니다.
eBPF 에이전트 설치
eBPF 에이전트를 설치하려면:
New Relic 계정에 로그인하세요.
왼쪽 탐색 창 > + Integration & Agents > eBPF Agent 로 이동합니다.
계정 선택 화면에서 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으로 설정합니다.
/* 앱이 계측되고 뉴렐릭으로 데이터를 내보내도록 구성되면 뉴렐릭 UI 에서 데이터를 찾을 수 있어야 합니다. * <DNT>**모든 > 서비스 - OpenTelemetry</DNT>에서 찾아보세요. 엔티티 이름은 앱의 `service.name` 값으로 설정됩니다. 리소스 속성. 뉴렐릭 서비스 부분이 OpenTelemetry 리소스 속성에서 파생되는 방법에 대한 자세한 내용은 [서비스](/docs/OpenTelemetry/모범 참여/OpenTelemetry-모범 참여-resources/#services)를 참조하세요. * [NRQL](/docs/NRQL/get-started/introduction-NRQL(뉴렐릭 쿼리 언어)/)를 사용하여 직접 쿼리합니다. [트레이스](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0 aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml 0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gU3BhbiBTRUxFQ1QgY291bnQoKikgd2hlcmU gbmV3cmVsaWMuc291cmNlPSclb3RscCUnIFRJTUVTRVJJRVMifV0sImluaXRpYWxDaGFydFNldHRpbmdzIjp7ImNoYXJ0VHlwZSI6IkNIQVJUX0xJTkUiLCJsaW1pdCI6NzU0MiwibGlua2VkRW50aXR5R3VpZCI6bnVsbCwibGlua2VkRGFzaGJvYXJkSWQiOm51bGwsInlTY2FsZSI6eyJzdGF0aWMiOmZhbHNlLCJkb21haW4iOltudWxsLG51bGxdfSwieVplcm8iOnRydWV9fQo=), [메트릭](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTWV0cmljIFNFTEVDVCBjb3VudCgqKSB3aGVyZS BuZXdyZWxpYy5zb3VyY2UgTElLRSAnJW90bHAlJyBUSU1FU0VSSUVTIn1dLCJpbml0aWFsQ2hhcnRTZXR0aW5ncyI6eyJjaGFydFR5cGUiOiJDSEFSVF9MSU5FIiwibGltaXQiOjc1NDIsImxpbmtlZEVudGl0eUd1aWQiOm51bGwsImxpbmtlZERhc2hib2FyZElkIjpudWxsLCJ5U2NhbGUiOnsic3RhdGljIjpmYWxzZSwiZG9tYWluIjpbbnVsbCxudWxsXX0sInlaZXJvIjp0cnVlfX0K), 및 [로그](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTG9nIFNFTEVDVCBjb3VudCgqKSB3aGVyZSB uZXdyZWxpYy5zb3VyY2U9JyVvdGxwJScgVElNRVNFUklFUyJ9XSwiaW5pdGlhbENoYXJ0U2V0dGluZ3MiOnsiY2hhcnRUeXBlIjoiQ0hBUlRfTElORSIsImxpbWl0Ijo3NTQyLCJsaW5rZWRFbnRpdHlHdWlkIjpudWxsLCJsaW5rZWREYXNoYm9hcmRJZCI6bnVsbCwieVNjYWxlIjp7InN0YXRpYyI6ZmFsc2UsImRvbWFpbiI6W251bGwsbnVsbF19LCJ5WmVybyI6dHJ1ZX19Cg==). * 자세한 내용은 [OpenTelemetry APM UI](/docs/OpenTelemetry/get-started/APM-모니터링/OpenTelemetry-APM-UI)를 참조하세요. 분리를 찾을 수 없고 NRQL 로 데이터가 보이지 않는 경우, [OTLP 문제 해결, 해결](/docs/OpenTelemetry/모범 참여/OpenTelemetry-otlp-문제 해결, 해결)을 참조하세요. 뉴렐릭 Opentelementry UI 에서 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 에이전트 제거
쿠버네티스 클러스터에서 eBPF 에이전트를 제거하려면:
$helm uninstall nr-ebpf-agent -n newrelic팁
이 명령을 실행하면 클러스터에서 모든 eBPF 에이전트 구성 요소가 제거됩니다. 네임스페이스는 명시적으로 삭제하지 않는 한 그대로 유지됩니다.