パート1:マシンにKubernetesクラスターをセットアップして監視する 🔗
このチュートリアルを進めるには、マシン上にKubernetes環境が必要です。チュートリアルの概要については、Tutorial: Configure the Splunk Distribution of the OpenTelemetry Collector on Kubernetes を参照してください。
Kubernetesのデモ環境をセットアップする便利な方法は、Minikube、Podman、Helmを使用することです。それぞれのツールには特定の目的があります:
Minikube creates a local Kubernetes cluster.
Podman runs containers in Kubernetes.
Helm helps configure Kubernetes.
注釈
Dockerなどのコンテナランタイムをすでにインストールしている場合は、Podmanは必要ありません。
以下の手順は、ホストオペレーティングシステムとしてmacOSを使用していることを前提としています。また、Homebrewパッケージ・マネージャーが必要です。Homebrewがインストールされていない場合は、まずターミナルで以下のコマンドを実行してください:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install the requirements 🔗
ターミナルセッションを開き、Homebrewを使用してMinikube、Helm、Podmanをインストールします:
brew install minikube helm podman
Check that you installed all the requirements by running the following commands:
minikube version
# minikube version: v1.32.0
podman -v
# podman version 4.9.3
helm version
# version.BuildInfo{Version:"v3.14.2", ...}
Create a local Kubernetes cluster 🔗
To start the local Kubernetes cluster to use in this tutorial, run the following command:
minikube start
5分後に、Minikubeが正常にクラスターを作成したことを伝える次のメッセージが表示されます:
Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default
To test your newly created cluster, run the following command:
minikube dashboard
Kubernetesダッシュボードが空の状態でブラウザに表示されるのは、コンテナ化されたアプリがまだデプロイされていないことを意味します。次のステップでは、最初のコンテナ化されたアプリであるCollectorをクラスターにインストールします。
Install the Splunk Distribution of OpenTelemetry Collector 🔗
To complete this part of the tutorial, the last step consists in installing the Splunk Distribution of OpenTelemetry Collector using the Helm chart.
Run the following commands to install the Helm chart for the Collector:
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を使用したユーザー APIアクセストークンの取得と管理 を参照してください。
To find your Splunk Observability Cloud realm, see Note about realms.
注釈
また、Splunk Observability Cloudで Collectorガイド付きセットアップ を使用して、事前入力済みのHelmコマンドを生成することもできます。
After successfully installing the Helm chart, messages similar to the following appear:
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>.
Check that data is coming into Splunk Observability Cloud 🔗
Splunk Observability Cloudを開き、Infrastructure、Kubernetes、K8s nodes にアクセスして、ローカルのKubernetesクラスターから来ているデータを確認します。splunkTutorial
クラスターのみを表示するようにフィルターリングします。
The following image shows data coming from the demo splunkTutorial
cluster:
Next step 🔗
これでチュートリアルの最初のパートは完了です。ローカルのKubernetesクラスターを作成し、コンテナ化されたアプリとしてCollectorをデプロイしました。
次は、設定を編集して、ログをSplunk Cloud Platformに送信します。Part 2: Edit the Collector configuration to filter and send logs to Splunk Cloud Platform に進んでください。
さらに詳しく 🔗
To learn more about the Collector configuration format and structure, see the following resources: