OTel Collectorのインストール

15 minutes

このステップでは、Helmを使用してk3dクラスターにSplunk Distribution of the OpenTelemetry Collectorをデプロイします。Collectorは計装されたサービスからトレースとメトリクスを受信し、Splunk Observability Cloudに転送します。

注意

各アプリケーションPodはノードIPを介してCollectorにデータを送信します。

text 
Pod → http://$(NODE_IP):4318 → Splunk OTel Collector DaemonSet → Splunk O11y Cloud

Helmによるインストール

.env ファイルが設定されていることを確認し、プロジェクトルート [~/workshop/context-propagation] から以下を実行します。

bash 
make collector

検証チェックリスト

make collector が完了した後、以下のコマンドを実行します。

1. Helmリリースがインストールされていることを確認

bash 
helm list -n cosmic-shop

2. Collector Podが実行中であることを確認

bash 
kubectl -n cosmic-shop get pods -l 'app=splunk-otel-collector,component=otel-collector-agent'

3. Collectorログに認証エラーがないことを確認

bash 
kubectl -n cosmic-shop logs -l 'app=splunk-otel-collector,component=otel-collector-agent' --tail=30

Splunk Observability Cloudでクラスターを確認

  1. Splunk Observability Cloudを開きます
  2. Infrastructure → Kubernetes → Kubernetes Entities → Clusters に移動します
  3. クラスター名（cosmic-shop-cluster または .env の CLUSTER_NAME の値）を検索します

Collectorが起動してから数分以内にクラスターが表示されます。

cluster

トラブルシューティング

このステップで発生する可能性のある問題と推奨される対処方法を示します。

トラブルシューティングガイドを表示するにはここをクリック

問題1. Helmインストールが認証エラーで失敗する

.env の SPLUNK_ACCESS_TOKEN と SPLUNK_REALM が正しいこと、およびトークンにインジェスト権限があることを確認してください。

問題2. Infrastructureナビゲーターにクラスターが表示されない

2〜3分待ちます。Collector Podが実行中であることを確認し、ログにエクスポートエラーがないか確認してください。