• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Installer l'agent New Relic eBPF pour les hôtes Linux

|View as Markdown (English)

Vous pouvez installer l'agent New Relic eBPF sur votre hôte Linux pour monitorer l'état de santé de l'ensemble de votre système. L'agent eBPF offre une visibilité approfondie sur les performances des applications sans nécessiter de modifications de code ni de déploiement d'agents spécifiques au langage.

Installez l'agent New Relic eBPF

Avant de commencer

Vous devez satisfaire aux prérequis décrits dans la documentation relative à la compatibilité et aux exigences eBPF pour les hôtes Linux.

Installer l'agent eBPF

Pour installer l'agent eBPF :

  1. connectez-vous à votre compte New Relic.

  2. Allez à left navigation pane > + Integration & Agents > eBPF Agent.

  3. Sur l'écran Select an account, sélectionnez le compte sur lequel vous souhaitez installer l'agent eBPF, puis cliquez sur Continue.

  4. Sur la page Select an installation method, sélectionnez On a host et cliquez sur Continue.

  5. Sur l'écran Enter your user key, sélectionnez l'une des options suivantes, puis cliquez sur Continue:

    • Use an existing key: Si vous avez déjà une clé utilisateur, fournissez la clé utilisateur. Pour plus d'informations, consultez Clés utilisateur.
    • Create a new key: Si vous n'avez pas de clé utilisateur, cliquez sur Create a new key pour en créer une.
  6. Sur l'écran Configure the host integration, saisissez le nom de déploiement de l'hôte, puis cliquez sur Continue.

  7. Sur l'écran Install the agent, exécutez la commande fournie dans votre terminal pour installer l'agent eBPF via le paquet Debian.

    1. Copiez et collez la commande affichée pour installer l'agent eBPF sur votre hôte Debian.

    2. Pour vérifier l’installation, exécutez la commande suivante :

      bash
      $
      sudo systemctl status newrelic-ebpf-agent

    Une fois l'installation réussie, l'état de ces services s'affiche comme actif (en cours d'exécution).

    Conseil

    Vous pouvez personnaliser la configuration de l'agent eBPF en modifiant le fichier newrelic-ebpf-agent.yaml disponible sur /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.yaml. Pour plus d'informations sur les paramètres configuration, reportez-vous à Paramètres de configuration.

    Important

    Sur les hôtes basés sur yum, cette commande d’installation écrase /etc/yum.repos.d/newrelic-infra.repo de sorte qu’il pointe vers un canal yum de préversion utilisé pour récupérer le package newrelic-ebpf-agent. Cela remplace le baseurl que le fichier de référentiel propre à l’agent d’infrastructure utilise normalement, et affecte les hôtes de la famille RHEL (RHEL, CentOS, Rocky Linux, AlmaLinux, et Oracle Linux) ainsi qu’Amazon Linux (2, 2022, et 2023).

    Si vous gérez également l’ agent d’infrastructure ou les intégrations sur hôte (par exemple nri-elasticsearch) via ce même fichier de référentiel, yum check-update peut cesser d’afficher de nouvelles versions pour ces éléments après l’installation ou la mise à niveau de l’agent eBPF, car le canal de préversion contient un ensemble de packages plus petit et différent.

    Pour restaurer le chemin de mise à jour standard de l’agent d’infrastructure et de ses intégrations, réexécutez la commande de configuration du référentiel pour votre OS à partir de Ajouter le référentiel de l’agent d’infrastructure (famille RHEL) ou Amazon Linux, puis actualisez le cache yum :

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

    Cela n’affecte pas les hôtes Debian ou Ubuntu, où l’agent eBPF est installé à partir d’un package .deb en dehors de la liste de sources apt de l’agent d’infrastructure.

Accéder aux données eBPF dans New Relic

Une fois l'agent eBPF installé, il commence automatiquement à collecter les données de votre hôte Linux. Vous pouvez accéder à ces données dans l'interface utilisateur OpenTelemetry de New Relic. Pour plus d'informations sur l'interface utilisateur New Relic OpenTelemetry, reportez-vous à l'interface utilisateur OpenTelemetry APM.

Pour afficher les données eBPF dans New Relic :

  1. Allez à one.newrelic.com > APM & Services.
  2. Dans la bannière de recherche, définissez les critères de recherche sur instrumentation.name = nr_ebpf: eBPF filter for eBPF data in New Relic OpenTelemetry UI

Mettre à niveau l'agent eBPF

Pour mettre à niveau l'agent eBPF sur un hôte Linux, réexécutez la commande d'installation depuis l'interface utilisateur de New Relic. Ce processus installera la nouvelle version de l'agent tout en supprimant automatiquement l'ancienne.

Important

La mise à niveau via un gestionnaire de paquets n'est pas prise en charge. Pour une mise à niveau réussie, vous devez utiliser la commande d'installation de l'interface utilisateur de New Relic.

Important

Sur les hôtes basés sur yum(famille RHEL et Amazon Linux), la réexécution de la commande d’installation écrase également /etc/yum.repos.d/newrelic-infra.repo à nouveau. Si vous comptez sur ce fichier pour maintenir l’agent d’infrastructure ou ses intégrations sur hôte à jour via yum, répétez les étapes de restauration du référentiel après chaque mise à niveau de l’agent eBPF.

Pour obtenir la dernière commande d'installation :

  1. Allez à one.newrelic.com > + Integration & Agents > eBPF Agent.

  2. Suivez le processus d'installation pour obtenir la commande mise à jour.

  3. Exécutez la commande sur votre hôte pour mettre à niveau l'agent.

  4. Redémarrez le service de l'agent ebpf en utilisant la commande ci-dessous :

    bash
    $
    sudo systemctl restart newrelic-ebpf-agent

Paramètres de configuration

Le fichier newrelic-ebpf-agent.yaml contient les paramètres de configuration suivants :

Conseil

L'agent eBPF génère automatiquement des noms d'entités différemment selon l'environnement :

  • Dans les hôtes ou Docker, ces noms sont une combinaison du nom du processus, de son répertoire ou de son ID de conteneur et du port d'écoute. Par exemple, ruby:/home/ubuntu/app:[5678] ou java:f4aead533895:[8080].

  • Dans Kubernetes, ces noms sont dérivés du nom du service, par exemple, mysql-database-service.

    Attribution d'un nom personnalisé aux applications :

  • Vous pouvez attribuer un nom personnalisé à votre application en définissant la variable d'environnement NEW_RELIC_APP_NAME pour les applications Kubernetes et sur l'hôte.

Désinstallez l'agent eBPF

Pour désinstaller l'agent eBPF d'un hôte Linux, utilisez les outils de gestion package de votre système :

bash
$
sudo apt-get purge newrelic-ebpf-agent

Conseil

Il n'est pas nécessaire d'arrêter le service avant d'exécuter la commande de désinstallation.

Installation eBPF Kubernetes

Découvrez comment configurer l'agent New Relic eBPF pour votre cluster Kubernetes.

dépannage eBPF

Apprenez à résoudre les problèmes liés à l'agent New Relic eBPF.

eBPF bonnes pratiques

Découvrez les bonnes pratiques d'utilisation de l'agent New Relic eBPF.

Droits d'auteur © 2026 New Relic Inc.

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