• /
  • 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 hosts Linux.

Você pode instalar o agente New Relic eBPF no seu host Linux 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 hosts Linux.

Instalar o agente eBPF

Para instalar o agente eBPF:

  1. Login em sua conta New Relic .

  2. Vá para painel de navegação à esquerda > + 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 On a host 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 host, insira o nome da implantação do host e clique em Continue.

  7. Na tela Instalar o agente, execute o comando fornecido no seu terminal para instalar o agente eBPF via pacote Debian.

    1. Copie e cole o comando exibido para instalar o agente eBPF em seu host Debian.

    2. Para verificar a instalação, execute o seguinte comando:

      bash
      $
      sudo systemctl status newrelic-ebpf-agent

    Após a instalação bem-sucedida, o status desses serviços será exibido como ativo (em execução).

    Dica

    Você pode personalizar a configuração do agente eBPF editando o arquivo newrelic-ebpf-agent.conf disponível em /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf. Para obter mais informações sobre o parâmetro de configuração, consulte parâmetro de configuração.

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

Atualize o agente eBPF

Para atualizar o agente eBPF em um host Linux, execute novamente o comando de instalação na interface do usuário do New Relic. Este processo instalará a nova versão do agente e removerá automaticamente a versão anterior.

Importante

A atualização através de um gerenciador de pacotes não é suportada. Para uma atualização bem-sucedida, você deve usar o comando de instalação da interface do usuário do New Relic.

Para obter o comando de instalação mais recente:

  1. Acesse one.newrelic.com > + Integration & Agents > eBPF Agent

  2. Siga o fluxo de instalação para obter o comando atualizado.

  3. Execute o comando no seu host para atualizar o agente.

  4. Reinicie o serviço do agente ebpf usando o comando abaixo:

    bash
    $
    sudo systemctl restart newrelic-ebpf-agent

Parâmetro de configuração

O arquivo newrelic-ebpf-agent.conf contém o seguinte parâmetro de configuração:

Dica

O agente eBPF gera automaticamente nomes de entidades de forma diferente dependendo do ambiente:

  • Em hosts ou Docker, esses nomes são uma combinação do nome do processo, seu diretório ou ID do contêiner e a porta de escuta. Por exemplo, ruby:/home/ubuntu/app:[5678] ou java:f4aead533895:[8080].

  • No Kubernetes, esses nomes são derivados do nome do serviço, por exemplo, mysql-database-service.

    Atribuindo nome personalizado ao aplicativo:

  • Você pode atribuir um nome personalizado à sua aplicação definindo a variável de ambiente NEW_RELIC_APP_NAME tanto para Kubernetes quanto para aplicações on-host.

Desinstale o agente eBPF.

Para desinstalar o agente eBPF de um host Linux, utilize as ferramentas de gerenciamento de pacotes do seu sistema:

bash
$
sudo apt-get remove newrelic-ebpf-agent

Dica

Não é necessário interromper o serviço antes de executar o comando de desinstalação.

Instalação eBPF Kubernetes

Aprenda como configurar o agente New Relic eBPF para o seu cluster Kubernetes.

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 © 2026 New Relic Inc.

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