• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Installer l'agent New Relic eBPF pour Kubernetes

Vous pouvez installer l'agent New Relic eBPF sur votre cluster Kubernetes pour monitorer l'ensemble de la santé 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.

Installer 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 le cluster Kubernetes.

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 Kubernetes 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 Kubernetes :

    1. Saisissez le nom de déploiement pour Kubernetes.
    2. (Facultatif) Saisissez l'espace de nommage pour l'intégration. L'espace de nommage par défaut est newrelic.
    3. Cliquez sur Continue.

    Conseil

    Si vous choisissez un espace de nommage personnalisé pour votre instrumentation New Relic (au lieu de l'espace de nommage par défaut newrelic), nous vous recommandons d'exclure cet espace de nommage de monitoring en l'ajoutant au paramètre configuration dropDataForNamespaces. Cela empêche l'agent eBPF de monitoring lui-même le module d'instrumentation. Par exemple, si vous utilisez newrelic-mon comme espace de nommage, définissez : dropDataForNamespaces: ["kube-system", "newrelic-mon"].

  7. Sur l'écran Installer l'intégration Kubernetes :

    1. Copiez et collez la commande affichée pour installer l'agent eBPF sur votre cluster Kubernetes à l'aide de Helm.

    2. (Facultatif) Pour télécharger le fichier de configuration values.yaml, cliquez sur Download. Pour plus d'informations sur les paramètres de configuration, reportez-vous aux paramètres de configuration de K8.

    3. (Facultatif) Mettez à jour le fichier values.yaml si nécessaire et enregistrez-le.

    4. (Facultatif) Pour appliquer les modifications de configuration, exécutez la commande suivante :

      bash
      $
      helm repo update ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --values values.yaml
    5. Pour vérifier l’installation, exécutez la commande suivante :

      bash
      $
      kubectl get pods -n newrelic

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: eBPF filter for eBPF data in New Relic OpenTelemetry UI

/* Une fois votre application instrumentée et configurée pour exporter des données vers New Relic, vous devriez pouvoir trouver vos données dans l'interface utilisateur de New Relic : * Trouvez votre entité dans <DNT>**Toutes les entités > 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 dans un cluster Kubernetes :

  • Pour une mise à niveau standard: utilisez la commande Helm suivante pour passer à la dernière version :
bash
$
KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic
  • Pour une mise à niveau vers une version spécifique : Pour effectuer une mise à niveau vers une version spécifique, utilisez l’indicateur --version :
bash
$
KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic --version=0.2.5

Remplacez <key> par votre clé de licence New Relic et <cluster-name> par le nom de votre cluster.

Paramètres de configuration

Le fichier values.yaml contient les sections de configuration suivantes :

Désinstallez l'agent eBPF

Pour désinstaller l'agent eBPF de votre cluster Kubernetes :

bash
$
helm uninstall nr-ebpf-agent -n newrelic

Conseil

Cette commande supprimera tous les composants de l'agent eBPF de votre cluster. L'espace de nommage restera en place sauf si vous le supprimez explicitement.

Installation Linux eBPF

Découvrez comment configurer l'agent New Relic eBPF pour votre hôte Linux.

dépannage eBPF

Apprenez à résoudre les problèmes liés à l'agent New Relic eBPF.

eBPF bonnes pratiques

Découvrez les bonnes pratiques d'utilisation de l'agent New Relic eBPF.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.