Install the Collector for Kubernetes using Helm 🔗
You can install the Splunk Distribution of the OpenTelemetry Collector for Kubernetes using a Helm chart to define, install, and upgrade Kubernetes applications.
ヘルムチャートを使って次のことを行います:
Kubernetesクラスターの他のKubernetesオブジェクトと一緒にKubernetes DaemonSetを作成します。
Splunk Enterprise、Splunk Cloud Platform、Splunk Observability Cloud のメトリクス、トレース、ログデータの受信、処理、エクスポート。
To learn more about the Collector for Kubernetes Helm chart, see:
対応Kubernetesディストリビューション 🔗
Helmチャートは主要なKubernetesディストリビューションのデフォルト設定で動作します。アクティブにサポートされているバージョンを使用してください:
- Minikube。このディストリビューションはローカル開発者向けに作成されたもので、プロダクションでの使用は想定していません。
Minikubeは、過去のさまざまなバージョンのKubernetesをスピンアップするために作られました。
MinikubeのバージョンとKubernetesのバージョンは必ずしも一致していません。例えば、Minikube v1.27.1のリリースノート 、デフォルトのKubernetesバージョンはv1.25.2にバンプされたと記載されています。
このチャートは他の Kubernetes ディストリビューションでも動作するはずですが、デフォルトの values.yaml 設定ファイルは、追加の更新が必要になる可能性があります。
前提条件 🔗
チャートを使用するには、以下のリソースが必要です:
Helm 3 . Helm 2 is not supported. For more information on the version skew supported between Helm and Kubernetes see Helm Version Support Policy .
Kubernetesクラスターへの管理者アクセス。
前提条件:デスティネーション 🔗
Collector for Kubernetes には、デスティネーションが必要です:Splunk Enterprise または Splunk Cloud Platform ( splunkPlatform
) または Splunk Observability Cloud ( splunkObservability
) です。
宛先によっては次が必要です:
splunkPlatform
にデータを送信するには:Splunk Enterprise 8.0 以上。
ログデータを収集するための、最低 1つの Splunk プラットフォームインデックス。このインデックスはログの取り込みに使用されます。
HTTP Event Collector (HEC) トークンとエンドポイント。Set up and use HTTP Event Collector in Splunk Web および Scale HTTP Event Collector を参照してください。
splunkPlatform.endpoint
.Splunk インスタンスへの URL、例:"http://localhost:8088/services/collector"
。splunkPlatform.token
.Splunk HTTP Event Collector トークン。
splunkObservability
にデータを送信するには:splunkObservability.accessToken
。ご使用の Splunk Observability Cloud org アクセストークンとインジェスト認証スコープ。Splunk Observability Cloudを使用した組織のアクセストークンの作成および管理 を参照してください。splunkObservability.realm
.テレメトリデータを送信する Splunk レルム。デフォルトはus0
です。レルム を参照してください。
注釈
The Collector for Kubernetes uses main
as the default Splunk platform index. You can use annotations to send data to different indexes. See Send logs to different indexes for more information.
ヘルムチャートのデプロイ 🔗
以下のコマンドを実行して、Helmチャートをデプロイします:
Helmレポを追加します:
helm repo add splunk-otel-collector-chart https://signalfx.github.io/splunk-otel-collector-chart
デスティネーションを決めます。
Splunk Observability Cloudの場合:
helm install my-splunk-otel-collector --set="splunkObservability.realm=us0,splunkObservability.accessToken=xxxxxx,clusterName=my-cluster" splunk-otel-collector-chart/splunk-otel-collector
Splunk Enterprise または Splunk Cloud Platform の場合:
helm install my-splunk-otel-collector --set="splunkPlatform.endpoint=https://127.0.0.1:8088/services/collector,splunkPlatform.token=xxxxxx,splunkPlatform.metricsIndex=k8s-metrics,splunkPlatform.index=main,clusterName=my-cluster" splunk-otel-collector-chart/splunk-otel-collector
Splunk Observability Cloud と Splunk Enterprise または Splunk Cloud Platform の両方が対象です:
helm install my-splunk-otel-collector --set="splunkPlatform.endpoint=https://127.0.0.1:8088/services/collector,splunkPlatform.token=xxxxxx,splunkPlatform.metricsIndex=k8s-metrics,splunkPlatform.index=main,splunkObservability.realm=us0,splunkObservability.accessToken=xxxxxx,clusterName=my-cluster" splunk-otel-collector-chart/splunk-otel-collector
チャートをデプロイする名前空間を
-n
引数で指定します:helm -n otel install my-splunk-otel-collector -f values.yaml splunk-otel-collector-chart/splunk-otel-collector
注意
values.yaml ファイルには、Helm チャートでサポートされているすべての設定可能なパラメータと、各パラメータの詳細な説明が記載されています。:strong:` このチャートの設定方法を理解するために、このファイルを見てください`。
また、トレースサンプリングやプロキシサーバー経由のデータ送信など、さまざまなユースケースをサポートするようにHelmチャートを設定することもできます。詳しくは チャート設定の例 を参照してください。
その他のパラメータの設定 🔗
以下の設定が可能です:
例:
helm repo add splunk-otel-collector-chart https://signalfx.github.io/splunk-otel-collector-chart
helm install my-splunk-otel-collector --set="splunkRealm=us0,splunkAccessToken=xxxxxx,clusterName=my-cluster" --set=distribution={value},cloudProvider={value} splunk-otel-collector-chart/splunk-otel-collector
Helmで Collector for Kubernetes を設定する 、また Kubernetesの高度な設定 の詳細をお読みください。
その他のチャートのインストール例や、デフォルトの動作を変更するためのアップグレードコマンドについては、Helmチャート設定例 を参照してください。
WindowsワーカーノードでKubernetesクラスターを適用するには、
isWindows
をtrue
に設定します。ログについては、Collect logs and events with the Collector for Kubernetes を参照してください。
YAMLファイルを使ってHelmを設定する 🔗
YAMLファイルを使ってHelmの値を引数に設定することもできます。たとえば、my_values.yaml という名前の YAML ファイルを作成したら、次のコマンドを実行して Helm チャートをデプロイします:
helm install my-splunk-otel-collector --values my_values.yaml splunk-otel-collector-chart/splunk-otel-collector
Prometheus・メトリクスの設定 🔗
Helmチャートの値のYAMLにこのプロパティを追加することで、Prometheusを発するポッドを自動的にスクレイピングするようにCollectorを設定します:
autodetect:
prometheus: true
デプロイメント内のすべてのポッドのリソースファイルにこの設定を追加します:
metadata:
annotations:
prometheus.io/scrape: "true"
prometheus.io/path: /metrics
prometheus.io/port: "8080"
デプロイを確認する 🔗
If the chart is deployed successfully, the output displays a message informing that the Splunk Distribution of the OpenTelemetry Collector for Kubernetes is being deployed in your Kubernetes cluster, the last deployment date, and the status.
OpenTelemetryでKubernetes Operatorを使用する 🔗
Using the Splunk Helm chart, you can install the Splunk Collector along with an upstream OpenTelemetry Kubernetes Operator for Auto Instrumentation. For more information, see Automatic discovery and configuration for Kubernetes.
This instance of the Kubernetes Operator is part of the upstream OpenTelemetry Operator project. See the OpenTelemetry Operator documentation in GitHub for more information.
注釈
アップストリームの Kubernetes Operator は、Kubernetes インフラストラクチャに Splunk Enterprise デプロイメントをデプロイして運用するために使用する Splunk Operator for Kubernetes とは関係ありません。
次のステップ 🔗
After installing the package you can: