Linux 호스트에 뉴렐릭 eBPF 에이전트를 설치하여 전체 시스템 상태를 모니터링할 수 있습니다. eBPF 에이전트는 코드 변경이나 구현, 배포할 필요 없이 언어별 에이전트에 대한 심층적인 가시성을 제공합니다.
뉴렐릭 eBPF 에이전트 설치
시작하기 전에
Linux 호스트에 대한 eBPF 호환성 및 요구 사항 문서에 설명된 전제 조건을 충족해야 합니다.
eBPF 에이전트 설치
eBPF 에이전트를 설치하려면:
New Relic 계정에 로그인하세요.
left navigation pane > + Integration & Agents > eBPF Agent 으)로 이동합니다.
Select an account 화면에서 eBPF 에이전트를 설치할 계정을 선택하고 Continue 클릭합니다.
Select an installation method 페이지에서 On a host 선택하고 Continue 클릭합니다.
Enter your user key 화면에서 다음 옵션 중 하나를 선택한 다음 Continue 클릭하십시오.
- Use an existing key이미 사용자 키가 있는 경우 사용자 키를 제공하십시오. 자세한 내용은 사용자 키를 참조하십시오.
- Create a new key사용자 키가 없으면 Create a new key 클릭하여 생성하세요.
Configure the host integration 화면에서 호스트에 대한 구현, 배포 이름을 입력한 다음 Continue 클릭합니다.
Install the agent 화면에서 터미널에 제공된 명령어를 실행하여 Debian 패키지를 통해 eBPF 에이전트를 설치하십시오.
표시된 명령을 복사하여 붙여넣어 Debian 호스트에 eBPF 에이전트를 설치합니다.
설치를 확인하려면 다음 명령을 실행하세요.
bash$sudo systemctl status newrelic-ebpf-agent
성공적으로 설치하면 이러한 서비스 상태가 활성(실행 중)으로 표시됩니다.
팁
/etc/newrelic-ebpf-agent/newrelic-ebpf-agent.yaml에서 사용 가능한newrelic-ebpf-agent.yaml파일을 편집하여 eBPF 에이전트 설정을 사용자 정의할 수 있습니다. 설정 시위에 대한 자세한 내용은 설정 시위를 참조하세요.중요
yum기반 호스트에서 이 설치 명령은newrelic-ebpf-agent패키지를 가져오는 데 사용되는 미리 보기 yum 채널을 가리키도록/etc/yum.repos.d/newrelic-infra.repo을(를) 덮어씁니다. 이는 인프라 에이전트의 자체 저장소 파일이 일반적으로 사용하는baseurl을(를) 대체하며, Amazon Linux(2, 2022 및 2023)뿐만 아니라 RHEL 계열 호스트(RHEL, CentOS, Rocky Linux, AlmaLinux 및 오라클 Linux)에도 영향을 미칩니다.이 동일한 저장소 파일을 통해 인프라 에이전트 또는 온-호스트 통합(예:
nri-elasticsearch)도 관리하는 경우, 미리 보기 채널에는 더 작고 다른 패키지 세트가 포함되어 있으므로 eBPF 에이전트를 설치하거나 업그레이드한 후yum check-update에서 해당 새 버전을 더 이상 표시하지 않을 수 있습니다.인프라 에이전트 및 해당 통합에 대한 표준 업데이트 경로를 복원하려면 인프라 에이전트 저장소 추가 (RHEL 제품군) 또는 Amazon Linux에서 OS에 맞는 저장소 설정 명령을 다시 실행한 다음 yum 캐시를 새로 고치십시오:
bash$sudo yum clean all$sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'이는 eBPF 에이전트가 인프라 에이전트의
apt소스 목록 외부에 있는.deb패키지에서 설치되는 Debian 또는 Ubuntu 호스트에는 영향을 미치지 않습니다.
뉴렐릭에서 eBPF 데이터에 액세스
eBPF 에이전트가 설치되면 Linux 호스트에서 자동으로 데이터를 수집하기 시작합니다. 이 데이터는 뉴렐릭의 OpenTelemetry UI 에서 액세스할 수 있습니다. 뉴렐릭 OpenTelemetry UI 에 대한 자세한 내용은 OpenTelemetry APM UI 참조하세요.
뉴렐릭에서 eBPF 데이터를 보려면:
- one.newrelic.com > APM & Services 으)로 이동합니다.
- 검색 배너에서 검색 기준을
instrumentation.name = nr_ebpf으로 설정합니다.
eBPF 에이전트 업그레이드
Linux 호스트에서 eBPF 에이전트를 업그레이드하려면 뉴렐릭 UI 에서 설치 명령을 다시 실행하세요. 이 프로세스를 실행하면 새로운 에이전트 버전이 설치되고, 이전 버전은 자동으로 제거됩니다.
중요
패키지 매니저를 통한 업그레이드는 지원되지 않습니다. 성공적인 업그레이드를 위해서는 뉴렐릭 UI 에서 설치 명령을 사용해야 합니다.
중요
yum기반 호스트(RHEL 제품군 및 Amazon Linux)에서 설치 명령을 다시 실행하면 /etc/yum.repos.d/newrelic-infra.repo도 다시 덮어씁니다. yum을(를) 통해 인프라 에이전트 또는 해당 온-호스트 통합을 업데이트된 상태로 유지하기 위해 해당 파일에 의존하는 경우, 각 eBPF 에이전트 업그레이드 후 저장소 복원 단계를 반복하십시오.
최신 설치 명령을 받으려면:
one.newrelic.com > + Integration & Agents > eBPF Agent 으)로 이동합니다.
업데이트된 명령어를 얻으려면 설치 절차를 따르십시오.
호스트에서 해당 명령어를 실행하여 에이전트를 업그레이드하십시오.
아래 명령어를 사용하여 ebpf 에이전트 서비스를 다시 시작하십시오.
bash$sudo systemctl restart newrelic-ebpf-agent
구성 매개변수
newrelic-ebpf-agent.yaml 파일에는 다음 설정 파라미터가 포함되어 있습니다:
팁
eBPF 에이전트는 환경에 따라 다음과 같이 이름을 자동으로 다르게 생성합니다.
호스트나 도커에서 이러한 이름은 프로세스 이름, 디렉토리 또는 컨테이너 ID, 수신 포트의 조합입니다. 예를 들어,
ruby:/home/ubuntu/app:[5678]또는java:f4aead533895:[8080].Kubernetes에서 이러한 이름은
mysql-database-service과 같은 서비스 이름에서 파생됩니다.애플리케이션에 사용자 정의 이름 지정:
Kubernetes 및 온호스트 제작 모두에 대해
NEW_RELIC_APP_NAME환경 변수를 설정하여 맞춤 이름을 할당할 수 있습니다.
eBPF 에이전트 제거
Linux 호스트에서 eBPF 에이전트를 제거하려면 시스템의 패키지 관리 도구를 사용하세요.
$sudo apt-get purge newrelic-ebpf-agent팁
제거 명령을 실행하기 전에 서비스를 중지할 필요는 없습니다.