トラブルシューティング

New Relic Kubernetes OpenTelemetry Collector は堅牢で信頼性が高く設計されていますが、それでも問題が発生する可能性があります。このトラブルシューティングドキュメントでは、発生する可能性のある一般的な問題のトラブルシューティング手順について説明します。

Collectorポッドの一般的な問題

問題が発生しているコレクターポッドのログを確認します。次のコマンドを実行します:

bash

$kubectl logs <otel-pod-name> -n newrelic

トラブルシューティングの詳細なDEBUGレベルのログを有効にするには、 nr-k8s-otel-collector HelmチャートでverboseLog問題をtrueに設定します。

問題:メトリクスが収集されないか、 New Relicに送信されません。

トラブルシューティング:

スクレイプ設定の確認:コレクターの設定 ( extraConfigまたはdefault ) 内のprometheusレシーバー設定が正しいことを確認してください。
bash
```
$kubectl describe configmap prometheus-config -n monitoring
```
ポッドのアノテーションを確認する: Prometheus サービス検出を使用している場合は、アプリケーションポッドに正しいprometheus.io/scrape=trueアノテーションがあることを確認してください。
bash
```
$kubectl get pods --namespace=[your-namespace] --show-labels | grep 'prometheus.io/scrape=true'
```
ネットワーク接続をテストします。コレクターポッドがメトリクスエンドポイントに到達できることを確認します。
bash
```
$kubectl exec [prometheus-pod-name] -- curl <http://service:port>
```

問題:カスタム設定が正しく適用されません。

トラブルシューティング:

values.yamlを確認してください: values.yamlファイルのextraConfigセクションにタイプミスや誤ったインデントがないかどうかを再確認してください。
bash
```
$cat helm-charts/charts/nr-k8s-otel-collector/values.yaml | grep extraConfig
```
検証が適用されましたConfigMaps : Helm チャートはvalues.yamlからConfigMapsを生成します。結果のConfigMapを調べて、カスタム設定が存在することを確認します。
bash
```
$kubectl describe configmap [collector-configmap-name] -n monitoring
```

問題: OpenTelemetry コレクターポッドが初期化に失敗するか、繰り返しクラッシュします。

トラブルシューティング:

ポッドログを検査する:最も一般的な最初のステップです。構成ミスまたは依存関係の欠落を示す特定のエラーメッセージを探してください。
bash
```
$kubectl logs [collector-pod-name] --namespace=monitoring
```
環境変数の検証:必要な環境変数が正しく挿入されていることを確認します。
bash
```
$kubectl exec [collector-pod-name] -- env | grep -i [variable-name]
```

問題:コレクターが New Relic と通信したりデータを送信したりできません。

トラブルシューティング:

DNS 解決を確認する:コレクターポッドがサービス名または New Relic エンドポイントを解決できることを確認します。
bash
```
$kubectl exec [collector-pod-name] -- nslookup service-name
```
接続テストを実行する: 内部サービスまたは外部の New Relic エンドポイントへの接続をテストします。
bash
```
$kubectl exec [collector-pod-name] -- curl -I <http://service-name:port>
```
ネットワークポリシーを確認する: クラスターに厳格なネットワークポリシーがある場合は、OpenTelemetry Collector ポッドから内部サービスおよび外部の New Relic エンドポイントへのトラフィックが許可されていることを確認します。
bash
```
$kubectl describe networkpolicy -n [namespace]
```

のOpenTelemetry オブザーバビリティに問題がある場合は、以下を参照してください。Kubernetes

Collector を使用して、で Kubernetesクラスタを計装します。New RelicOpenTelemetry

でのOpenTelemetryCollector 設定をカスタマイズします。KubernetesNew Relic