Instalar y configurar la integración de New Relic eBPF

Avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta función se proporciona actualmente como parte de una vista previa de conformidad con nuestras políticas de prelanzamiento. No está disponible para clientes sujetos a las regulaciones HIPAA o FedRAMP.

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.

Compatibilidad y requisitos

Versiones del kernel de Linux 5.4 y posteriores.
privilegios de root
Admite arquitectura arm64 y x86-64.
Se requiere un mínimo de 2 GB de RAM para la instalación del host.
Admite las siguientes distribuciones:
- Ubuntu 20.04 y posteriores
- Debian 11 y posteriores
- CentOS Stream 9 y posteriores
- RHEL 8 y posteriores

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 On a host 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 del host, ingrese el nombre de la implementación para el host y luego haga clic en Continue.
En la pantalla Instalar el agente, ejecute el comando proporcionado en su terminal para instalar el agente eBPF.
1. Copie y pegue el comando mostrado para instalar el agente eBPF en su host.
2. Para verificar la instalación, ejecute el siguiente comando:
  - Para el agente eBPF:
    bash
```
$sudo systemctl status newrelic-ebpf-agent
```
  - Para el cliente eBPF:
    bash
```
$sudo systemctl status newrelic-ebpf-agent-client
```
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.conf disponible en /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf. 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:

Configurar el panel de control eBPF

El dashboard de red eBPF proporciona una visibilidad profunda del estado de la red de su sistema al rastrear métricas críticas de DNS y TCP directamente desde el kernel. Puede diagnosticar problemas de conectividad analizando las tasas de éxito y fracaso de las resoluciones DNS y las conexiones TCP. Identifique con precisión el rendimiento del cuello de botella monitoreando la latencia clave, como los protocolos de enlace TCP, la entrega de paquetes y la duración de conexiones de corta duración. El dashboard también lo ayuda a realizar un seguimiento del rendimiento de los datos al visualizar los bytes enviados, recibidos y los paquetes descartados.

Para configurar el dashboard de red eBPF:

Vaya a one.newrelic.com > Dashboards.
En los Dashboards, haga clic en + Create a dashboard.
En la ventana Create a dashboard, haga clic en Browse pre-built dashboards.
En la barra de búsqueda, escriba eBPF y seleccione eBPF.
(Opcional) En la ventana que se muestra, haga clic en Edit para cambiar la cuenta.
Haga clic en Setup eBPF Agent para configurar la fuente de datos o haga clic en Skip this step si el agente eBPF ya está configurado.
Haga clic en View dashboard para ver los datos recopilados por el agente eBPF.

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.

