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

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

뉴렐릭 eBPF 에이전트 설치

시작하기 전에

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

eBPF 에이전트 설치

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

New Relic 계정에 로그인하세요.
왼쪽 탐색 창 > + Integration & Agents > eBPF Agent 로 이동합니다.
계정 선택 화면에서 eBPF 에이전트를 설치할 계정을 선택하고 Continue [계속을] 클릭합니다.
설치 방법 선택 페이지에서 On a host [호스트에서]를 선택하고 Continue [계속을] 클릭합니다.
사용자 키 입력 화면에서 다음 옵션 중 하나를 선택한 다음 Continue [계속을] 클릭합니다.
- 기존 키 사용: 이미 사용자 키가 있는 경우 사용자 키를 제공하세요. 자세한 내용은 사용자 키를 참조하세요.
- 새 키 만들기: 사용자 키가 없으면 Create a new key [새 키 만들기를] 클릭하여 키를 만듭니다.
호스트 구성 통합 화면에서 호스트의 구현, 배포 이름을 입력한 다음 Continue [계속을] 클릭합니다.
에이전트 설치 화면에서 터미널에 제공된 명령을 실행하여 Debian 패키지를 통해 eBPF 에이전트를 설치합니다.
1. 표시된 명령을 복사하여 붙여넣어 Debian 호스트에 eBPF 에이전트를 설치합니다.
2. 설치를 확인하려면 다음 명령을 실행하세요.
  - eBPF 에이전트의 경우:
    bash
```
$sudo systemctl status newrelic-ebpf-agent
```
  - eBPF 클라이언트의 경우:
    bash
```
$sudo systemctl status newrelic-ebpf-agent-client
```
성공적으로 설치하면 이러한 서비스 상태가 활성(실행 중)으로 표시됩니다.
팁
/etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf 에서 사용 가능한 newrelic-ebpf-agent.conf 파일을 편집하여 eBPF 에이전트 설정을 사용자 정의할 수 있습니다. 설정 시위에 대한 자세한 내용은 설정 시위를 참조하세요.

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

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

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

one.newrelic.com > APM & Services 로 이동하세요.
검색 배너에서 검색 기준을 instrumentation.name = nr_ebpf 으로 설정합니다.

