Instalar el agente eBPF de New Relic para hosts Linux

Puede instalar el agente eBPF de New Relic en su host Linux para monitorear el estado de todo su 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 requisitos y compatibilidad de eBPF para hosts Linux.

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 On a host 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 host integration, ingrese el nombre de despliegue para el host, luego haga clic en Continue.
En la pantalla Install the agent, ejecute el comando proporcionado en su terminal para instalar el agente eBPF a través del paquete de Debian.
1. Copie y pegue el comando mostrado para instalar el agente eBPF en su host Debian.
2. Para verificar la instalación, ejecute el siguiente comando:
  bash
```
$sudo systemctl status newrelic-ebpf-agent
```
Tras una instalación exitosa, el estado de estos servicios se mostrará como activo (en ejecución).
Sugerencia
Puede personalizar la configuración del agente eBPF editando el archivo newrelic-ebpf-agent.yaml disponible en /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.yaml. Para obtener más información sobre el parámetro de configuración, consulte parámetro de configuración.
Importante
On yum-based hosts, this installation command overwrites /etc/yum.repos.d/newrelic-infra.repo so that it points to a preview yum channel used to fetch the newrelic-ebpf-agent package. This replaces the baseurl that the infrastructure agent's own repository file normally uses, and affects RHEL-family hosts (RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux) as well as Amazon Linux (2, 2022, and 2023).
If you also manage the infrastructure agent or on-host integrations (for example nri-elasticsearch) through this same repository file, yum check-update may stop showing new versions for them after installing or upgrading the eBPF agent, because the preview channel carries a smaller, different package set.
To restore the standard update path for the infrastructure agent and its integrations, re-run the repository setup command for your OS from Add the infrastructure agent repository (RHEL-family) or Amazon Linux, then refresh the yum cache:
bash
```
$sudo yum clean all
$sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'
```
This doesn't affect Debian or Ubuntu hosts, where the eBPF agent is installed from a .deb package outside of the infrastructure agent's apt source list.

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 host Linux, vuelva a ejecutar el comando de instalación desde la UI New Relic. Este proceso instalará la nueva versión del agente y eliminará automáticamente la anterior.

Importante

No se admite la actualización a través de un administrador de paquetes. Debes emplear el comando de instalación desde la UI New Relic para una actualización exitosa.

Importante

On yum-based hosts (RHEL-family and Amazon Linux), re-running the installation command also overwrites /etc/yum.repos.d/newrelic-infra.repo again. If you rely on that file to keep the infrastructure agent or its on-host integrations updated via yum, repeat the repository restore steps after each eBPF agent upgrade.

Para obtener el último comando de instalación:

Vaya a one.newrelic.com > + Integration & Agents > eBPF Agent.
Sigue el flujo de instalación para obtener el comando actualizado.
Ejecute el comando en su host para actualizar el agente.
Reinicie el servicio del agente ebpf usando el siguiente comando:
bash
```
$sudo systemctl restart newrelic-ebpf-agent
```

Parámetro de configuración

El archivo newrelic-ebpf-agent.yaml contiene los siguientes parámetros 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] o java: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_NAME tanto para Kubernetes como para las aplicaciones en el host.

Estos parámetros controlan la identidad principal y el destino de los datos del agente eBPF.

