• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Instale o agente New Relic eBPF para Kubernetes.

Você pode instalar o agente eBPF do New Relic no seu cluster do Kubernetes para monitorar a integridade de todo o sistema. O agente eBPF fornece visibilidade profunda do desempenho do aplicativo sem exigir alterações de código ou implantar agente específico de linguagem.

Instale o agente New Relic eBPF.

Antes de você começar

Você deve atender aos pré-requisitos descritos na documentação de compatibilidade e requisitos do eBPF para cluster do Kubernetes.

Instalar o agente eBPF

Para instalar o agente eBPF:

  1. Login em sua conta New Relic .

  2. Vá para o painel de navegação esquerdo > + Integration & Agents > eBPF Agent.

  3. Na tela Selecionar uma conta, selecione a conta na qual deseja instalar o agente eBPF e clique em Continue.

  4. Na página Selecionar um método de instalação, selecione Kubernetes e clique em Continue.

  5. Na tela Insira sua chave de usuário, selecione uma das seguintes opções e clique em Continue:

    • Usar uma chave existente: Se você já tiver uma chave de usuário, forneça-a. Para obter mais informações, consulte Chaves do usuário.
    • Criar uma nova chave: se você não tiver uma chave de usuário, clique em Create a new key para criar uma.
  6. Na tela Configurar a integração do Kubernetes:

    1. Insira o nome da implantação do Kubernetes.
    2. (Opcional) Insira o namespace para a integração. O namespace padrão é newrelic.
    3. Clique em Continue.

    Dica

    Se você escolher um namespace personalizado para sua instrumentação New Relic (em vez do padrão newrelic), recomendamos excluir esse namespace do monitoramento adicionando-o ao parâmetro de configuração dropDataForNamespaces. Isso evita que o próprio agente eBPF monitore o pod de instrumentação. Por exemplo, se você usar newrelic-mon como seu namespace, defina: dropDataForNamespaces: ["kube-system", "newrelic-mon"].

  7. Na tela Instalar a integração do Kubernetes:

    1. Copie e cole o comando exibido para instalar o agente eBPF no seu cluster do Kubernetes usando Helm.

    2. (Opcional) Para baixar o arquivo de configuração values.yaml, clique em Download. Para obter mais informações sobre o parâmetro de configuração, consulte K8s configuração parâmetro.

    3. (Opcional) Atualize o arquivo values.yaml conforme necessário e salve-o.

    4. (Opcional) Para aplicar as alterações de configuração, execute o seguinte comando:

      bash
      $
      helm repo update ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --values values.yaml
    5. Para verificar a instalação, execute o seguinte comando:

      bash
      $
      kubectl get pods -n newrelic

Acesse os dados do eBPF no New Relic

Depois que o agente eBPF estiver instalado, ele começará automaticamente a coletar dados do seu host Linux. Você pode acessar esses dados na interface de usuário OpenTelemetry do New Relic. Para obter mais informações sobre a interface OpenTelemetry New Relic, consulte Interface OpenTelemetry APM .

Para visualizar os dados do eBPF no New Relic:

  1. Acesse one.newrelic.com > APM e serviços.
  2. No banner de pesquisa, defina os critérios de pesquisa como instrumentation.name = nr_ebpf: eBPF filter for eBPF data in New Relic OpenTelemetry UI

