Splunk4Ninjas Workshops

K8s に OpenTelemetry Collector をインストールする

15 minutes

ワークショップ パート 1 の振り返り

ワークショップのこの時点で、以下を完了しています

上記の手順をまだ完了していない場合は、ワークショップの残りの部分に進む前に、以下のコマンドを実行してください

bash 
cp /home/splunk/workshop/docker-k8s-otel/docker/Dockerfile /home/splunk/workshop/docker-k8s-otel/helloworld/
cp /home/splunk/workshop/docker-k8s-otel/docker/entrypoint.sh /home/splunk/workshop/docker-k8s-otel/helloworld/

重要 これらのファイルをコピーしたら、/home/splunk/workshop/docker-k8s-otel/helloworld/Dockerfile を エディタで開き、Dockerfile 内の $INSTANCE をインスタンス名に置き換えてください。 インスタンス名は echo $INSTANCE を実行して確認できます。

ワークショップ パート 2 の紹介

ワークショップの次のパートでは、アプリケーションを Kubernetes で実行したいため、 Kubernetes クラスターに Splunk ディストリビューションの OpenTelemetry Collector を デプロイする必要があります。

まず、いくつかの重要な用語を定義しましょう。

重要な用語

Kubernetes とは？

「Kubernetes は、コンテナ化されたワークロードやサービスを管理するための、ポータブルで拡張性のあるオープンソースプラットフォームであり、宣言的な設定と自動化の両方を促進します。」

出典https://kubernetes.io/docs/concepts/overview/

先ほどビルドしたアプリケーションの Docker イメージを、Dockerfile に小さな変更を加えた後、Kubernetes クラスターにデプロイします。

Helm とは？

Helm は Kubernetes のパッケージマネージャーです。

「最も複雑な Kubernetes アプリケーションでも、定義、インストール、アップグレードを支援します。」

出典https://helm.sh/

Helm を使用して、K8s クラスターに OpenTelemetry Collector をデプロイします。

Helm の利点

ホスト Collector のアンインストール

先に進む前に、Linux ホストに以前インストールした Collector を削除しましょう

bash 
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh;
sudo sh /tmp/splunk-otel-collector.sh --uninstall

Helm を使用して Collector をインストールする

製品内ウィザードではなく、コマンドラインを使用して独自の helm コマンドを作成し、Collector をインストールしましょう。

まず、helm リポジトリを追加する必要があります

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

リポジトリが最新であることを確認します

bash 
helm repo update

helm chart のデプロイを設定するために、/home/splunk ディレクトリに values.yaml という名前の新しいファイルを作成しましょう

bash 
# swith to the /home/splunk dir
cd /home/splunk
# create a values.yaml file in vi
vi values.yaml

以下のテキストを貼り付ける前に、‘i’ を押して vi のインサートモードに入ってください。

次に、以下の内容を貼り付けます

yaml 
logsEngine: otel
agent:
  config:
    receivers:
      hostmetrics:
        collection_interval: 10s
        root_path: /hostfs
        scrapers:
          cpu: null
          disk: null
          filesystem:
            exclude_mount_points:
              match_type: regexp
              mount_points:
              - /var/*
              - /snap/*
              - /boot/*
              - /boot
              - /opt/orbstack/*
              - /mnt/machines/*
              - /Users/*
          load: null
          memory: null
          network: null
          paging: null
          processes: null

vi で変更を保存するには、esc キーを押してコマンドモードに入り、:wq! と入力してから enter/return キーを押してください。

次のコマンドを使用して Collector をインストールできます

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

Collector が実行中であることを確認する

以下のコマンドで Collector が実行中かどうかを確認できます

bash 
kubectl get pods

K8s クラスターが O11y Cloud に表示されていることを確認する

Splunk Observability Cloud で、Infrastructure -> Kubernetes -> Kubernetes Clusters に移動し、 クラスター名（$INSTANCE-cluster）を検索してください

Kubernetes node

Last Modified ·