Nombre del parámetro	Descripción	Tipo de datos	Valor de ejemplo
`licenseKey`	Especifica su clave de licencia de New Relic, que es necesaria para enviar datos.	Cadena	`"22387565c...FFFFNRAL"`
`deploymentName`	Especifica un nombre único para su implementación para ayudar a identificar sus datos en New Relic.	Cadena	`"my-deployment"`
`region`	Si utiliza una customSecretLicenseKey, debe proporcionar su región `"US"` / `"EU"` / `"JP"` / `"GOV"` . De lo contrario, deje este valor como una cadena vacía.	Cadena	`""`
`customOtlpEndpoint`	URL del extremo OTLP personalizado. Cuando se establece, esto tiene prioridad sobre los extremos estáticos basados en la región.	Cadena	`""`
`customOtlpEndpointTlsEnabled`	Si TLS está habilitado en el extremo OTLP personalizado. Solo aplicable cuando `customOtlpEndpoint` está configurado.	Booleano	`true`
`customOtlpEndpointTlsCertPath`	Ruta a certificados CA personalizados para la validación TLS del extremo OTLP. Si está vacío, se utilizan los certificados de CA predeterminados del sistema.	Cadena	`""`
`otlpProxy.host`	Nombre de host del proxy HTTP/HTTPS para enrutar telemetry data de OTLP a través de un proxy corporativo. Si está vacío, no se utiliza ningún proxy.	Cadena	`"proxy.example.com"`
`otlpProxy.port`	Puerto del proxy para el proxy OTLP.	Entero	`""`
`otlpProxy.scheme`	Esquema de URL del proxy. Valores aceptados: `http` , `https` .	Cadena	`"http"`
`otlpProxy.user`	Nombre de usuario para la autenticación básica del proxy. Si está vacío, no se utiliza autenticación.	Cadena	`""`
`otlpProxy.password`	Contraseña para la autenticación básica del proxy. Solo se usa junto con `otlpProxy.user` .	Cadena	`""`
`otlpProxy.url`	URL completa del proxy. Cuando se establece, esto anula las configuraciones individuales de `otlpProxy.host` , `port` , `scheme` , `user` y `password` . Formato: `http://[user:pass@]host:port` .	Cadena	`""`
`logLevel`	Establece el nivel de log del agente. Las opciones son `OFF` , `FATAL` , `ERROR` , `WARNING` , `INFO` , `DEBUG` en orden creciente de verbosidad.	Cadena	`"INFO"`
`logFilePath`	Especifica la ruta del archivo para los logs del agente. Si está vacío o la ruta no es válida, los logs se envían a la salida estándar (stdout).	Cadena	`"/var/log/newrelic-ebpf-agent"`
`reportApmData`	Controla los informes de datos de APM. Valores aceptados: `"true"` (enviar siempre), `"false"` (nunca enviar), `"auto"` (enviar solo cuando ni el agente de APM ni el de OTel estén adjuntos).	Cadena	`"auto"`
`reportNetworkMetrics`	Controla la generación de informes de métricas de red. Cuando está habilitado, el agente recopila y reporta métricas de red, incluyendo estadísticas TCP. Valores aceptados: `"true"` (enviar siempre), `"false"` (nunca enviar), `"auto"` .	Cadena	`"auto"`
`reportLogs`	Controla el reporte del log de aplicación. Valores aceptados: `"true"` (enviar siempre), `"false"` (nunca enviar), `"auto"` (enviar a menos que el agente APM adjunto esté recopilando logs activamente por sí mismo, o que haya un agente OTel adjunto). Consulte Detección automática y retroceso para obtener más detalles.	Cadena	`"false"`
`agentMetadataReporting`	Habilita el reporte de metadatos de agente y entidad. Por defecto, el agente exporta los metadatos de agente y entidad a New Relic a través de HTTP. Establezca esto en `false` para deshabilitar por completo la ruta de exportación HTTP del reporte de metadatos.	Booleano	`true`
`ai_monitoring.enabled`	Controla el reporte de telemetría de GenAI. Valores aceptados: `"true"` (enviar siempre), `"false"` (no enviar nunca), `"auto"` (enviar solo cuando ningún agente APM de lenguaje o agente OTel ya esté reportando datos de monitoreo de IA para la entidad).	Cadena	`"false"`
`ai_monitoring.samplingLatency`	Define el umbral de muestreo basado en latencia para exportar spans de GenAI. Admite valores de `p0` a `p99` .	Cadena	`"p50"`
`ai_monitoring.samplingErrorRate`	Define el umbral de la tasa de errores para una ruta de GenAI donde superarlo significa que se exportan los spans correspondientes de la ruta. Opciones: `1` - `100` .	Cadena	`""`
`ai_monitoring.genAICaptureMessageContent`	Cuando `true` , captura el contenido completo del símbolo y la finalización para las interacciones de GenAI. Solo tiene efecto cuando `ai_monitoring.enabled` es `true` o `auto` . Úselo con precaución.	Booleano	`false`
`httpPathNormalizationPatterns`	Define los patrones de normalización de rutas HTTP. Cada patrón debe contener al menos un comodín `*` . Use un prefijo `!` para los patrones de exclusión a fin de preservar las rutas tal como están (omitir el clúster automático). El agente aplica estos patrones antes del clúster automático y tienen prioridad sobre este.	Lista	`["/api/users/", "/api/orders/", "!/health/*"]`
`httpBodyLimitBytes`	Establece el número máximo de bytes capturados del cuerpo de una solicitud/respuesta HTTP. Predeterminado: `1048576` (1 MB) cuando `ai_monitoring.enabled` es `true` o `auto` , de lo contrario, `1024` (1 KB). Aumente este valor si New Relic trunca la carga del monitoreo de IA.	Entero	`2097152`
`includePortInServerEntityIdentification`	La configuración le permite incluir o excluir puertos de los nombres de entidades descubiertos automáticamente. Normalmente, los nombres aparecen como `processName:cwd/container_name:[port]` , por ejemplo, `python:frosty_merkle:[80]` . Para excluir los detalles del puerto, establezca esta opción en `false` para nombres como `python:frosty_merkle` .	Booleano	`true`
`entityLabels`	Etiquetas personalizadas que se agregarán a todas las entidades reportadas por el agente eBPF. Estas etiquetas aparecen como atributos `tags.*` en New Relic (por ejemplo, `tags.environment` , `tags.datacenter` ).	Mapa	`{datacenter: "us-east-1", environment: "production"}`
`downloadedPackagedHeadersPath`	Establece la ruta absoluta del directorio completo donde se descargan manualmente los encabezados de Linux necesarios y se colocan para que los emplee el agente eBPF. Esto es útil en entornos restringidos donde el agente no puede descargar los encabezados de Linux necesarios. El agente identifica los encabezados requeridos según la versión del kernel. Usar sólo luego de la recomendación de soporte de NR.	Cadena	`""`
`distroKernelHeadersPath`	Establece la ruta absoluta del directorio completo donde están presentes los encabezados de Linux para que los emplee el agente eBPF. Esto es útil cuando no se pudieron instalar los encabezados de Linux necesarios o no se pudo determinar la ruta. Usar sólo luego de la recomendación de soporte de NR.	Cadena	`""`

