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:
Login em sua conta New Relic .
Vá para o painel de navegação esquerdo > + Integration & Agents > eBPF Agent.
Na tela Selecionar uma conta, selecione a conta na qual deseja instalar o agente eBPF e clique em Continue.
Na página Selecionar um método de instalação, selecione On a host e clique em Continue.
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.
Na tela Configurar a integração do host, insira o nome da implantação do host e clique em Continue.
Na tela Instalar o agente, execute o comando fornecido no seu terminal para instalar o agente eBPF via pacote Debian.
Copie e cole o comando exibido para instalar o agente eBPF em seu host Debian.
Para verificar a instalação, execute o seguinte comando:
Para agente eBPF:
bash$sudo systemctl status newrelic-ebpf-agentPara cliente eBPF:
bash$sudo systemctl status newrelic-ebpf-agent-client
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.confdisponí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:
- Acesse one.newrelic.com > APM e serviços.
- No banner de pesquisa, defina os critérios de pesquisa como
instrumentation.name = nr_ebpf:
/* * Encontre sua entidade em <DNT>**Todos os serviços da entidade - 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 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:
- Acesse one.newrelic.com > + Integration & Agents > eBPF Agent
- Siga o fluxo de instalação para obter o comando atualizado.
- Execute o comando no seu host para atualizar o agente.
Parâmetro de configuração
O arquivo newrelic-ebpf-agent.conf contém o seguinte parâmetro de configuração:
Desinstale o agente eBPF.
Para desinstalar o agente eBPF de um host Linux, utilize as ferramentas de gerenciamento de pacotes do seu sistema:
$sudo apt-get remove newrelic-ebpf-agentDica
Não é necessário interromper o serviço antes de executar o comando de desinstalação.