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.
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 le cluster Kubernetes.
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 Kubernetes 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 Kubernetes integration :
- Saisissez le nom de déploiement pour Kubernetes.
- (Facultatif) Saisissez l'espace de nommage pour l'intégration. L'espace de nommage par défaut est
newrelic. - 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 configurationdropDataForNamespaces. Cela empêche l'agent eBPF de monitoring lui-même le module d'instrumentation. Par exemple, si vous utiliseznewrelic-moncomme espace de nommage, définissez :dropDataForNamespaces: ["kube-system", "newrelic-mon"].Sur l'écran Install the Kubernetes integration :
Copiez et collez la commande affichée pour installer l'agent eBPF sur votre cluster Kubernetes à l'aide de Helm.
(Facultatif) Pour télécharger le fichier de configuration
values.yaml, cliquez sur Download. Pour en savoir plus sur les paramètres de configuration, consultez les paramètres de configuration K8s.(Facultatif) Mettez à jour le fichier
values.yamlselon vos besoins et enregistrez-le.(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.yamlPour 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 :
- 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 dans un cluster Kubernetes :
- Pour une mise à niveau standard: utilisez la commande Helm suivante pour passer à la dernière version :
$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:
$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.5Remplacez <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 :
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 de votre cluster Kubernetes :
$helm uninstall nr-ebpf-agent -n newrelicConseil
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.