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.
Accédez au volet de navigation de gauche > + Integration & Agents > eBPF Agent.
Sur l'écran Sélectionner un compte, sélectionnez le compte sur lequel vous souhaitez installer l'agent eBPF, puis cliquez sur Continuer.
Sur la page Sélectionner une méthode d’installation, sélectionnez On a host et cliquez sur Continue.
Sur l'écran Saisissez votre clé utilisateur, sélectionnez l'une des options suivantes, puis cliquez sur Continue:
- Utiliser une clé existante: Si vous disposez déjà d’une clé utilisateur, fournissez la clé utilisateur. Pour plus d'informations, reportez-vous à Clés utilisateur.
- Créer une nouvelle clé: Si vous n’avez pas de clé utilisateur, cliquez sur Create a new key pour en créer une.
Sur l’écran Configurer l’intégration de l’hôte, entrez le nom de déploiement de l’hôte, puis cliquez sur Continue.
Sur l'écran « Installer l'agent », exécutez la commande fournie dans votre terminal pour installer l'agent eBPF via package 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 :
Pour l'agent eBPF :
bash$sudo systemctl status newrelic-ebpf-agentPour le client eBPF :
bash$sudo systemctl status newrelic-ebpf-agent-client
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.confdisponible 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 :
- Accédez à one.newrelic.com > APM & Services.
- Dans la bannière de recherche, définissez les critères de recherche sur
instrumentation.name = nr_ebpf:
/* * Trouvez votre entité sur <DNT>**Toute entité > Services - OpenTelemetry</DNT>. Le nom de l'entité est défini sur la valeur du « service.name » de l'application attribut de ressource. Pour plus d'informations sur la façon dont les entités de service New Relic sont dérivées de l'attribut de ressource OpenTelemetry, voir [Services](/docs/OpenTelemetry/bonnes pratiques/OpenTelemetry-bonnes pratiques-resources/#services). * Utilisez [NRQL](/docs/NRQL/get-started/introduction-NRQL (langage de requête New Relic)/) pour effectuer une requête directement pour [trace](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gU3BhbiBTRUxFQ1QgY291bnQoKikgd2hlcmU gbmV3cmVsaWMuc291cmNlPSclb3RscCUnIFRJTUVTRVJJRVMifV0sImluaXRpYWxDaGFydFNldHRpbmdzIjp7ImNoYXJ0VHlwZSI6IkNIQVJUX0xJTkUiLCJsaW1pdCI6NzU0MiwibGlua2VkRW50aXR5R3VpZCI6bnVsbCwibGlua2VkRGFzaGJvYXJkSWQiOm51bGwsInlTY2FsZSI6eyJzdGF0aWMiOmZhbHNlLCJkb21haW4iOltudWxsLG51bGxdfSwieVplcm8iOnRydWV9fQo=), [métriques](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTWV0cmljIFNFTEVDVCBjb3VudCgqKSB3aGVyZS BuZXdyZWxpYy5zb3VyY2UgTElLRSAnJW90bHAlJyBUSU1FU0VSSUVTIn1dLCJpbml0aWFsQ2hhcnRTZXR0aW5ncyI6eyJjaGFydFR5cGUiOiJDSEFSVF9MSU5FIiwibGltaXQiOjc1NDIsImxpbmtlZEVudGl0eUd1aWQiOm51bGwsImxpbmtlZERhc2hib2FyZElkIjpudWxsLCJ5U2NhbGUiOnsic3RhdGljIjpmYWxzZSwiZG9tYWluIjpbbnVsbCxudWxsXX0sInlaZXJvIjp0cnVlfX0K), et [logs](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTG9nIFNFTEVDVCBjb3VudCgqKSB3aGVyZSBu ZXdyZWxpYy5zb3VyY2U9JyVvdGxwJScgVElNRVNFUklFUyJ9XSwiaW5pdGlhbENoYXJ0U2V0dGluZ3MiOnsiY2hhcnRUeXBlIjoiQ0hBUlRfTElORSIsImxpbWl0Ijo3NTQyLCJsaW5rZWRFbnRpdHlHdWlkIjpudWxsLCJsaW5rZWREYXNoYm9hcmRJZCI6bnVsbCwieVNjYWxlIjp7InN0YXRpYyI6ZmFsc2UsImRvbWFpbiI6W251bGwsbnVsbF19LCJ5WmVybyI6dHJ1ZX19Cg==). * Voir [OpenTelemetry APM UI](/docs/OpenTelemetry/get-started/apm-monitoring/OpenTelemetry-apm-ui) pour plus d'informations. Si vous ne trouvez pas votre entité et ne voyez pas vos données avec NRQL, voir [OTLP dépannage](/docs/OpenTelemetry/bonnes pratiques/OpenTelemetry-otlp-dépannage). Vous pouvez trouver les données collectées par l'agent eBPF dans l'interface utilisateur New Relic Opentelementry. */
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 :
- Rendez-vous sur one.newrelic.com > + Integration & Agents > eBPF Agent
- Suivez la procédure d'installation pour obtenir la commande mise à jour
- Exécutez la commande sur votre hôte pour mettre à niveau l'agent
Paramètres de configuration
Le fichier newrelic-ebpf-agent.conf contient les paramètres de configuration suivants :
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 remove newrelic-ebpf-agentConseil
Il n'est pas nécessaire d'arrêter le service avant d'exécuter la commande de désinstallation.