Importante

El eBPF agent admite proxies HTTP CONNECT usando solo el esquema http://. Debido a las limitaciones de gRPC, el esquema https:// (una conexión cifrada con TLS directamente al proxy) no es compatible. Sin embargo, sus telemetry data siempre están cifrados con TLS de extremo a extremo entre el agente y el extremo OTLP de New Relic. El prefijo http:// solo dicta cómo el agente se comunica con el proxy para establecer el túnel. El proxy en sí solo ve el tráfico cifrado y nunca tiene acceso a sus datos. Para obtener instrucciones completas de configuración, consulte Configurar un proxy para el eBPF agent.

Configure los filtros para descartar todos los tipos de datos (métricas de red y datos de APM) en función de la configuración proporcionada.

Nombre del parámetro	Descripción	Tipo de datos	Valor de ejemplo
`allDataFilters.dropServiceNameRegex`	Patrón de expresión regular para coincidir con los nombres de las entidades y descartar TODOS los datos (métricas de red + datos de APM). Por ejemplo: `"java-app\|otel-collector\|\\bservice1\\b"` . Utilice dropServiceNameRegex o keepServiceNameRegex para filtrar nombres de servicios, no ambos. Si se proporcionan ambos, keepServiceNameRegex tiene prioridad.	Cadena	`""`
`allDataFilters.keepServiceNameRegex`	Patrón de expresión regular para hacer coincidir nombres de entidades para conservar siempre TODOS los datos. Esto omite todos los filtros de eliminación. Por ejemplo: `"critical-service\|important-app\|\\bmust-monitor\\b"` . Utilice dropServiceNameRegex o keepServiceNameRegex para filtrar nombres de servicio, no ambos. Si se proporcionan ambos, keepServiceNameRegex tiene prioridad.	Cadena	`""`
`allDataFilters.dropApmAgentEnabledEntity`	Descartar todos los datos de aplicaciones/entidades que tengan agentes APM de NewRelic/OpenTelemetry en ejecución.	Booleano	`false`

Nombre del parámetro

Descripción

Tipo de datos

Valor de ejemplo

allDataFilters.dropServiceNameRegex

Patrón de expresión regular para coincidir con los nombres de las entidades y descartar TODOS los datos (métricas de red + datos de APM). Por ejemplo:

"java-app|otel-collector|\\bservice1\\b"

. Utilice dropServiceNameRegex o keepServiceNameRegex para filtrar nombres de servicios, no ambos. Si se proporcionan ambos, keepServiceNameRegex tiene prioridad.

Cadena

""

allDataFilters.keepServiceNameRegex

Patrón de expresión regular para hacer coincidir nombres de entidades para conservar siempre TODOS los datos. Esto omite todos los filtros de eliminación. Por ejemplo:

"critical-service|important-app|\\bmust-monitor\\b"

. Utilice dropServiceNameRegex o keepServiceNameRegex para filtrar nombres de servicio, no ambos. Si se proporcionan ambos, keepServiceNameRegex tiene prioridad.

Cadena

""

allDataFilters.dropApmAgentEnabledEntity

Descartar todos los datos de aplicaciones/entidades que tengan agentes APM de NewRelic/OpenTelemetry en ejecución.

Booleano

false

