Kubernetes への OpenTelemetry Collector のデプロイ

15 minutes

1. Helm を使用したインストール

Splunk Helm chart を使用して OpenTelemetry Collector をインストールします。まず、Splunk Helm chart リポジトリを Helm に追加して更新します

bash
helm repo add splunk-otel-collector-chart https://signalfx.github.io/splunk-otel-collector-chart && helm repo update

以下のコマンドで OpenTelemetry Collector Helm chart をインストールします。このコマンドは編集しないでください

bash
helm install splunk-otel-collector --version 0.136.0 \
--set="splunkObservability.realm=$REALM" \
--set="splunkObservability.accessToken=$ACCESS_TOKEN" \
--set="clusterName=$INSTANCE-k3s-cluster" \
--set="logsEngine=otel" \
--set="splunkObservability.profilingEnabled=true" \
--set="environment=$INSTANCE-workshop" \
--set="splunkPlatform.endpoint=$HEC_URL" \
--set="splunkPlatform.token=$HEC_TOKEN" \
--set="splunkPlatform.index=splunk4rookies-workshop" \
splunk-otel-collector-chart/splunk-otel-collector \
-f ~/workshop/k3s/otel-collector.yaml

kubectl get pods を実行してデプロイの進行状況を監視できます。通常、約30秒後に新しい Pod が起動して実行中と表示されます。

続行する前に、ステータスが Running と表示されていることを確認してください。

bash
kubectl get pods

OpenTelemetry Collector Pod のログを確認して、エラーがないことを確認します。出力は以下の Output タブに表示されているログ出力と同様になるはずです。

helm インストールで設定されたラベルを使用してログを確認します(終了するには ctrl+c を押す必要があります)。または、インストール済みの k9s ターミナル UI を使用してみましょう!

bash
kubectl logs -l app=splunk-otel-collector -f --container otel-collector

インストールに失敗した場合の削除

OpenTelemetry Collector のインストールでエラーが発生した場合は、以下のコマンドでインストールを削除してやり直すことができます

sh
helm delete splunk-otel-collector

2. UI でメトリクスを検証する

Splunk UI で、左下の » をクリックし、Infrastructure をクリックします。

Selecting the Kubernetes Navigator Map

Containers の下にある Kubernetes をクリックして Kubernetes Navigator Cluster Map を開き、メトリクスが送信されていることを確認します。

クラスターが検出され、報告されていることを確認します(ワークショップでは他の多くのクラスターも表示されます)。クラスター名を確認するには、以下のコマンドを実行して出力をクリップボードにコピーしてください

bash
echo $INSTANCE-k3s-cluster

次に、UI で Splunk ロゴのすぐ下にある「Cluster: - 」メニューをクリックし、コピーしたクラスター名を検索ボックスに貼り付け、ボックスをクリックしてクラスターを選択し、最後にメニューの外の空白部分をクリックしてフィルターを適用します。

K8S Clusters Filter

Select K8S Cluster

Filtered K8S Cluster

ノードの状態を確認するには、クラスターの薄い青色の背景にカーソルを合わせ、左上隅に表示される青い虫眼鏡

Magnifying Glass
をクリックします。

これによりノードレベルにドリルダウンします。次に、サイドバーボタンをクリックして Metrics サイドバーを開きます。

サイドバーが開いたら、スライダーを使用してクラスター/ノードに関連するさまざまなチャート(CPU、Memory、Network、Events など)を確認できます。

Sidebar metrics