• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

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

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Instalar el agente eBPF de New Relic para hosts Linux

|View as Markdown (English)

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:

  1. Log sesión en su cuenta New Relic .

  2. Vaya a left navigation pane > + Integration & Agents > eBPF Agent.

  3. En la pantalla Select an account, seleccione la cuenta en la que desea instalar el agente eBPF y haga clic en Continue.

  4. En la página Select an installation method, seleccione On a host y haga clic en Continue.

  5. 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.
  6. En la pantalla Configure the host integration, ingrese el nombre de despliegue para el host, luego haga clic en Continue.

  7. 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

    En los hosts basados en yum, este comando de instalación sobrescribe /etc/yum.repos.d/newrelic-infra.repo para que apunte a un canal de vista previa de yum utilizado para obtener el paquete newrelic-ebpf-agent. Esto reemplaza el baseurl que normalmente utiliza el propio archivo de repositorio del agente de infraestructura, y afecta a los hosts de la familia RHEL (RHEL, CentOS, Rocky Linux, AlmaLinux y Oracle Linux), así como a Amazon Linux (2, 2022 y 2023).

    Si también administra el agente de infraestructura o las integraciones en el host (por ejemplo, nri-elasticsearch) a través de este mismo archivo de respositorio, es posible que yum check-update deje de mostrar nuevas versiones para ellos después de instalar o actualizar el agente de eBPF, porque el canal de vista previa contiene un conjunto de paquetes más pequeño y diferente.

    Para restaurar la ruta de actualización estándar para el agente de infraestructura y sus integraciones, vuelva a ejecutar el comando de configuración del respositorio para su sistema operativo desde Agregar el respositorio del agente de infraestructura (familia RHEL) o Amazon Linux, y luego actualice la caché de yum:

    bash
    $
    sudo yum clean all
    $
    sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'

    Esto no afecta a los hosts de Debian o Ubuntu, donde el agente de eBPF se instala desde un paquete .deb fuera de la lista de fuentes apt del agente de infraestructura.

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:

  1. Vaya a one.newrelic.com > APM & Services.
  2. En el banner de búsqueda, establezca el criterio de búsqueda como instrumentation.name = nr_ebpf: eBPF filter for eBPF data in New Relic OpenTelemetry UI

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

En los hosts basados en yum(familia RHEL y Amazon Linux), volver a ejecutar el comando de instalación también sobrescribe /etc/yum.repos.d/newrelic-infra.repo de nuevo. Si depende de ese archivo para mantener el agente de infraestructura o sus integraciones en el host actualizados mediante yum, repita los pasos de restauración del respositorio después de cada actualización del agente eBPF.

Para obtener el último comando de instalación:

  1. Vaya a one.newrelic.com > + Integration & Agents > eBPF Agent.

  2. Sigue el flujo de instalación para obtener el comando actualizado.

  3. Ejecute el comando en su host para actualizar el agente.

  4. 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.

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.

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.