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ディストリビューションのデフォルト設定で動作します。アクティブにサポートされているバージョンを使用してください：

Vanilla (未修正版) Kubernetes
Amazon Elastic Kubernetes Service
Azure Kubernetes Service
Google Kubernetes Engine
Red Hat OpenShift
Minikube。このディストリビューションはローカル開発者向けに作成されたもので、プロダクションでの使用は想定していません。
- Minikubeは、過去のさまざまなバージョンのKubernetesをスピンアップするために作られました。
- MinikubeのバージョンとKubernetesのバージョンは必ずしも一致していません。例えば、Minikube v1.27.1のリリースノート、デフォルトのKubernetesバージョンはv1.25.2にバンプされたと記載されています。

このチャートは他の Kubernetes ディストリビューションでも動作するはずですが、デフォルトの values.yaml 設定ファイルは、追加の更新が必要になる可能性があります。

前提条件 🔗

チャートを使用するには、以下のリソースが必要です：

Helm 3。Helm 2はサポートされていません。HelmとKubernetesの間でサポートされるバージョンスキューの詳細については、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 です。レルムを参照してください。

注釈

Collector for Kubernetesは、デフォルトのSplunkプラットフォームインデックスとして main を使用します。アノテーションを使用して、異なるインデックスにデータを送信できます。詳細は Send logs to different indexes を参照してください。

ヘルムチャートのデプロイ 🔗

以下のコマンドを実行して、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

See an example of a YAML file in GitHub .

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 zero-code instrumentation. For more information, see Automatic discovery 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:

このページは 2024年11月27日に最終更新されました。

Related Topics