Installer et configurer l'intégration New Relic eBPF

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.

Compatibilité et exigences

• Versions du noyau Linux 5.4 et ultérieures.

• Privilèges root

• Prend en charge les architectures arm64 et x86-64.

• Un minimum de 2 GB de RAM est requis pour les installations de l'hôte.

• Prend en charge les distributions suivantes :

  • Ubuntu 20.04 et versions ultérieures
  • Debian 11 et versions ultérieures
  • CentOS Stream 9 et versions ultérieures
  • RHEL 8 et versions ultérieures

Installer l'agent eBPF

Pour installer l'agent eBPF :

1. connectez-vous à votre compte New Relic.

2. Accédez au volet de navigation de gauche > + Integration & Agents > eBPF Agent.

3. Sur l'écran Sélectionner un compte, sélectionnez le compte sur lequel vous souhaitez installer l'agent eBPF, puis cliquez sur Continuer.

4. Sur la page Sélectionner une méthode d’installation, sélectionnez On a host et cliquez sur Continue.

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

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

7. Sur l’écran Installer l’agent, exécutez la commande fournie dans votre terminal pour installer l’agent eBPF.

   1. Copiez et collez la commande affichée pour installer l'agent eBPF sur votre hôte.

   2. Pour vérifier l’installation, exécutez la commande suivante :

      • Pour l'agent eBPF :

        bash

        Copier

        $
        sudo systemctl status newrelic-ebpf-agent

      • Pour le client eBPF :

        bash

        Copier

        $
        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.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. Accédez à one.newrelic.com > APM & Services.
2. Dans la bannière de recherche, définissez les critères de recherche sur instrumentation.name = nr_ebpf:

Configurer le tableau de bord eBPF

Le dashboard réseau eBPF offre une visibilité approfondie sur la santé du réseau de votre système en suivant les métriques DNS et TCP critiques directement à partir du noyau. Vous pouvez diagnostiquer les problèmes de connectivité en analysant les taux de réussite et d’échec des résolutions DNS et des connexions TCP. Identifiez les goulots d'étranglement des performances en monitoring la latence des clés telles que les poignées de main TCP, la livraison des paquets et la durée des connexions de courte durée. Le dashboard vous aide également à suivre le débit de données en visualisant les octets envoyés, reçus et tous les paquets abandonnés.

Pour configurer le dashboard du réseau eBPF :

1. Accédez à one.newrelic.com > Dashboards.
2. Dans les Dashboards, cliquez sur + Create a dashboard.
3. Dans la fenêtre Create a dashboard, cliquez sur Browse pre-built dashboards.
4. Dans la barre de recherche, tapez eBPF et sélectionnez eBPF.
5. (Facultatif) Dans la fenêtre affichée, cliquez sur Edit pour modifier le compte.
6. Cliquez sur Setup eBPF Agent pour configurer la source de données ou cliquez sur Skip this step si l'agent eBPF est déjà configuré.
7. Cliquez sur View dashboard pour afficher les données collectées par l'agent 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. */

Paramètres de configuration

Le fichier newrelic-ebpf-agent.conf contient les paramètres de configuration suivants :