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:
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 Kubernetes 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 Kubernetes:
- Insira o nome da implantação do Kubernetes.
- (Opcional) Insira o namespace para a integração. O namespace padrão é
newrelic. - 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çãodropDataForNamespaces. Isso evita que o próprio agente eBPF monitore o pod de instrumentação. Por exemplo, se você usarnewrelic-moncomo seu namespace, defina:dropDataForNamespaces: ["kube-system", "newrelic-mon"].Na tela Instalar a integração do Kubernetes:
Copie e cole o comando exibido para instalar o agente eBPF no seu cluster do Kubernetes usando Helm.
(Opcional) Para baixar o arquivo de configuração
values.yaml, clique em Download. Para obter mais informações sobre os parâmetros de configuração, consulte Parâmetros de configuração do K8s.(Opcional) Atualize o arquivo
values.yamlconforme necessário e salve-o.(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.yamlPara 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:
- Acesse one.newrelic.com > APM e serviços.
- No banner de pesquisa, defina os critérios de pesquisa como
instrumentation.name = nr_ebpf:
/* 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:
$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:
$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.5Substitua <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:
$helm uninstall nr-ebpf-agent -n newrelicDica
Este comando removerá todos os componentes do agente eBPF do seu cluster. O namespace permanecerá a menos que você o exclua explicitamente.