/* * Encuentra tu entidad en <DNT>**Todos los servicios de la entidad - OpenTelemetry</DNT>. El nombre de la entidad se establece en el valor del `service.name` de la aplicación. atributo de recurso. Para obtener más información sobre cómo la entidad de servicio New Relic se deriva del atributo de recurso OpenTelemetry, consulte [Servicios](/docs/OpenTelemetry/mejores prácticas/OpenTelemetry-mejores prácticas-resources/#services). * Emplee [NRQL](/docs/NRQL/get-started/introduction-NRQL (New Relic Query Language)/) para consultar directamente [Traza](https:\/\/one.newrelic.com\/launcher\/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gU3BhbiBTRUxFQ1QgY291bnQoKikgd2hlcmU gbmV3cmVsaWMuc291cmNlPSclb3RscCUnIFRJTUVTRVJJRVMifV0sImluaXRpYWxDaGFydFNldHRpbmdzIjp7ImNoYXJ0VHlwZSI6IkNIQVJUX0xJTkUiLCJsaW1pdCI6NzU0MiwibGlua2VkRW50aXR5R3VpZCI6bnVsbCwibGlua2VkRGFzaGJvYXJkSWQiOm51bGwsInlTY2FsZSI6eyJzdGF0aWMiOmZhbHNlLCJkb21haW4iOltudWxsLG51bGxdfSwieVplcm8iOnRydWV9fQo=), [Métrica](https:\/\/one.newrelic.com\/launcher\/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTWV0cmljIFNFTEVDVCBjb3VudCgqKSB3aGVyZS BuZXdyZWxpYy5zb3VyY2UgTElLRSAnJW90bHAlJyBUSU1FU0VSSUVTIn1dLCJpbml0aWFsQ2hhcnRTZXR0aW5ncyI6eyJjaGFydFR5cGUiOiJDSEFSVF9MSU5FIiwibGltaXQiOjc1NDIsImxpbmtlZEVudGl0eUd1aWQiOm51bGwsImxpbmtlZERhc2hib2FyZElkIjpudWxsLCJ5U2NhbGUiOnsic3RhdGljIjpmYWxzZSwiZG9tYWluIjpbbnVsbCxudWxsXX0sInlaZXJvIjp0cnVlfX0K), y [logs](https:\/\/one.newrelic.com\/launcher\/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTG9nIFNFTEVDVCBjb3VudCgqKSB3aGVyZSB Español: uZXdyZWxpYy5zb3VyY2U9JyVvdGxwJScgVElNRVNFUklFUyJ9XSwiaW5pdGlhbENoYXJ0U2V0dGluZ3MiOnsiY2hhcnRUeXBlIjoiQ0hBUlRfTElORSIsImxpbWl0Ijo3NTQyLCJsaW5rZWRFbnRpdHlHdWlkIjpudWxsLCJsaW5rZWREYXNoYm9hcmRJZCI6bnVsbCwieVNjYWxlIjp7InN0YXRpYyI6ZmFsc2UsImRvbWFpbiI6W251bGwsbnVsbF19LCJ5WmVybyI6dHJ1ZX19Cg==). * Consulte [OpenTelemetry APM UI](/docs/OpenTelemetry/get-started/APM-monitoreo/OpenTelemetry-APM-UI) para obtener más información. Si no encuentras tu entidad y no ves tus datos con NRQL, consulta [OTLP resolución de problemas](/docs/OpenTelemetry/mejores prácticas/OpenTelemetry-otlp-resolución de problemas). Puede encontrar los datos recopilados por el agente eBPF en la UI de Openelementry New Relic. */

Parámetro de configuración

El archivo newrelic-ebpf-agent.conf contiene el siguiente parámetro de configuración:

