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 al panel de navegación izquierdo > + Integration & Agents > eBPF Agent.
En la pantalla Seleccionar una cuenta, seleccione la cuenta en la que desea instalar el agente eBPF y haga clic en Continue.
En la página Seleccionar un método de instalación, seleccione Kubernetes y haga clic en Continue.
En la pantalla Ingrese su clave de usuario, seleccione una de las siguientes opciones y luego haga clic en Continue:
- Emplear una clave existente: si ya tiene una clave de usuario, proporcione la clave de usuario. Para obtener más información, consulte Claves de usuario.
- Crear una nueva clave: si no tiene una clave de usuario, haga clic en Create a new key para crear una.
En la pantalla Configurar la integración de Kubernetes:
- 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 Instalar la integración de Kubernetes:
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
values.yaml, haga 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.