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 painel de navegação à esquerda > + 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:
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.