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 left navigation pane > + Integration & Agents > eBPF Agent.
Na tela Select an account, selecione a conta na qual deseja instalar o agente eBPF e clique em Continue.
Na página Select an installation method, selecione Kubernetes e clique em Continue.
Na tela Enter your user key, selecione uma das seguintes opções e, em seguida, clique em Continue:
- Use an existing key: Se você já possui uma chave de usuário, forneça a chave de usuário. Para mais informações, consulte Chaves de usuário.
- Create a new key: Se você não tiver uma chave de usuário, clique em Create a new key para criar uma.
Na tela Configure the Kubernetes integration:
- 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 Install the Kubernetes integration:
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 mais informações sobre os parâmetros de configuração, consulte os 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:
- Vá para one.newrelic.com > APM & Services.
- No banner de pesquisa, defina os critérios de pesquisa como
instrumentation.name = nr_ebpf:
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:
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]oujava: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_NAMEtanto para Kubernetes quanto para aplicações on-host.
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.