뉴렐릭 eBPF 통합 설치 및 구성

시사

이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!

이 기능은 현재 사전 출시 정책 에 따라 미리보기의 일부로 제공됩니다. HIPAA 또는 FedRAMP 규정을 준수하는 고객은 이용할 수 없습니다.

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

호환성 및 요구 사항

모든 Kubernetes 통합 호환성 및 요구 사항이 충족되었는지 확인하세요.

eBPF 에이전트 설치

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

New Relic 계정에 로그인하세요.
왼쪽 탐색 창 > + Integration & Agents > eBPF Agent 로 이동합니다.
계정 선택 화면에서 eBPF 에이전트를 설치할 계정을 선택하고 Continue [계속을] 클릭합니다.
설치 방법 선택 페이지에서 Kubernetes를 선택하고 Continue [계속을] 클릭합니다.
사용자 키 입력 화면에서 다음 옵션 중 하나를 선택한 다음 Continue [계속을] 클릭합니다.
- 기존 키 사용: 이미 사용자 키가 있는 경우 사용자 키를 제공하세요. 자세한 내용은 사용자 키를 참조하세요.
- 새 키 만들기: 사용자 키가 없으면 Create a new key [새 키 만들기를] 클릭하여 키를 만듭니다.
Kubernetes 통합 구성 화면에서:
1. Kubernetes 의 구현, 배포 이름을 입력합니다.
2. (선택 사항) 통합에 대한 네임스페이스를 입력합니다. 기본 네임스페이스는 newrelic 입니다.
3. 계속 을 클릭합니다.
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 데이터를 보려면:

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

eBPF 대시보드 구성

eBPF 네트워크 대시보드는 커널에서 직접 중요한 DNS 및 TCP 메트릭을 추적하여 시스템의 네트워크 상태에 대한 심층적인 가시성을 제공합니다. DNS 확인 및 TCP 연결에 대한 성공 및 실패율을 분석하여 연결 문제를 진단할 수 있습니다. TCP 핸드셰이크, 패킷 전달, 단기 연결 지속 시간 등 주요 지연 시간을 모니터링하여 성능 병목 현상, 병목지점을 찾아냅니다. 대시보드는 전송된 바이트, 수신된 바이트, 삭제된 패킷을 시각화하여 데이터 처리량을 추적하는 데도 도움이 됩니다.

eBPF 네트워크 대시보드를 구성하려면:

one.newrelic.com > Dashboards 로 이동합니다.
Dashboards 에서 + 대시보드 생성 을 클릭합니다.
Create a dashboard [대시보드 만들기] 창에서 Browse pre-built dashboards [사전 구축된 대시보드 찾아보기] 를 클릭합니다.
검색창에 eBPF를 입력하고 eBPF를 선택합니다.
(선택 사항) 표시된 창에서 Edit [편집을] 클릭하여 계정을 변경합니다.
데이터 소스를 설정하려면 Setup eBPF Agent [eBPF 에이전트 설정을] 클릭하거나 eBPF 에이전트가 이미 설정된 경우 Skip this step [이 단계 건너뛰기]를 클릭합니다.
View dashboard [대시보드 보기]를 클릭하면 eBPF 에이전트가 수집한 데이터를 볼 수 있습니다.

팁

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