Nombre del parámetro	Descripción	Tipo de datos	Valor de ejemplo
`NEW_RELIC_LICENSE_KEY`	Especifica su clave de licencia de New Relic, que es necesaria para enviar datos.	`String`	`22387565c...FFFFNRAL`
`DEPLOYMENT_NAME`	Especifica un nombre único para su implementación para ayudar a identificar sus datos en New Relic.	`String`	`fe`
`OTLP_ENDPOINT`	Define el extremo OTLP donde el agente envía telemetry data.	`String (Host:Port)`	`staging-otlp.nr-data.net:4317`
`NEW_RELIC_LOG_LEVEL`	Establece el nivel de log del agente. Las opciones son `OFF` , `FATAL` , `ERROR` , `WARNING` , `INFO` , `DEBUG` en orden creciente de verbosidad.	`String`	`INFO`
`NEW_RELIC_LOG_FILE_PATH`	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).	`String (Path)`	`""`
`DROP_DATA_FOR_ENTITY`	Proporciona una lista separada por comas de valores `NEW_RELIC_APP_NAME` . El agente eliminará datos de los procesos que coincidan con estos nombres de aplicación.	`String`	`""`
`TLS_ENABLED`	Habilita o deshabilita TLS para la comunicación entre el cliente y el agente eBPF.	`String`	`"true"`
`TLS_AUTOGENERATE_CERT_ENABLED`	Si se establece en `true` , genera automáticamente un certificado autofirmado para TLS. Establezca en `false` si está proporcionando sus propios certificados.	`String`	`"true"`
`TLS_CERT_PATH`	Especifica la ruta del directorio donde se almacenan los certificados TLS generados automáticamente.	`String (Path)`	`/tmp/ebpf/certs/`
`TLS_CERT_FILE`	Especifica la ruta a su archivo de certificado público codificado PEM personalizado. Obligatorio si `TLS_AUTOGENERATE_CERT_ENABLED` es `false` .	`String (Path)`	`""`
`TLS_KEY_FILE`	Especifica la ruta a su archivo de clave privada codificado PEM personalizado. Obligatorio si `TLS_AUTOGENERATE_CERT_ENABLED` es `false` .	`String (Path)`	`""`
`TLS_CA_FILE`	Especifica la ruta a su archivo de autoridad de certificación (CA) codificado en PEM personalizado. Obligatorio si `TLS_AUTOGENERATE_CERT_ENABLED` es `false` .	`String (Path)`	`""`
`TABLE_STORE_DATA_LIMIT_MB`	Establece la memoria máxima (en MiB) que el agente eBPF puede usar para su almacén de tablas de datos interno. Esta es la forma principal de controlar el uso de RAM del agente.	Entero	`250`
`PROTOCOLS_HTTP_ENABLED`	Habilita o deshabilita todo el seguimiento del protocolo HTTP (métrica y spans).	`String`	`"true"`
`PROTOCOLS_HTTP_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para requests HTTP.	`String`	`"true"`
`PROTOCOLS_HTTP_SPANS_SAMPLING_LATENCY`	Establece el umbral de latencia de ejemplificación para exportar intervalos HTTP. Se exportan los intervalos de requests más lentos que este percentil. Opciones: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_HTTP_SPANS_SAMPLING_ERROR_RATE`	Establece un porcentaje de tasa de errores (1-100) para una ruta HTTP. Si la tasa de errores de una ruta excede este valor, se exportan sus tramos correspondientes.	`String`	`""`
`PROTOCOLS_MYSQL_ENABLED`	Habilita o deshabilita todo el seguimiento del protocolo MySQL.	`String`	`"true"`
`PROTOCOLS_MYSQL_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para MySQL consulta.	`String`	`"false"`
`PROTOCOLS_PGSQL_ENABLED`	Habilita o deshabilita todo el seguimiento del protocolo PostgreSQL.	`String`	`"true"`
`PROTOCOLS_PGSQL_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para la consulta de PostgreSQL.	`String`	`"false"`
`PROTOCOLS_CASS_ENABLED`	Habilita o deshabilita todo el seguimiento del protocolo Cassandra.	`String`	`"true"`
`PROTOCOLS_CASS_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para Cassandra Consulta.	`String`	`"false"`
`PROTOCOLS_REDIS_ENABLED`	Habilita o deshabilita todo el seguimiento del protocolo Redis.	`String`	`"true"`
`PROTOCOLS_REDIS_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para los comandos Redis.	`String`	`"false"`
`PROTOCOLS_MONGODB_ENABLED`	Habilita o deshabilita todo el seguimiento del protocolo MongoDB.	`String`	`"true"`
`PROTOCOLS_MONGODB_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para MongoDB consulta.	`String`	`"false"`
`PROTOCOLS_KAFKA_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para mensajes de Kafka. Nota: el seguimiento de Kafka no informa la métrica.	`String`	`"false"`
`PROTOCOLS_AMQP_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para mensajes AMQP (por ejemplo, RabbitMQ). Nota: El rastreo de AMQP no informa la métrica.	`String`	`"false"`
`PROTOCOLS_DNS_SPANS_ENABLED`	Habilita o deshabilita la exportación de intervalos para consulta DNS. Nota: El rastreo de DNS no informa métrica.	`String`	`"false"`

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

Instalar y configurar la integración de New Relic eBPF

Avance

Compatibilidad y requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Instalar el agente eBPF

Sugerencia

Acceda a los datos eBPF en New Relic

Configurar el panel de control eBPF

Sugerencia

Parámetro de configuración

Compatibilidad y requisitos