Configure los filtros para descartar los datos de APM de eBPF en función de la configuración proporcionada.

Nombre del parámetro	Descripción	Tipo de datos	Valor de ejemplo
`apmDataFilters.dropEntityName`	Lista de nombres de entidades para descartar datos de eBPF APM. Por ejemplo: `["kube-dns", "otel-collector", "service1"]` .	Lista	`[]`
`apmDataFilters.keepEntityName`	Lista de nombres de entidades para conservar siempre los datos de eBPF APM. De forma predeterminada, todas las entidades se conservan/habilitan. Esto omite el filtro `apmDataFilters.dropEntityName` . Por ejemplo: `["critical-service", "important-app"]` .	Lista	`[]`
`apmDataFilters.jvmMetricsReporting`	Habilite el reporte de métricas de la JVM. Cuando está habilitado, el agente recopila y reporta métricas de JVM para aplicaciones Java.	Booleano	`true`

Nombre del parámetro

Descripción

Tipo de datos

Valor de ejemplo

apmDataFilters.dropEntityName

Lista de nombres de entidades para descartar datos de eBPF APM. Por ejemplo:

["kube-dns", "otel-collector", "service1"]

Lista

[]

apmDataFilters.keepEntityName

Lista de nombres de entidades para conservar siempre los datos de eBPF APM. De forma predeterminada, todas las entidades se conservan/habilitan. Esto omite el filtro

apmDataFilters.dropEntityName

. Por ejemplo:

["critical-service", "important-app"]

Lista

[]

apmDataFilters.jvmMetricsReporting

Habilite el reporte de métricas de la JVM. Cuando está habilitado, el agente recopila y reporta métricas de JVM para aplicaciones Java.

Booleano

true

Configure los filtros para descartar/conservar los datos de métricas de red en función de la configuración proporcionada.

Nombre del parámetro	Descripción	Tipo de datos	Valor de ejemplo
`networkMetricsDataFilter.dropEntityName`	Lista de nombres de entidades para descartar datos de métricas de red. Por ejemplo: `["kube-dns", "otel-collector", "service1"]` .	Lista	`[]`
`networkMetricsDataFilter.keepEntityName`	Lista de nombres de entidades para conservar siempre los datos de métricas de red. De forma predeterminada, todas las entidades se conservan/habilitan. Esto omite el filtro `networkMetricsDataFilter.dropEntityName` . Por ejemplo: `["critical-service", "important-app"]` .	Lista	`[]`

Nombre del parámetro

Descripción

Tipo de datos

Valor de ejemplo

networkMetricsDataFilter.dropEntityName

Lista de nombres de entidades para descartar datos de métricas de red. Por ejemplo:

["kube-dns", "otel-collector", "service1"]

Lista

[]

networkMetricsDataFilter.keepEntityName

Lista de nombres de entidades para conservar siempre los datos de métricas de red. De forma predeterminada, todas las entidades se conservan/habilitan. Esto omite el filtro

networkMetricsDataFilter.dropEntityName

. Por ejemplo:

["critical-service", "important-app"]

Lista

[]

Configure filtros para controlar el log de aplicación que el agente eBPF recopila y reporta. Esta configuración solo tiene efecto cuando reportLogs se establece en "true" o "auto".

Nombre del parámetro	Descripción	Tipo de datos	Valor de ejemplo
`logDataFilters.applicationLogReporting.enabled`	Habilita la recopilación de logs de las entidades que coinciden con los filtros a continuación.	Booleano	`true`
`logDataFilters.applicationLogReporting.fileRegex`	Expresión regular para coincidir con los nombres de los archivos de log que se incluirán.	Cadena	`".*.log$"`
`logDataFilters.applicationLogReporting.logLevelThreshold`	Nivel de logs mínimo para reportar (por ejemplo, `TRACE` , `DEBUG` , `INFO` , `WARN` , `ERROR` ).	Cadena	`"INFO"`
`logDataFilters.applicationLogReporting.maxSamplesPerMinute`	Número máximo de muestras de log para recopilar por minuto de una entidad. Una vez que se alcanza este límite, los eventos se muestrean para mantener una distribución uniforme a lo largo del ciclo de recolección.	Entero	`10000`
`logDataFilters.applicationLogReporting.keepStdStreamEntityRegex`	Expresión regular para coincidir con los nombres de las entidades y conservar los logs de STDOUT y STDERR. Use `.*` para reenviar los logs de todas las entidades.	Cadena	`".*"`
`logDataFilters.applicationLogReporting.keepFileEntityRegex`	Expresión regular para coincidir con los nombres de las entidades para conservar los logs de los archivos de log. Use `.*` para reenviar los logs de todas las entidades.	Cadena	`".*"`

