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