/* * <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 에이전트 업그레이드

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

중요

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

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

one.newrelic.com > + Integration & Agents > eBPF Agent 으로 이동
업데이트된 명령을 받으려면 설치 흐름을 따르세요.
호스트에서 명령을 실행하여 에이전트를 업그레이드하세요.

구성 매개변수

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

반응, 이름	설명	데이터 형식	예시 값
`NEW_RELIC_LICENSE_KEY`	데이터를 전송하는 데 필요한 블루 클러스터 키를 지정합니다.	`String`	`22387565c...FFFFNRAL`
`DEPLOYMENT_NAME`	배포의 고유한 이름을 지정하여 뉴렐릭에서 해당 데이터를 식별하는 데 도움을 줍니다.	`String`	`fe`
`OTLP_ENDPOINT`	에이전트가 텔레메트리 데이터를 보내는 OTLP 엔드포인트를 정의합니다.	`String (Host:Port)`	`otlp.nr-data.net:443`
`NEW_RELIC_LOG_LEVEL`	에이전트의 로그 레벨을 설정합니다. 옵션은 자세한 순서대로 `OFF` , `FATAL` , `ERROR` , `WARNING` , `INFO` , `DEBUG` 입니다.	`String`	`INFO`
`NEW_RELIC_LOG_FILE_PATH`	에이전트 로그의 파일 경로를 지정합니다. 비어 있거나 경로가 유효하지 않으면 로그가 표준 출력(stdout)으로 전송됩니다.	`String (Path)`	`""`
`VIZIER_PORT`	에이전트가 클라이언트로부터 pxl 스크립트를 수신하는 Vizier 서버 포트입니다. 기본값은 12345입니다.	`String`	`"12345"`
`APM_DATA_REPORTING`	APM 데이터 보고를 활성화합니다. 이 기능을 활성화하면 에이전트가 애플리케이션 성능 모니터링 데이터를 수집하여 보고합니다.	`String`	`"true"`
`TCP_STATS_REPORTING`	TCP 통계 보고를 활성화합니다. 이 기능을 활성화하면 에이전트는 저수준 TCP 메트릭을 수집하여 보고하고 네트워크 모니터링을 시작합니다.	`String`	`"true"`
`DROP_DATA_FOR_ENTITY`	제외하려는 학술 집합의 특정 이름과 일치하는 정규 표현식 패턴입니다.	`String`	`""`
`INCLUDE_PORT_IN_SERVER_ENTITY_IDENTIFICATION`	이 설정을 사용하면 자동 검색된 이름에서 포트를 포함하거나 제외할 수 있습니다. 일반적으로 이름은 `processName:cwd/container_name:[port]` 으로 표시됩니다(예: `python:frosty_merkle:[80]` ). 포트 세부 정보를 제외하려면 `python:frosty_merkle` 와 같은 이름에 대해 이 옵션을 false로 설정합니다.	`String`	`"true"`
`TLS_ENABLED`	eBPF 클라이언트와 에이전트 간 통신에 TLS를 활성화하거나 비활성화합니다.	`String`	`"true"`
`TLS_AUTOGENERATE_CERT_ENABLED`	`true` 로 설정하면 TLS에 대한 자체 서명 인증서가 자동으로 생성됩니다. 자체 인증서를 제공하는 경우 `false` 로 설정합니다.	`String`	`"true"`
`TLS_CERT_PATH`	자동 생성된 TLS 인증서가 저장되는 디렉토리 경로를 지정합니다.	`String (Path)`	`/tmp/ebpf/certs/`
`TLS_CERT_FILE`	사용자 정의 PEM 인코딩된 공개 인증서 파일의 경로를 지정합니다. `TLS_AUTOGENERATE_CERT_ENABLED` 이 `false` 인 경우 필수입니다.	`String (Path)`	`""`
`TLS_KEY_FILE`	사용자 정의 PEM 인코딩된 개인 키 파일의 경로를 지정합니다. `TLS_AUTOGENERATE_CERT_ENABLED` 이 `false` 인 경우 필수입니다.	`String (Path)`	`""`
`TLS_CA_FILE`	사용자 정의 PEM 인코딩 인증 기관(CA) 파일의 경로를 지정합니다. `TLS_AUTOGENERATE_CERT_ENABLED` 이 `false` 인 경우 필수입니다.	`String (Path)`	`""`
`TABLE_STORE_DATA_LIMIT_MB`	eBPF 에이전트가 내부 데이터 테이블 저장소에 사용할 수 있는 최대 메모리(MiB)를 설정합니다. 이는 에이전트의 RAM 사용량을 제어하는 기본 방법입니다.	정수	`250`
`DOWNLOADED_PACKAGED_HEADERS_PATH`	eBPF 에이전트가 사용할 필수 Linux 헤더를 수동으로 다운로드하여 배치하는 전체 디렉토리의 절대 경로를 설정합니다. 이 기능은 에이전트가 필요한 Linux 헤더를 다운로드할 수 없는 제한된 환경에서 유용합니다. 필수 헤더는 커널 버전을 기반으로 에이전트에 의해 식별됩니다. NR 지원 권장 이후에만 사용하세요.	`String (Path)`	`"/path/to/downloaded/headers/dir"`
`DISTRO_KERNEL_HEADERS_PATH`	eBPF 에이전트가 사용할 Linux 헤더가 있는 전체 디렉토리의 절대 경로를 설정합니다. 이 기능은 필요한 Linux 헤더를 설치할 수 없거나 경로를 결정할 수 없는 경우에 유용합니다. NR 지원 권장 이후에만 사용하세요.	`String (Path)`	`"/usr/src/kernels"`
`PROTOCOLS_HTTP_ENABLED`	모든 HTTP 프로토콜 추적(메트릭 및 스팬)을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_HTTP_SPANS_ENABLED`	HTTP requests 에 대한 span 내보내기를 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_HTTP_SPANS_SAMPLING_LATENCY`	HTTP 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_HTTP_SPANS_SAMPLING_ERROR_RATE`	HTTP 경로에 대한 오류율 백분율(1～100)을 설정합니다. 경로의 오류율이 이 값을 초과하면 해당 스팬이 내보내집니다.	`String`	`""`
`PROTOCOLS_MYSQL_ENABLED`	모든 MySQL 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_MYSQL_SPANS_ENABLED`	MySQL 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_PGSQL_ENABLED`	모든 PostgreSQL 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_PGSQL_SPANS_ENABLED`	PostgreSQL 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_CASS_ENABLED`	모든 Cassandra 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_CASS_SPANS_ENABLED`	Cassandra 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_REDIS_ENABLED`	모든 REDIS 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_REDIS_SPANS_ENABLED`	REDIS 명령에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_MONGODB_ENABLED`	모든 MongoDB 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_MONGODB_SPANS_ENABLED`	MongoDB 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_KAFKA_SPANS_ENABLED`	Kafka 메시지에 대한 스팬 내보내기를 활성화하거나 비활성화합니다. 참고: Kafka 추적은 메트릭을 보고하지 않습니다.	`String`	`"false"`
`PROTOCOLS_AMQP_SPANS_ENABLED`	AMQP(예: RabbitMQ) 메시지에 대한 스팬 내보내기를 활성화하거나 비활성화합니다. 참고: AMQP 추적은 메트릭을 보고하지 않습니다.	`String`	`"false"`
`PROTOCOLS_DNS_SPANS_ENABLED`	DNS 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다. 참고: DNS 추적은 메트릭을 보고하지 않습니다.	`String`	`"false"`

eBPF 에이전트 제거

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

bash

$sudo apt-get remove newrelic-ebpf-agent

팁

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

eBPF Kubernetes 설치

쿠버네티스 클러스터에 뉴렐릭 eBPF 에이전트를 설정하는 방법을 알아보세요.

문제 해결, eBPF 해결

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

eBPF 모범 사례

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

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