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.

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.

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 el siguiente parámetro 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"` . 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	`""`
`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"`
`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	`""`

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

[]

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
PostgreSQL
MongoDB
Apache Cassandra
Redis
DinamoDB
MSSQL
kafka
AMQP

DNS

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 ejemplificación basada en latencia para exportar intervalos. Opciones válidas: `p1` , `p10` , `p50` , `p90` , `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

Acceda a los datos eBPF en New Relic

Actualizar el agente eBPF

Importante

Parámetro de configuración

Sugerencia

Configuración general

Todos los filtros de datos

Filtros de datos APM

Filtros de datos de métricas de red

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

Acceda a los datos eBPF en New Relic

Actualizar el agente eBPF

Importante

Parámetro de configuración

Sugerencia

Todos los filtros de datos

Filtros de datos APM

Filtros de datos de métricas de red

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