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 :
connectez-vous à votre compte New Relic.
Allez à left navigation pane > + Integration & Agents > eBPF Agent.
Sur l'écran Select an account, sélectionnez le compte sur lequel vous souhaitez installer l'agent eBPF, puis cliquez sur Continue.
Sur la page Select an installation method, sélectionnez On a host et cliquez sur Continue.
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.
Sur l'écran Configure the host integration, saisissez le nom de déploiement de l'hôte, puis cliquez sur Continue.
Sur l'écran Install the agent, exécutez la commande fournie dans votre terminal pour installer l'agent eBPF via le paquet Debian.
Copiez et collez la commande affichée pour installer l'agent eBPF sur votre hôte Debian.
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.yamldisponible 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
On
yum-based hosts, this installation command overwrites/etc/yum.repos.d/newrelic-infra.reposo that it points to a preview yum channel used to fetch thenewrelic-ebpf-agentpackage. This replaces thebaseurlthat the infrastructure agent's own repository file normally uses, and affects RHEL-family hosts (RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux) as well as Amazon Linux (2, 2022, and 2023).If you also manage the infrastructure agent or on-host integrations (for example
nri-elasticsearch) through this same repository file,yum check-updatemay stop showing new versions for them after installing or upgrading the eBPF agent, because the preview channel carries a smaller, different package set.To restore the standard update path for the infrastructure agent and its integrations, re-run the repository setup command for your OS from Add the infrastructure agent repository (RHEL-family) or Amazon Linux, then refresh the yum cache:
bash$sudo yum clean all$sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'This doesn't affect Debian or Ubuntu hosts, where the eBPF agent is installed from a
.debpackage outside of the infrastructure agent'saptsource list.
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 :
- Allez à one.newrelic.com > APM & Services.
- Dans la bannière de recherche, définissez les critères de recherche sur
instrumentation.name = nr_ebpf:
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
On yum-based hosts (RHEL-family and Amazon Linux), re-running the installation command also overwrites /etc/yum.repos.d/newrelic-infra.repo again. If you rely on that file to keep the infrastructure agent or its on-host integrations updated via yum, repeat the repository restore steps after each eBPF agent upgrade.
Pour obtenir la dernière commande d'installation :
Allez à one.newrelic.com > + Integration & Agents > eBPF Agent.
Suivez le processus d'installation pour obtenir la commande mise à jour.
Exécutez la commande sur votre hôte pour mettre à niveau l'agent.
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]oujava: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_NAMEpour 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 :
$sudo apt-get purge newrelic-ebpf-agentConseil
Il n'est pas nécessaire d'arrêter le service avant d'exécuter la commande de désinstallation.