문제
뉴렐릭 eBPF 에이전트를 설치했지만 뉴렐릭 UI 에 eBPF 데이터가 표시되지 않거나 특정 프로토콜에 대한 특정 지표나 범위가 누락되었습니다.
해결책
eBPF 데이터가 전혀 나타나지 않는 경우:
네트워크 연결 확인: OTLP(OpenTelemetry Protocol) 엔드포인트가 네트워크 설정이나 어떤 것에 의해 차단되지 않았는지 확인하세요. 다음 URL에 액세스할 수 있는지 확인하세요.
otlp.nr-data.net:443otlp.eu01.nr-data.net:443(EU 지역에 한함)https://downloads.newrelic.comhttps://nr-downloads-ohai-staging.s3.amazonaws.com
중요
포트 4317 및 443이 여러 수준에서 차단 해제되었는지 확인하세요.
Cluster 수준: Kubernetes 구현, 배포(예: AKS 클러스터)의 경우 클러스터의 네트워크 보안 그룹이 이러한 포트에서 아웃바운드 트래픽을 허용하는지 확인합니다.
감시 수준: 보안 소프트웨어(예: Microsoft Defender, 기업용)가 감시 수준에서 이러한 포트를 차단하지 않는지 확인합니다.
포트 차단은 두 레벨에서 동시에 발생할 수 있으며, 한 레벨이 올바르게 구성되어 있어도 연결 문제가 발생할 수 있습니다.
에이전트 설치 확인: eBPF 에이전트 서비스가 실행 중인지 확인하세요.
Linux 호스트의 경우:
bash$sudo systemctl status newrelic-ebpf-agent$sudo systemctl status newrelic-ebpf-agent-clientKubernetes 의 경우:
bash$kubectl get pods -n newrelic에이전트 로그 확인: 에이전트 로그에서 오류를 찾아보세요. 성공적으로 설치되면 다음이 표시됩니다.
[STEP-7] => Successfully started the eBPF Agent.올바른 필터 사용: 뉴렐릭 UI 에서 부분을
instrumentation.name = nr_ebpf으로 필터링하여 eBPF-모니터 서비스를 확인하세요.
특정 메트릭이나 범위가 누락된 경우:
프로토콜 설정 확인: 설정 파일에서 특정 프로토콜에 대해 지표와 범위가 활성화되어 있는지 확인하세요.
Linux 호스트 (
/etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf)의 경우:bash$PROTOCOLS_HTTP_ENABLED="true"$PROTOCOLS_HTTP_SPANS_ENABLED="true"$PROTOCOLS_MYSQL_ENABLED="true"$# ... other protocolsKubernetes의 경우 (
values.yaml에서):protocols:http:enabled: truespans:enabled: truemysql:enabled: true설정 변경 후 에이전트를 다시 시작합니다.
Linux 호스트의 경우:
bash$sudo systemctl restart newrelic-ebpf-agentKubernetes 의 경우:
bash$helm upgrade nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --reuse-values데이터 필터링 설정 확인: 귀하의 파티션이
DROP_DATA_FOR_ENTITY또는dropDataServiceNameRegex등의 설정 초기화에 의해 제외되지 않았는지 확인하세요.
추가 확인 단계:
호스트별로 필터링: 뉴렐릭 UI 의
host.name태그를 사용하여 특정 호스트에서 실행 중인 부분을 필터링할 수 있습니다.코멘트 이름 지정 확인: 코멘트는 다음과 같이 자동으로 이름이 지정됩니다.
- Linux 호스트:
processName:workingDirectory:[port](예:ruby:/path/to/app:[5678]) - 도커:
processName:containerName:[port](예:java:my-container:[8080]) - Kubernetes: Kubernetes 서비스 이름 기반(예:
mysql-database-service)
- Linux 호스트:
사용자 지정 이름 확인:
NEW_RELIC_APP_NAME사용하는 경우 해당 항목이-ebpf접미사와 함께 표시됩니다.