パート1：マシンにKubernetesクラスターをセットアップして監視する

このチュートリアルを進めるには、マシン上に Kubernetes 環境が必要です。チュートリアルの概要については、「チュートリアル：Kubernetes 上での Splunk Distribution of OpenTelemetry Collector の設定」を参照してください。

Kubernetes のデモ環境をセットアップする便利な方法は、Minikube、Podman、Helm を使用することです。それぞれのツールには、特定の目的があります。

  • Minikubeは、ローカルのKubernetesクラスターを作成します。

  • Podmanは、Kubernetesでコンテナを実行します。

  • Helmは、Kubernetesの設定を支援します。

注: Docker などのコンテナーランタイムをすでにインストールしている場合は、Podman は必要ありません。

以下の手順では、ホストのオペレーティングシステムに macOS を使用していることを前提としています。Homebrew パッケージマネージャも必要です。Homebrew がインストールされていない場合は、まず端末で次のコマンドを実行します。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

必要項目をインストールする

ターミナルセッションを開き、Homebrewを使用してMinikube、Helm、Podmanをインストールします：

brew install minikube helm podman

以下のコマンドを実行して、すべての必要項目がインストールされたことを確認します：

minikube version
# minikube version: v1.32.0
podman -v
# podman version 4.9.3
helm version
# version.BuildInfo{Version:"v3.14.2", ...}

ローカルのKubernetesクラスターを作成する

このチュートリアルで使用するローカルKubernetesクラスターを起動するには、以下のコマンドを実行します：

minikube start

5分後に、Minikubeが正常にクラスターを作成したことを伝える次のメッセージが表示されます：

Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default

新しく作成したクラスターをテストするには、以下のコマンドを実行します：

minikube dashboard

Kubernetes ダッシュボードが空の状態でブラウザに表示されるのは、コンテナー化されたアプリがまだデプロイされていないことを意味します。次の手順では、最初にコンテナー化されたアプリである Collector をクラスターにインストールします。

Splunk Distribution of OpenTelemetry Collectorをインストールする

チュートリアルの当パートを完了するための最後のステップは、Helmチャートを使ってSplunk Distribution of OpenTelemetry Collectorをインストールすることです。

以下のコマンドを実行して、Collector用のHelmチャートをインストールします：

helm repo add splunk-otel-collector-chart https://signalfx.github.io/splunk-otel-collector-chart
helm repo update
helm install --set="splunkObservability.accessToken=<access_token>,clusterName=splunkTutorial,splunkObservability.realm=<realm>,gateway.enabled=false,splunkObservability.profilingEnabled=true,environment=splunkTutorialEnv" --generate-name splunk-otel-collector-chart/splunk-otel-collector

インストールコマンドの <realm> と <access_token> は、自分のレルムとアクセストークンに置き換えてください。

注: また、Splunk Observability Cloud で「Collector ガイド付きセットアップ」を使用して、事前入力済みの Helm コマンドを生成することもできます。

Helmチャートのインストールが完了すると、以下のようなメッセージが表示されます：

NAME: splunk-otel-collector-1709226095
LAST DEPLOYED: Thu Feb 29 18:01:36 2024
NAMESPACE: default
STATUS: deployed
NOTES:
Splunk OpenTelemetry Collector is installed and configured to send data to Splunk Observability realm <realm>.

データがSplunk Observability Cloudに入ってきていることを確認する

Splunk Observability Cloud を開き、Infrastructure、Kubernetes、K8s nodes にアクセスして、ローカルの Kubernetes クラスターから来ているデータを確認します。 splunkTutorial クラスターのみを表示するようにフィルタを設定します。

次の画像は、デモ用 splunkTutorial クラスターからのデータを示しています：

Splunk Infrastructure MonitoringでのCollectorのメトリクス

次のステップ

これでチュートリアルの最初のパートは終了です。ローカルの Kubernetes クラスターを作成し、コンテナ化されたアプリとして Collector をデプロイしました。

次に、ログを Splunk Cloud Platform に送信するように設定を編集します。「パート 2：Collector の設定を編集して、ログをフィルタリングし Splunk Cloud Platform に送信する」に進んでください。

さらに詳しく

Collectorの設定の形式と構造の詳細については、以下のリソースを参照してください：