Puede instalar el agente eBPF de New Relic en su clúster de Kubernetes para monitorear todo el estado del sistema. El agente eBPF proporciona una visibilidad profunda del rendimiento de la aplicación sin requerir cambios de código ni desplegar un agente específico del idioma.
Instalar el agente eBPF de New Relic
Antes de que empieces
Debe cumplir con los requisitos previos descritos en la documentación de compatibilidad y requisitos de eBPF para el clúster de Kubernetes.
Instalar el agente eBPF
Para instalar el agente eBPF:
Log sesión en su cuenta New Relic .
Vaya a left navigation pane > + Integration & Agents > eBPF Agent.
En la pantalla Select an account, seleccione la cuenta en la que desea instalar el agente eBPF y haga clic en Continue.
En la página Select an installation method, seleccione Kubernetes y haga clic en Continue.
En la pantalla Enter your user key, seleccione una de las siguientes opciones y luego haga clic en Continue:
- Use an existing key: Si ya tiene una clave de usuario, proporcione la clave de usuario. Para obtener más información, consulta Claves de usuario.
- Create a new key: Si no tienes una clave de usuario, haz clic en Create a new key para crear una.
En la pantalla Configure the Kubernetes integration:
- Ingrese el nombre de la implementación de Kubernetes.
- (Opcional) Ingrese el namespace para la integración. El namespace predeterminado es
newrelic. - Haga clic en Continue.
Sugerencia
Si elige un namespace personalizado para su instrumentación New Relic (en lugar del
newrelicpredeterminado), le recomendamos excluir ese namespace del monitoreo agregándolo al parámetro de configuracióndropDataForNamespaces. Esto evita que el agente eBPF monitoree el módulo de instrumentación por sí mismo. Por ejemplo, si empleanewrelic-moncomo su namespace, configure:dropDataForNamespaces: ["kube-system", "newrelic-mon"].En la pantalla Install the Kubernetes integration:
Copie y pegue el comando que se muestra para instalar el agente eBPF en su clúster de Kubernetes usando Helm.
(Opcional) Para descargar el archivo de configuración de
values.yaml, haz clic en Download. Para obtener más información sobre los parámetros de configuración, consulte Parámetros de configuración de K8s.(Opcional) Actualice el archivo
values.yamlsegún sea necesario y guárdelo.(Opcional) Para aplicar los cambios de configuración, ejecute el siguiente comando:
bash$helm repo update ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --values values.yamlPara verificar la instalación, ejecute el siguiente comando:
bash$kubectl get pods -n newrelic
Acceda a los datos eBPF en New Relic
Una vez instalado el agente eBPF, comienza a recopilar datos automáticamente de su host Linux. Puede acceder a estos datos en UI OpenTelemetry de New Relic. Para obtener más información sobre UI OpenTelemetry New Relic, consulte UI OpenTelemetry APM .
Para ver los datos eBPF en New Relic:
- Vaya a one.newrelic.com > APM & Services.
- En el banner de búsqueda, establezca el criterio de búsqueda como
instrumentation.name = nr_ebpf:
Actualizar el agente eBPF
Para actualizar el agente eBPF en un clúster de Kubernetes:
- Para una actualización estándar: use el siguiente comando Helm para actualizar a la última versión:
$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 actualizar una versión específica: Para actualizar a una versión específica, emplee el indicador
--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.5Reemplace <key> con su clave de licencia de New Relic y <cluster-name> con el nombre de su clúster.
Parámetro de configuración
El archivo values.yaml contiene las siguientes secciones de configuración:
Sugerencia
El agente eBPF genera automáticamente nombres de entidades de forma diferente según el entorno:
En los hosts o Docker, estos nombres son una combinación del nombre del proceso, su directorio o ID de contenedor y el puerto de escucha. Por ejemplo,
ruby:/home/ubuntu/app:[5678]ojava:f4aead533895:[8080].En Kubernetes, estos nombres se derivan del nombre del servicio, por ejemplo,
mysql-database-service.Asignar un nombre personalizado a la aplicación:
Puede asignar un nombre personalizado a su aplicación configurando la variable de entorno
NEW_RELIC_APP_NAMEtanto para Kubernetes como para las aplicaciones en el host.
Desinstalar el agente eBPF
Para desinstalar el agente eBPF de su clúster de Kubernetes:
$helm uninstall nr-ebpf-agent -n newrelicSugerencia
Este comando eliminará todos los componentes del agente eBPF de su clúster. El namespace permanecerá a menos que lo elimine explícitamente.