Esta sección le permite habilitar el monitoreo para protocolos de red específicos y configurar cómo se recopilan los datos de traza (spans). Puede habilitar o deshabilitar el monitoreo para protocolos como HTTP, MySQL y otros, y establecer parámetros para la recopilación de intervalos en función de la latencia o la tasa de errores. Se admiten los siguientes protocolos:

HTTP
Thrift
MySQL
MariaDB
Aurora MySQL
PostgreSQL
MongoDB
Apache Cassandra
Redis
DinamoDB
MSSQL
kafka
AMQP

DNS

El rastreo del protocolo de MySQL (protocols.mysql) también cubre MariaDB y Aurora MySQL, ya que ambos motores utilizan el mismo protocolo de red que MySQL. La configuración no requiere una sección mariadb o aurora_mysql independiente; habilitar o deshabilitar protocols.mysql controla el rastreo para todos los motores compatibles. El agente detecta automáticamente el tipo específico de base de datos por conexión durante el protocolo de enlace del servidor y lo informa en cada registro. No se puede configurar esta detección manualmente.

Nombre del parámetro	Descripción	Tipo de datos	Valor de ejemplo
`protocols.global.max_unlinked_spans`	Controla la cantidad máxima de spans no vinculados informados por protocolo. Establezca en 0 para deshabilitar el límite. Los tramos no vinculados son tramos que el agente eBPF captura pero no puede asociar con su padre.	Entero	`100`
`protocols.global.unlinked_spans_error_quota_percentage`	Reserva un porcentaje configurable de la cuota de tramos no enlazados para los tramos con errores, lo que garantiza la visibilidad de los errores incluso cuando los tramos normales llegan primero.	Entero	`30`
`protocols.<protocol-name>.enabled`	Si `true` , habilita el monitoreo para el protocolo especificado (por ejemplo, `http` , `mysql` y cualquier otro).	Booleano	`true`
`protocols.<protocol-name>.spans.enabled`	Si `true` , exporta los intervalos de traza para el protocolo habilitado.	Booleano	`true`
`protocols.<protocol-name>.spans.samplingLatency`	Define el umbral de muestreo basado en latencia para exportar spans. Admite valores de `p0` a `p99` .	Cadena	`"p50"`
`protocols.<protocol-name>.spans.samplingErrorRate`	Solo para HTTP y Thrift. Exporta spans de cualquier ruta donde la tasa de errores supere el porcentaje especificado (1-100).	Cadena	`""`

Desinstalar el agente eBPF

Para desinstalar el agente eBPF de un host Linux, emplee las herramientas de administración de paquetes de su sistema:

bash

$sudo apt-get purge newrelic-ebpf-agent

Sugerencia

No es necesario detener el servicio antes de ejecutar el comando de desinstalación.

Instalación de eBPF Kubernetes

Aprenda a configurar el agente eBPF de New Relic para su clúster de Kubernetes.

resolución de problemas eBPF

Aprenda a solucionar problemas con el agente eBPF de New Relic.

eBPF mejores prácticas

Conozca las mejores prácticas para emplear el agente eBPF de New Relic.

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar el agente eBPF de New Relic para hosts Linux

Instalar el agente eBPF de New Relic

Antes de que empieces

Instalar el agente eBPF

Sugerencia

Importante

Acceda a los datos eBPF en New Relic

Actualizar el agente eBPF

Importante

Importante

Parámetro de configuración

Sugerencia

Configuración general

Importante

Todos los filtros de datos

Filtros de datos APM

Filtros de datos de métricas de red

Filtros de datos de log

Configuración de seguimiento de protocolo

Desinstalar el agente eBPF

Sugerencia

Instalación de eBPF Kubernetes

resolución de problemas eBPF

eBPF mejores prácticas

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar el agente eBPF de New Relic para hosts Linux

Instalar el agente eBPF de New Relic .css-21sua1{background:none;border:none;width:0;padding:0;}

Antes de que empieces

Instalar el agente eBPF

Sugerencia

Importante

Acceda a los datos eBPF en New Relic

Actualizar el agente eBPF

Importante

Importante

Parámetro de configuración

Sugerencia

Todos los filtros de datos

Filtros de datos APM

Filtros de datos de métricas de red

Filtros de datos de log

Configuración de seguimiento de protocolo

Desinstalar el agente eBPF

Sugerencia

Instalación de eBPF Kubernetes

resolución de problemas eBPF

eBPF mejores prácticas

Instalar el agente eBPF de New Relic