• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Kubernetes용 뉴렐릭 eBPF 에이전트 설치

쿠버네티스 클러스터에 뉴렐릭 eBPF 에이전트를 설치하여 전체 시스템 상태를 모니터링할 수 있습니다. eBPF 에이전트는 코드 변경이나 구현, 배포할 필요 없이 언어별 에이전트에 대한 심층적인 가시성을 제공합니다.

뉴렐릭 eBPF 에이전트 설치

시작하기 전에

쿠버네티스를 사용하려면 eBPF 호환성 및 요구 사항 문서에 설명된 전제 조건을 충족해야 합니다.

eBPF 에이전트 설치

eBPF 에이전트를 설치하려면:

  1. New Relic 계정에 로그인하세요.

  2. 왼쪽 탐색 창 > + Integration & Agents > eBPF Agent 로 이동합니다.

  3. 계정 선택 화면에서 eBPF 에이전트를 설치할 계정을 선택하고 Continue [계속을] 클릭합니다.

  4. 설치 방법 선택 페이지에서 Kubernetes를 선택하고 Continue [계속을] 클릭합니다.

  5. 사용자 키 입력 화면에서 다음 옵션 중 하나를 선택한 다음 Continue [계속을] 클릭합니다.

    • 기존 키 사용: 이미 사용자 키가 있는 경우 사용자 키를 제공하세요. 자세한 내용은 사용자 키를 참조하세요.
    • 새 키 만들기: 사용자 키가 없으면 Create a new key [새 키 만들기를] 클릭하여 키를 만듭니다.
  6. Kubernetes 통합 구성 화면에서:

    1. Kubernetes 의 구현, 배포 이름을 입력합니다.
    2. (선택 사항) 통합에 대한 네임스페이스를 입력합니다. 기본 네임스페이스는 newrelic 입니다.
    3. 계속 을 클릭합니다.

    뉴럴릭 측정에 대해 사용자 정의 쿼리스페이스를 선택하는 경우(기본값 newrelic 대신) 해당 쿼리스페이스를 dropDataForNamespaces 설정 변수에 추가하여 모델링에서 제외하는 것이 좋습니다. 이는 eBPF 에이전트가 측정, 로그 필드 자체를 모니터링하는 것을 방지합니다. 예를 들어, newrelic-mon 네임스페이스로 사용하는 경우 dropDataForNamespaces: ["kube-system", "newrelic-mon"] 설정합니다.

  7. Kubernetes 통합 설치 화면에서:

    1. Helm 사용하여 쿠버네티스 클러스터에 eBPF 에이전트를 설치하려면 표시된 명령을 복사하여 붙여넣으세요.

    2. (선택 사항) values.yaml 설정 파일을 다운로드하려면 Download [다운로드]를 클릭하세요. 설정 방법에 대한 자세한 내용은 K8s 설정 방법을 참조하세요.

    3. (선택 사항) 필요에 따라 values.yaml 파일을 업데이트하고 저장합니다.

    4. (선택 사항) 설정 변경 사항을 적용하려면 다음 명령을 실행하십시오.

      bash
      $
      helm repo update ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --values values.yaml
    5. 설치를 확인하려면 다음 명령을 실행하세요.

      bash
      $
      kubectl get pods -n newrelic

뉴렐릭에서 eBPF 데이터에 액세스

eBPF 에이전트가 설치되면 Linux 호스트에서 자동으로 데이터를 수집하기 시작합니다. 이 데이터는 뉴렐릭의 OpenTelemetry UI 에서 액세스할 수 있습니다. 뉴렐릭 OpenTelemetry UI 에 대한 자세한 내용은 OpenTelemetry APM UI 참조하세요.

뉴렐릭에서 eBPF 데이터를 보려면:

  1. one.newrelic.com > APM & Services 로 이동하세요.
  2. 검색 배너에서 검색 기준을 instrumentation.name = nr_ebpf 으로 설정합니다. eBPF filter for eBPF data in New Relic OpenTelemetry UI

eBPF 에이전트 업그레이드

쿠버네티스 클러스터에서 eBPF 에이전트를 업그레이드하려면:

  • 표준 업그레이드의 경우: 다음 Helm 명령을 사용하여 최신 버전으로 업그레이드하세요.
bash
$
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 플래그를 사용하세요.
bash
$
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 에이전트를 제거하려면:

bash
$
helm uninstall nr-ebpf-agent -n newrelic

이 명령을 실행하면 클러스터에서 모든 eBPF 에이전트 구성 요소가 제거됩니다. 네임스페이스는 명시적으로 삭제하지 않는 한 그대로 유지됩니다.

eBPF Linux 설치

Linux 호스트에 뉴렐릭 eBPF 에이전트를 설정하는 방법을 알아보세요.

문제 해결, eBPF 해결

뉴렐릭 eBPF 에이전트 관련 문제를 해결하는 방법을 알아보세요.

eBPF 모범 사례

뉴렐릭 eBPF 에이전트 사용 우수 우수 사례에 대해 알아보세요.

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.