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
Sur les hôtes basés sur
yum, cette commande d’installation écrase/etc/yum.repos.d/newrelic-infra.repode sorte qu’il pointe vers un canal yum de préversion utilisé pour récupérer le packagenewrelic-ebpf-agent. Cela remplace lebaseurlque 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-updatepeut 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
.deben dehors de la liste de sourcesaptde 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 :
- 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
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 :
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.