/* Depois que seu aplicativo estiver instrumentado e configurado para exportar dados para o New Relic, você poderá encontrar seus dados na interface New Relic : * Encontre sua entidade em <DNT>**Todas as entidades > Serviços - OpenTelemetry</DNT>. O nome da entidade é definido como o valor do `service.name` do aplicativo atributo de recurso. Para obter mais informações sobre como as entidades de serviço New Relic são derivadas do atributo de recurso OpenTelemetry, consulte [Serviços](/docs/OpenTelemetry/práticas recomendadas/OpenTelemetry-práticas recomendadas-resources/#services). * Use [NRQL](/docs/NRQL/get-started/introduction-NRQL (New Relic Query Language)/) para consultar diretamente [rastreamento](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gU3BhbiBTRUxFQ1QgY291bnQoKikgd2hlcmU gbmV3cmVsaWMuc291cmNlPSclb3RscCUnIFRJTUVTRVJJRVMifV0sImluaXRpYWxDaGFydFNldHRpbmdzIjp7ImNoYXJ0VHlwZSI6IkNIQVJUX0xJTkUiLCJsaW1pdCI6NzU0MiwibGlua2VkRW50aXR5R3VpZCI6bnVsbCwibGlua2VkRGFzaGJvYXJkSWQiOm51bGwsInlTY2FsZSI6eyJzdGF0aWMiOmZhbHNlLCJkb21haW4iOltudWxsLG51bGxdfSwieVplcm8iOnRydWV9fQo=), [métrica](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTWV0cmljIFNFTEVDVCBjb3VudCgqKSB3aGVyZS BuZXdyZWxpYy5zb3VyY2UgTElLRSAnJW90bHAlJyBUSU1FU0VSSUVTIN1dLCJpbml0aWFsQ2hhcnRTZXR0aW5ncyI6eyJjaGFydFR5cGUiOiJDSEFSVF9MSU5FIiwibGltaXQiOjc1NDIsImxpbmtlZEVudGl0eUd1aWQiOm51bGwsImxpbmtlZERhc2hib2FyZElkIjpudWxsLCJ5U2NhbGUiOnsic3RhdGljIjpmYWxzZSwiZG9tYWluIjpbbnVsbCxudWxsXX0sInlaZXJvIjp0cnVlfX0K), e [logs](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTG9nIFNFTEVDVCBjb3VudCgqKSB3aGVyZSB uZXdyZWxpYy5zb3VyY2U9JyVvdGxwJScgVElNRVNFUklFUyJ9XSwiaW5pdGlhbENoYXJ0U2V0dGluZ3MiOnsiY2hhcnRUeXBlIjoiQ0hBUlRfTElORSIsImxpbWl0Ijo3NTQyLCJsaW5rZWRFbnRpdHlHdWlkIjpudWxsLCJsaW5rZWREYXNoYm9hcmRJZCI6bnVsbCwieVNjYWxlIjp7InN0YXRpYyI6ZmFsc2UsImRvbWFpbiI6W251bGwsbnVsbF19LCJ5WmVybyI6dHJ1ZX19Cg==). * Consulte [Interface OpenTelemetry APM ](/docs/OpenTelemetry/get-started/APM-monitoramento/OpenTelemetry-APM-interface) para obter mais informações. Caso não encontre sua entidade e não veja seus dados com NRQL, consulte [OTLP resolução de problemas](/docs/OpenTelemetry/práticas recomendadas/OpenTelemetry-otlp-resolução de problemas). Você pode encontrar os dados coletados pelo agente eBPF na interface do usuário Opentelementry do New Relic. */

Atualize o agente eBPF

Para atualizar o agente eBPF em um cluster do Kubernetes:

  • Para uma atualização padrão: Use o seguinte comando Helm para atualizar para a versão mais recente:
bash
$
KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic
  • Para atualizar para uma versão específica: Para atualizar para uma versão específica, use a flag --version :
bash
$
KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic --version=0.2.5

Substitua <key> pela sua chave de licença New Relic e <cluster-name> pelo nome do seu cluster.

Parâmetro de configuração

O arquivo values.yaml contém as seguintes seções de configuração:

Desinstale o agente eBPF.

Para desinstalar o agente eBPF do seu cluster Kubernetes, execute o seguinte comando:

bash
$
helm uninstall nr-ebpf-agent -n newrelic

Dica

Este comando removerá todos os componentes do agente eBPF do seu cluster. O namespace permanecerá a menos que você o exclua explicitamente.

Instalação Linux eBPF

Aprenda como configurar o agente New Relic eBPF para seu host Linux.

resolução de problemas eBPF

Aprenda a solucionar problemas com o agente eBPF da New Relic.

eBPF práticas recomenda

Conheça as práticas recomendadas para uso do agente New Relic eBPF.

Copyright © 2025 New Relic Inc.

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