• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

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

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

UI에 데이터가 나타나지 않습니다.

문제

뉴렐릭 eBPF 에이전트를 설치했지만 뉴렐릭 UI 에 eBPF 데이터가 표시되지 않거나 특정 프로토콜에 대한 특정 지표나 범위가 누락되었습니다.

해결책

eBPF 데이터가 전혀 나타나지 않는 경우:

  1. 네트워크 연결 확인: OTLP(OpenTelemetry Protocol) 엔드포인트가 네트워크 설정이나 어떤 것에 의해 차단되지 않았는지 확인하세요. 다음 URL에 액세스할 수 있는지 확인하세요.

    • otlp.nr-data.net:443
    • otlp.eu01.nr-data.net:443 (EU 지역에 한함)
    • https://downloads.newrelic.com
    • https://nr-downloads-ohai-staging.s3.amazonaws.com

중요

포트 4317 및 443이 여러 수준에서 차단 해제되었는지 확인하세요.

  • Cluster 수준: Kubernetes 구현, 배포(예: AKS 클러스터)의 경우 클러스터의 네트워크 보안 그룹이 이러한 포트에서 아웃바운드 트래픽을 허용하는지 확인합니다.

  • 감시 수준: 보안 소프트웨어(예: Microsoft Defender, 기업용)가 감시 수준에서 이러한 포트를 차단하지 않는지 확인합니다.

    포트 차단은 두 레벨에서 동시에 발생할 수 있으며, 한 레벨이 올바르게 구성되어 있어도 연결 문제가 발생할 수 있습니다.

  1. 에이전트 설치 확인: eBPF 에이전트 서비스가 실행 중인지 확인하세요.

    Linux 호스트의 경우:

    bash
    $
    sudo systemctl status newrelic-ebpf-agent
    $
    sudo systemctl status newrelic-ebpf-agent-client

    Kubernetes 의 경우:

    bash
    $
    kubectl get pods -n newrelic
  2. 에이전트 로그 확인: 에이전트 로그에서 오류를 찾아보세요. 성공적으로 설치되면 다음이 표시됩니다.

    [STEP-7] => Successfully started the eBPF Agent.
  3. 올바른 필터 사용: 뉴렐릭 UI 에서 부분을 instrumentation.name = nr_ebpf 으로 필터링하여 eBPF-모니터 서비스를 확인하세요.

특정 메트릭이나 범위가 누락된 경우:

  1. 프로토콜 설정 확인: 설정 파일에서 특정 프로토콜에 대해 지표와 범위가 활성화되어 있는지 확인하세요.

    Linux 호스트 (/etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf)의 경우:

    bash
    $
    PROTOCOLS_HTTP_ENABLED="true"
    $
    PROTOCOLS_HTTP_SPANS_ENABLED="true"
    $
    PROTOCOLS_MYSQL_ENABLED="true"
    $
    # ... other protocols

    Kubernetes의 경우 ( values.yaml 에서):

    protocols:
    http:
    enabled: true
    spans:
    enabled: true
    mysql:
    enabled: true
  2. 설정 변경 후 에이전트를 다시 시작합니다.

    Linux 호스트의 경우:

    bash
    $
    sudo systemctl restart newrelic-ebpf-agent

    Kubernetes 의 경우:

    bash
    $
    helm upgrade nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --reuse-values
  3. 데이터 필터링 설정 확인: 귀하의 파티션이 DROP_DATA_FOR_ENTITY 또는 dropDataServiceNameRegex 등의 설정 초기화에 의해 제외되지 않았는지 확인하세요.

추가 확인 단계:

  1. 호스트별로 필터링: 뉴렐릭 UI 의 host.name 태그를 사용하여 특정 호스트에서 실행 중인 부분을 필터링할 수 있습니다.

  2. 코멘트 이름 지정 확인: 코멘트는 다음과 같이 자동으로 이름이 지정됩니다.

    • Linux 호스트: processName:workingDirectory:[port] (예: ruby:/path/to/app:[5678])
    • 도커: processName:containerName:[port] (예: java:my-container:[8080])
    • Kubernetes: Kubernetes 서비스 이름 기반(예: mysql-database-service)
  3. 사용자 지정 이름 확인: NEW_RELIC_APP_NAME 사용하는 경우 해당 항목이 -ebpf 접미사와 함께 표시됩니다.

Copyright © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.