Kubernetes 上の eBPF のトラブルシューティング

問題

ファイル記述子の制限、権限エラー、パフォーマンスの問題など、Kubernetes 環境の eBPF エージェントで問題が発生しています。

解決

ファイル記述子制限エラーが発生した場合は、詳細な解決手順については、専用のファイル記述子制限トラブルシューティング ガイドを参照してください。

問題

権限が不十分なため、eBPF エージェントの起動に失敗します。

解決

1. eBPF エージェント DaemonSet に必要な権限があることを確認します。Helm チャートは必要な権限を自動的に構成する必要があります。

2. デプロイメント内のポッド セキュリティ コンテキストを確認します。

   bash

   コピー

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

3. クラスターが eBPF をサポートしていることを確認します。ノード上のカーネル バージョンを確認します。

   bash

   コピー

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

問題

eBPF エージェントが過剰なリソースを消費したり、パフォーマンスの低下を引き起こしたりします。

解決：

1. リソースの使用状況を監視します:

   bash

   コピー

   $
   kubectl top pods -n newrelic

2. Helm 値のメモリ制限を調整します。

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

   コピー

3. 負荷を軽減するためにデータ フィルタリングを構成します。

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

   コピー

4. すべてのプロトコルが必要でない場合は、プロトコルの監視を制限します。

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

   コピー

問題

eBPF エージェント ポッドが起動しないか、データを送信できません。

解決

1. ポッドのステータスを確認します。

   bash

   コピー

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

2. ポッドログを確認します。

   bash

   コピー

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

3. ネットワーク接続を確認します。

   bash

   コピー

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

4. サービス アカウントと RBAC を確認します。

   bash

   コピー

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

問題

エンティティ名が正しく表示されないか、データが正しいサービスに属していません。

解決

• eBPF エージェントは、Kubernetes Serviceオブジェクトを使用してエンティティに名前を付けます。アプリケーションに対応するサービスが定義されていることを確認します。

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

  コピー

• データが欠落している場合は、ネームスペースがvalues.yamlで除外されていないことを確認してください。

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

  コピー

• Kubernetes では、エンティティ名は Kubernetes サービス名から派生されます (例: mysql-database-service )。ホストまたは Docker では、名前はプロセス名、そのディレクトリまたはコンテナ ID、およびリスニング ポートの組み合わせになります (例: ruby:/home/ubuntu/app:[5678] )。

  検証手順

1. 起動成功ログを確認します:

   bash

   コピー

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

   表示される内容: [STEP-7] => Successfully started the eBPF Agent.

2. New Relic でデータフローを検証します。

   • New Relic UI で、 instrumentation.name = nr_ebpfを持つエンティティを探します。
   • エンティティ名が Kubernetes サービス名と一致していることを確認します。

3. OTLP エンドポイントの接続をテストします。

   bash

   コピー

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