• /
  • 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

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.conf disponible sur /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf. Pour plus d'informations sur les paramètres configuration, reportez-vous à Paramètres de configuration.

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.

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