호스트 또는 도커에서 이름은 프로세스 이름, 디렉토리 또는 컨테이너 ID, 수신 포트의 조합입니다. 예를 들어, ruby:/home/ubuntu/app:[5678] 또는 java:f4aead533895:[8080].
Kubernetes에서는 이름이 서비스 이름에서 파생됩니다(예: mysql-database-service.

/* 앱이 계측되고 뉴렐릭으로 데이터를 내보내도록 구성되면 뉴렐릭 UI 에서 데이터를 찾을 수 있어야 합니다. * <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 에이전트가 수집한 데이터를 확인할 수 있습니다. */

구성 매개변수

values.yaml 파일에는 다음 설정 섹션이 포함되어 있습니다.

이러한 매개변수는 eBPF 에이전트의 핵심 ID와 데이터 대상을 제어합니다.

매개변수	설명	데이터 형식	예시
`cluster`	쿠버네티스 클러스터의 이름을 지정합니다. 이 필드는 필수입니다.	`String`	`"production-cluster"`
`licenseKey`	귀하의 블루 클러스터 키를 지정합니다. `customSecretName` 사용하지 않으면 필수입니다.	`String`	`"8356...FFFFNRAL"`
`nrStaging`	`true` 인 경우 뉴렐릭의 Steizing 환경으로 데이터를 보냅니다.	`Boolean`	`true`
`customSecretName`	라이선스 키가 포함된 Kubernetes 비밀의 이름을 지정합니다. 이 기능을 사용하면 키를 직접 제공하지 않아도 됩니다.	`String`	`"newrelic-license-secret"`
`customSecretLicenseKey`	라이선스 키 값이 저장된 비밀 내의 키를 지정합니다. `customSecretName` 와 함께 사용됩니다.	`String`	`"license"`
`region`	귀하의 뉴렐릭 계정 지역( `US` 또는 `EU` )을 지정합니다. `customSecretName` 사용할 때 필요합니다.	`String`	`"US"`
`proxy`	모든 발신 에이전트 데이터를 라우팅하기 위한 포트를 포함한 프록시 서버의 URL을 지정합니다.	`String`	`"http://user:pass@host:port"`
`logLevel`	에이전트에 대한 로깅 세부 정보 수준을 정의합니다. 유효한 옵션: `OFF` , `FATAL` , `ERROR` , `WARNING` , `INFO` , `DEBUG` .	`String`	`"INFO"`
`logFilePath`	로그 출력을 위한 에이전트 컨테이너 내부의 파일 경로를 지정합니다. 경로가 유효하지 않으면 로그가 stdout으로 전송됩니다.	`String`	`"/var/log/nr-ebpf-agent.log"`

이러한 매개변수는 어떤 데이터가 수집되어 뉴렐릭으로 전송되는지 제어하여 데이터 수집을 관리하는 데 도움이 됩니다.

매개변수	설명	데이터 형식	예시
`dropDataIpServiceNames`	`true` 인 경우 요원이 IP 주소로만 식별되는 서비스에 대해 텔레메트리를 보고하지 못하게 합니다.	`Boolean`	`true`
`dropDataNewRelic`	`true` 인 경우 자체 모니터링을 방지하기 위해 `newrelic` 정리스페이스에서 시작되는 모든 텔레메트리를 삭제합니다.	`Boolean`	`true`
`dropAPMEnabledPods`	`true` 인 경우 데이터 중복을 피하기 위해 이미 뉴렐릭 APM 에이전트로 모니터링 중인 패드에서 텔레메트리를 삭제합니다.	`Boolean`	`true`
`dropDataForNamespaces`	모든 텔리메트리를 삭제할 Kubernetes 지우스페이스 목록을 지정합니다.	`String`	`["kube-system", "monitoring"]`
`dropDataServiceNameRegex`	Go 스타일의 정규 표현식을 정의합니다. 이 패턴과 일치하는 이름을 가진 서비스의 데이터는 삭제됩니다.	`String`	`"kube-dns\\|otel-collector"`
`allowServiceNameRegex`	`dropDataServiceNameRegex` 에 대한 허용 목록 역할을 하는 Go 스타일 정규 표현식을 정의합니다. 매칭 서비스는 삭제 패턴과 일치하더라도 유지됩니다.	`String`	`"allowed-otel-collector"`
`dropDataForEntity`	모니터링에서 제외할 애플리케이션 이름 목록( `NEW_RELIC_APP_NAME` 환경 변수에서)을 지정합니다.	`String`	`["my-test-app", "temp-service"]`
`tableStoreDataLimitMB`	에이전트의 내부 데이터 저장소에 대한 메모리 제한을 메가바이트(MiB) 단위로 정의합니다. 이는 RAM 사용에 대한 기본 제어입니다.	`String`	`"500"`

이 섹션에서는 특정 네트워크 프로토콜에 대한 모니터링을 활성화하고 트레이스 데이터(span)가 수집되는 방식을 구성할 수 있습니다. HTTP, MySQL 등과 같은 프로토콜에 대해 모니터링을 활성화 또는 비활성화하고 지연 시간 또는 오류율을 기반으로 범위 수집에 대해 파장을 설정할 수 있습니다. 다음 프로토콜이 지원됩니다.

HTTP
MySQL
PostgreSQL
MongoDB
아파치 카산드라
Redis
카프카

DNS

매개변수	설명	데이터 형식	예시
`protocols.<protocol-name>.enabled`	`true` 인 경우 지정된 프로토콜(예: `http` , `mysql` 및 기타)에 대한 모니터링이 활성화됩니다.	`Boolean`	`true`
`protocols.<protocol-name>.spans.enabled`	`true` 인 경우, 활성화된 프로토콜에 대한 트레이스 스팬을 내보냅니다.	`Boolean`	`true`
`protocols.<protocol-name>.spans.samplingLatency`	스팬 내보내기를 위한 지연시간 기반 샘플링 기여값을 정의합니다. 유효한 옵션: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p90"`
`protocols.http.spans.samplingErrorRate`	HTTP에만 해당. 오류율이 지정된 백분율(1～100)을 초과하는 모든 경로에서 스팬을 내보냅니다.	`String`	`"5"`

이 섹션에서는 솔루션의 주요 구성 요소에 대한 구현 및 배포 설정을 제어합니다. 별표 (*) 구성 요소 이름을 나타냅니다.

매개변수	설명	데이터 형식	예시
`*.image.repository`	구성 요소의 컨테이너 이미지 저장소를 지정합니다.	`String`	`"docker.io/newrelic/newrelic-ebpf-agent"`
`*.image.pullPolicy`	컨테이너 이미지에 대한 풀 정책을 정의합니다.	`String`	`"IfNotPresent"`
`*.image.tag`	컨테이너 이미지의 버전 태그를 구현하다, 배포하다로 지정합니다.	`String`	`"agent-0.2.4"`
`*.resources.limits.memory`	컨테이너가 사용할 수 있는 최대 메모리를 정의합니다.	`String`	`"2Gi"`
`*.resources.limits.cpu`	컨테이너가 사용할 수 있는 최대 CPU를 정의합니다.	`String`	`"1"`
`*.resources.requests.memory`	컨테이너가 시작될 때 요청되는 최소 메모리를 정의합니다.	`String`	`"250Mi"`
`*.resources.requests.cpu`	컨테이너가 시작될 때 요청되는 최소 CPU를 정의합니다.	`String`	`"100m"`
`*.tolerations`	특정 오염이 있는 노드에서 스케줄링을 허용하기 위해 파드 허용 범위를 정의합니다.	`Objects`	`[{"key": "special", "operator": "Exists"}]`
`*.affinity`	스케줄링을 위한 파드 친화성 및 반친화성 규칙을 정의합니다.	`Object`	`{}`
`*.podAnnotations`	구성 요소의 파드에 추가할 사용자 정의 주석을 지정합니다.	`Object`	`{"iam.amazonaws.com/role": "my-role"}`

이러한 기준은 구성 요소별 설정으로 재정의되지 않는 한 Helm 차트를 통해 모든 파드 구현, 배포에 적용됩니다.

매개변수	설명	데이터 형식	예시
`podLabels`	차트별로 모든 파드 구현하다, 배포하다에 적용할 추가 레이블을 지정합니다.	`Object`	`{"team": "observability"}`
`priorityClassName`	모든 파드에 대해 `PriorityClass` 을 지정합니다.	`String`	`"high-priority"`
`nodeSelector`	레이블이 일치하는 노드에서만 실행되도록 제한합니다.	`Object`	`{"disktype": "ssd"}`

매개변수

설명

데이터 형식

예시

podLabels

차트별로 모든 파드 구현하다, 배포하다에 적용할 추가 레이블을 지정합니다.

Object

{"team": "observability"}

priorityClassName

모든 파드에 대해

PriorityClass

을 지정합니다.

String

"high-priority"

nodeSelector

레이블이 일치하는 노드에서만 실행되도록 제한합니다.

Object

{"disktype": "ssd"}

이 섹션에서는 eBPF 에이전트와 클라이언트 구성 요소 간의 보안 통신을 구성합니다.

매개변수	설명	데이터 형식	예시
`tls.enabled`	`true` 인 경우 구성 요소 간 내부 통신에 TLS를 활성화합니다.	`Boolean`	`true`
`tls.autoGenerateCert.enabled`	`true` 인 경우 Helm이 TLS에 대한 자체 서명 인증서를 자동으로 생성하도록 지시합니다.	`Boolean`	`true`
`tls.autoGenerateCert.recreate`	`true` 인 경우 `helm upgrade` 마다 새 인증서가 생성됩니다.	`Boolean`	`false`
`tls.autoGenerateCert.certPeriodDays`	자동 생성된 인증서의 유효 기간을 일 단위로 정의합니다.	`Integer`	`730`
`tls.certFile`	사용자 정의 PEM 인코딩 인증서 파일의 경로를 지정합니다. `autoGenerateCert.enabled` 은 `false` 이어야 합니다.	`String`	`"my-certs/tls.crt"`
`tls.keyFile`	사용자 정의 PEM 인코딩된 개인 키 파일의 경로를 지정합니다.	`String`	`"my-certs/tls.key"`
`tls.caFile`	사용자 지정 인증 기관(CA) 인증서 파일의 경로를 지정합니다.	`String`	`"my-certs/ca.crt"`

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

뉴렐릭 eBPF 통합 설치 및 구성

시사

호환성 및 요구 사항

eBPF 에이전트 설치

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

eBPF 대시보드 구성

팁

구성 매개변수

일반 설정

데이터 필터링 설정

프로토콜 추적 설정

DaemonSet 설정

글로벌 패드 및 일정 설정

TLS 설정

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

뉴렐릭 eBPF 통합 설치 및 구성

시사

호환성 및 요구 사항 .css-21sua1{background:none;border:none;width:0;padding:0;}

eBPF 에이전트 설치

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

eBPF 대시보드 구성

팁

구성 매개변수

데이터 필터링 설정

프로토콜 추적 설정

DaemonSet 설정

글로벌 패드 및 일정 설정

TLS 설정

호환성 및 요구 사항