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. 설치를 확인하려면 다음 명령을 실행하세요.
  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 데이터를 보려면:

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

eBPF 에이전트 업그레이드

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

중요

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

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

one.newrelic.com > + Integration & Agents > eBPF Agent 으로 이동
업데이트된 명령을 받으려면 설치 흐름을 따르세요.
호스트에서 명령을 실행하여 에이전트를 업그레이드하세요.
아래 명령어를 사용하여 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 환경 변수를 설정하여 맞춤 이름을 할당할 수 있습니다.

반응, 이름	설명	데이터 형식	예시 값
`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)`	`""`
`APM_DATA_REPORTING`	APM 데이터 보고를 활성화합니다. 이 기능을 활성화하면 에이전트가 애플리케이션 성능 모니터링 데이터를 수집하여 보고합니다.	`String`	`"true"`
`JVM_METRICS_REPORTING`	JVM 메트릭 보고를 활성화합니다. 활성화되면 에이전트는 인스턴스에 대한 JVM 지표를 수집하고 보고합니다.	`String`	`"true"`
`DROP_NETWORK_METRICS_DATA_FOR_ENTITY_NAME`	네트워크 메트릭 데이터를 삭제할 엔티티 이름을 쉼표로 구분하여 나열합니다. 예를 들면: `"kube-dns,otel-collector,service1"` .	`String`	`""`
`KEEP_NETWORK_METRICS_DATA_FOR_ENTITY_NAME`	네트워크 메트릭 데이터를 항상 유지하기 위한 엔티티 이름 목록을 쉼표로 구분하여 입력합니다. 기본적으로 모든 엔티티가 유지/활성화됩니다. 이는 DROP_NETWORK_METRICS_DATA_FOR_ENTITY_NAME 필터를 우회합니다. 예를 들면: `"critical-service,important-app,must-monitor"` .	`String`	`""`
`DROP_APM_DATA_FOR_ENTITY_NAME`	eBPF APM 데이터를 삭제할 엔티티 이름을 쉼표로 구분하여 나열합니다. 예를 들면: `"kube-dns,otel-collector,service1"` .	`String`	`""`
`KEEP_APM_DATA_FOR_ENTITY_NAME`	eBPF APM 데이터를 항상 유지하기 위한 엔티티 이름 목록을 쉼표로 구분하여 입력합니다. 기본적으로 모든 엔티티가 유지/활성화됩니다. 이것은 `DROP_APM_DATA_FOR_ENTITY_NAME` 필터를 우회합니다. 예를 들면: `"critical-service,important-app,must-monitor"` .	`String`	`""`
`DROP_EAPM_DATA_FOR_APM_AGENT_ENABLED_ENTITY`	NewRelic/OpenTelemetry APM 에이전트가 실행 중인 애플리케이션/엔티티에 대한 eBPF APM 데이터를 삭제합니다.	`String`	`"true"`
`DROP_ALL_DATA_FOR_ENTITY_NAME_REGEX`	모든 데이터(TCP 통계 + APM 데이터)를 삭제하기 위한 엔티티 이름과 일치하는 정규 표현식 패턴입니다. 예를 들어: `"java-app\|otel-collector\|\\bservice1\\b"`	`String`	`""`
`KEEP_ALL_DATA_FOR_ENTITY_NAME_REGEX`	모든 데이터를 항상 유지하기 위해 엔티티 이름과 일치하는 정규 표현식 패턴입니다. 이렇게 하면 모든 드롭 필터를 우회할 수 있습니다. 예를 들어: `"critical-service\|important-app\|\\bmust-monitor\\b"`	`String`	`""`
`DROP_ALL_DATA_FOR_APM_AGENT_ENABLED_ENTITY`	NewRelic/OpenTelemetry APM 에이전트가 실행 중인 애플리케이션/엔티티의 모든 데이터를 삭제합니다.	`String`	`"false"`
`INCLUDE_PORT_IN_SERVER_ENTITY_IDENTIFICATION`	이 설정을 통해 자동 검색되는 엔티티 이름에 포트를 포함하거나 제외할 수 있습니다. 일반적으로 이름은 `processName:cwd/container_name:[port]` 과 같이 표시됩니다(예: `python:frosty_merkle:[80]` ). 포트 세부 정보를 제외하려면 `python:frosty_merkle` 과 같은 이름의 경우 이 옵션을 `false` 로 설정하세요.	`String`	`"true"`
`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_SPANS_UNLINKED_MAX`	프로토콜별로 보고되는 최대 연결되지 않은 스팬 수를 제어합니다. 제한을 비활성화하려면 값을 0으로 설정하세요.	`String`	`"100"`
`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_THRIFT_ENABLED`	Thrift 프로토콜 추적(메트릭 및 스팬)을 모두 활성화 또는 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_THRIFT_SPANS_ENABLED`	Thrift requests 에 대한 스팬 내보내기를 활성화 또는 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_THRIFT_SPANS_SAMPLING_LATENCY`	Thrift 스팬을 내보내기 위한 샘플링 지연시간 레버 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_THRIFT_SPANS_SAMPLING_ERROR_RATE`	Thrift 서비스 또는 방법에 대한 오류율 백분율(1-100%)을 설정합니다. 서비스의 오류율이 이 값을 초과하면 해당 스팬이 내보내집니다.	`String`	`""`
`PROTOCOLS_MYSQL_ENABLED`	모든 MySQL 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_MYSQL_SPANS_ENABLED`	MySQL 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_MYSQL_SPANS_SAMPLING_LATENCY`	MySQL 스팬을 내보내기 위한 샘플링 지연시간, 예측값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_PGSQL_ENABLED`	모든 PostgreSQL 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_PGSQL_SPANS_ENABLED`	PostgreSQL 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_PGSQL_SPANS_SAMPLING_LATENCY`	PostgreSQL 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_CASS_ENABLED`	모든 Cassandra 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_CASS_SPANS_ENABLED`	Cassandra 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_CASS_SPANS_SAMPLING_LATENCY`	Cassandra 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_REDIS_ENABLED`	모든 REDIS 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_REDIS_SPANS_ENABLED`	REDIS 명령에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_REDIS_SPANS_SAMPLING_LATENCY`	레디스 스팬을 내보내기 위한 샘플링 지연시간 레버 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_MONGODB_ENABLED`	모든 MongoDB 프로토콜 추적을 활성화하거나 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_MONGODB_SPANS_ENABLED`	MongoDB 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_MONGODB_SPANS_SAMPLING_LATENCY`	MongoDB 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_DYNAMODB_ENABLED`	DynamoDB 프로토콜 추적 기능을 모두 활성화 또는 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_DYNAMODB_SPANS_ENABLED`	DynamoDB 쿼리에 대한 스팬 내보내기를 활성화 또는 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_DYNAMODB_SPANS_SAMPLING_LATENCY`	DynamoDB 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_MSSQL_ENABLED`	모든 MSSQL 프로토콜 추적을 활성화 또는 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_MSSQL_SPANS_ENABLED`	MSSQL 쿼리에 대한 스팬 내보내기를 활성화 또는 비활성화합니다.	`String`	`"false"`
`PROTOCOLS_MSSQL_SPANS_SAMPLING_LATENCY`	MSSQL 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_KAFKA_ENABLED`	Kafka 프로토콜 추적 기능을 모두 활성화 또는 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_KAFKA_SPANS_ENABLED`	Kafka 메시지에 대한 스팬 내보내기를 활성화하거나 비활성화합니다. 참고: Kafka 추적은 메트릭을 보고하지 않습니다.	`String`	`"true"`
`PROTOCOLS_KAFKA_SPANS_SAMPLING_LATENCY`	Kafka 스팬을 내보내기 위한 샘플링 지연시간, 기대값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_AMQP_ENABLED`	모든 AMQP 프로토콜 추적 기능을 활성화 또는 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_AMQP_SPANS_ENABLED`	AMQP(예: RabbitMQ) 메시지에 대한 스팬 내보내기를 활성화하거나 비활성화합니다. 참고: AMQP 추적은 메트릭을 보고하지 않습니다.	`String`	`"true"`
`PROTOCOLS_AMQP_SPANS_SAMPLING_LATENCY`	AMQP 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_DNS_ENABLED`	모든 DNS 프로토콜 추적 기능을 활성화 또는 비활성화합니다.	`String`	`"true"`
`PROTOCOLS_DNS_SPANS_ENABLED`	DNS 쿼리에 대한 스팬 내보내기를 활성화하거나 비활성화합니다. 참고: DNS 추적은 메트릭을 보고하지 않습니다.	`String`	`"true"`
`PROTOCOLS_DNS_SPANS_SAMPLING_LATENCY`	DNS 스팬을 내보내기 위한 샘플링 지연 시간, 예측 값을 설정합니다. 이 백분위수보다 느린 requests 에 대한 스팬이 내보내집니다. 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`

eBPF 에이전트 제거

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

bash

$sudo apt-get remove newrelic-ebpf-agent

팁

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

eBPF Kubernetes 설치

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

문제 해결, eBPF 해결

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

eBPF 모범 사례

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

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