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

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

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

문제 신고

Linux 호스트용 뉴렐릭 eBPF 에이전트 설치

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

뉴렐릭 eBPF 에이전트 설치

시작하기 전에

Linux 호스트에 대한 eBPF 호환성 및 요구 사항 문서에 설명된 전제 조건을 충족해야 합니다.

eBPF 에이전트 설치

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

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

  2. left navigation pane > + Integration & Agents > eBPF Agent 으)로 이동합니다.

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

  4. Select an installation method 페이지에서 On a host 선택하고 Continue 클릭합니다.

  5. Enter your user key 화면에서 다음 옵션 중 하나를 선택한 다음 Continue 클릭하십시오.

    • Use an existing key이미 사용자 키가 있는 경우 사용자 키를 제공하십시오. 자세한 내용은 사용자 키를 참조하십시오.
    • Create a new key사용자 키가 없으면 Create a new key 클릭하여 생성하세요.
  6. Configure the host integration 화면에서 호스트에 대한 구현, 배포 이름을 입력한 다음 Continue 클릭합니다.

  7. Install the agent 화면에서 터미널에 제공된 명령어를 실행하여 Debian 패키지를 통해 eBPF 에이전트를 설치하십시오.

    1. 표시된 명령을 복사하여 붙여넣어 Debian 호스트에 eBPF 에이전트를 설치합니다.

    2. 설치를 확인하려면 다음 명령을 실행하세요.

      bash
      $
      sudo systemctl status newrelic-ebpf-agent

    성공적으로 설치하면 이러한 서비스 상태가 활성(실행 중)으로 표시됩니다.

    /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf 에서 사용 가능한 newrelic-ebpf-agent.conf 파일을 편집하여 eBPF 에이전트 설정을 사용자 정의할 수 있습니다. 설정 시위에 대한 자세한 내용은 설정 시위를 참조하세요.

뉴렐릭에서 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 에이전트 업그레이드

Linux 호스트에서 eBPF 에이전트를 업그레이드하려면 뉴렐릭 UI 에서 설치 명령을 다시 실행하세요. 이 프로세스를 실행하면 새로운 에이전트 버전이 설치되고, 이전 버전은 자동으로 제거됩니다.

중요

패키지 매니저를 통한 업그레이드는 지원되지 않습니다. 성공적인 업그레이드를 위해서는 뉴렐릭 UI 에서 설치 명령을 사용해야 합니다.

최신 설치 명령을 받으려면:

  1. one.newrelic.com > + Integration & Agents > eBPF Agent 으)로 이동합니다.

  2. 업데이트된 명령어를 얻으려면 설치 절차를 따르십시오.

  3. 호스트에서 해당 명령어를 실행하여 에이전트를 업그레이드하십시오.

  4. 아래 명령어를 사용하여 ebpf 에이전트 서비스를 다시 시작하십시오.

    bash
    $
    sudo systemctl restart newrelic-ebpf-agent

구성 매개변수

newrelic-ebpf-agent.conf 파일에는 다음과 같은 설정 매개변수가 포함되어 있습니다.

eBPF 에이전트는 환경에 따라 다음과 같이 이름을 자동으로 다르게 생성합니다.

  • 호스트나 도커에서 이러한 이름은 프로세스 이름, 디렉토리 또는 컨테이너 ID, 수신 포트의 조합입니다. 예를 들어, ruby:/home/ubuntu/app:[5678] 또는 java:f4aead533895:[8080].

  • Kubernetes에서 이러한 이름은 mysql-database-service 과 같은 서비스 이름에서 파생됩니다.

    애플리케이션에 사용자 정의 이름 지정:

  • Kubernetes 및 온호스트 제작 모두에 대해 NEW_RELIC_APP_NAME 환경 변수를 설정하여 맞춤 이름을 할당할 수 있습니다.

eBPF 에이전트 제거

Linux 호스트에서 eBPF 에이전트를 제거하려면 시스템의 패키지 관리 도구를 사용하세요.

bash
$
sudo apt-get purge newrelic-ebpf-agent

제거 명령을 실행하기 전에 서비스를 중지할 필요는 없습니다.

eBPF Kubernetes 설치

쿠버네티스 클러스터에 뉴렐릭 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.