Dépanner eBPF sur Kubernetes

Problème

Vous rencontrez des problèmes avec l'agent eBPF dans votre environnement Kubernetes, tels que des limites de descripteurs de fichiers, des erreurs de privilèges ou des problèmes de performances.

Solution

Si vous rencontrez des erreurs de limite de descripteurs de fichiers, consultez notre guide de dépannage des limites de descripteurs de fichiers pour des étapes de résolution détaillées.

Problème

L'agent eBPF ne parvient pas à démarrer en raison de privilèges insuffisants.

Solution

1. Vérifiez que le DaemonSet de l'agent eBPF dispose des privilèges nécessaires. Le graphique Helm doit configurer automatiquement les autorisations requises.

2. Vérifiez le contexte de sécurité du pod dans votre déploiement :

   bash

   Copier

   $
   kubectl describe pod <ebpf-agent-pod> -n newrelic

3. Assurez-vous que votre cluster prend en charge eBPF. Vérifiez la version du noyau sur les nœuds :

   bash

   Copier

   $
   kubectl get nodes -o wide
   $
   # Kernel version should be 5.4 or later

Problème

L'agent eBPF consomme des ressources excessives ou entraîne une dégradation des performances.

Solution:

1. Monitorer l'utilisation des ressources :

   bash

   Copier

   $
   kubectl top pods -n newrelic

2. Ajustez les limites de mémoire dans vos valeurs Helm :

   agent:
   resources:
      limits:
         memory: "2Gi"  # Increase if needed
      requests:
         memory: "512Mi"

   Copier

3. Configurez le filtrage des données pour réduire la charge :

   dropDataForNamespaces: ["kube-system", "monitoring"]
   dropDataServiceNameRegex: "kube-dns|otel-collector"

   Copier

4. Limitez le monitoring des protocoles si tous les protocoles ne sont pas nécessaires :

   protocols:
   http:
      enabled: true
   mysql:
      enabled: false  # Disable if not needed

   Copier

Problème

Les pods de l'agent eBPF ne démarrent pas ou ne parviennent pas à envoyer de données.

Solution

1. Vérifiez l'état du pod :

   bash

   Copier

   $
   kubectl get pods -n newrelic
   $
   kubectl describe pod <ebpf-agent-pod> -n newrelic

2. Consultez les logs du pod :

   bash

   Copier

   $
   kubectl logs <ebpf-agent-pod> -n newrelic

3. Vérifiez la connectivité réseau :

   bash

   Copier

   $
   # Test from within the cluster
   $
   kubectl run test-connectivity --image=busybox --rm -it --restart=Never -- \
   >
   nslookup otlp.nr-data.net

4. Vérifiez le compte de service et RBAC :

   bash

   Copier

   $
   kubectl get serviceaccount -n newrelic
   $
   kubectl get clusterrole,clusterrolebinding -l app.kubernetes.io/name=nr-ebpf-agent

Problème

Les noms d'entités ne s'affichent pas correctement ou les données ne sont pas attribuées aux bons services.

Solution

• L'agent eBPF utilise les objets Kubernetes Service pour nommer les entités. Assurez-vous que vos applications ont un service correspondant défini.

  apiVersion: v1
  kind: Service
  metadata:
  name: my-service  # This becomes the entity name
  spec:
  selector:
     app: my-app

  Copier

• S'il vous manque des données, assurez-vous que l'espace de noms n'est pas exclu dans votre values.yaml.

  # In values.yaml
  dropDataForNamespaces: []  # Remove namespaces you want to monitor

  Copier

• Dans Kubernetes, les noms d'entités sont dérivés du nom du service Kubernetes, par exemple, mysql-database-service. Sur les hôtes ou dans Docker, les noms sont une combinaison du nom du processus, de son répertoire ou de l'ID du conteneur et du port d'écoute, par exemple, ruby:/home/ubuntu/app:[5678].

  Étapes de vérification

1. Vérifiez le log de démarrage réussi :

   bash

   Copier

   $
   kubectl logs <ebpf-agent-pod> -n newrelic | grep "STEP-7"

   Devrait afficher : [STEP-7] => Successfully started the eBPF Agent.

2. Vérifiez le flux de données dans New Relic :

   • Dans l'interface utilisateur de New Relic, recherchez les entités avec instrumentation.name = nr_ebpf.
   • Confirmez que les noms d'entités correspondent aux noms de vos services Kubernetes.

3. Testez la connectivité du point de terminaison OTLP :

   bash

   Copier

   $
   kubectl exec -it <ebpf-agent-pod> -n newrelic -- \
   >
   curl -v https://otlp.nr-data.net:443