前提条件

設定を指定するには、Splunk レルムとbase64エンコードされたアクセストークンを知っている必要があります。

設定ファイルには複数のリソースマニフェストを含めることができます。各マニフェストは Kubernetes オブジェクトに特定の状態を適用します。マニフェストは Splunk Observability Cloud 専用に設定する必要があり、エージェントのすべてのテレメトリタイプが有効になっている必要があります。Helm チャートを使用してインストールする場合、これがデフォルトです。

使用するマニフェストを決定する

examples リポジトリから必要なマニフェストファイルをダウンロードしてください。各例の詳細については、README ファイルを参照してください。

使用する Collector のデプロイメントモード（エージェントまたはゲートウェイ）を決定します。デフォルトでは、ホストモニタリング（エージェント）モードは、データを Splunk SaaS エンドポイントに直接送信するように設定されています。ホストモニタリング（エージェント）モードを再設定して、ゲートウェイに送信できます。

マニフェストを更新する

どのマニフェストが目的に適しているか決定したら、以下の更新を行います。

1. secret.yaml マニフェストで、splunk_observability_access_token データフィールドを base64 エンコードされたアクセストークンで更新します。

2. 使用する configmap-agent.yaml、configmap-gateway.yaml、および configmap-cluster-receiver.yaml マニフェストファイルを更新します。"CHANGEME" を検索して、レンダリングされたマニフェストを直接使用するために更新する必要がある値を探します。

   1. エクスポーター設定の「CHANGEME」を Splunk レルムの値に更新する必要があります。

   2. 属性プロセッサーのコンフィギュレーションの「CHANGEME」をクラスター名の値に更新する必要があります。

マニフェストを適用する

それらを更新したら、次の例に示すように、kubectl を使用してマニフェストを適用します。

ホストモニタリング（エージェント）モードの場合は、トークン、レルム情報、およびクラスター名で更新された後、kubectl apply コマンドを使用して適用できる事前レンダリングされた Kubernetes リソースマニフェストのために、GitHub 上のエージェント専用マニフェストディレクトリをダウンロードします。

kubectl apply -f <agent-manifest-directory> --recursive

データ転送（ゲートウェイ）モードの場合は、トークン、レルム情報、およびクラスター名で更新された後、kubectl apply コマンドを使用して適用できる事前レンダリングされた Kubernetes リソースマニフェストのために、GitHub 上のゲートウェイ専用マニフェストディレクトリをダウンロードします。

kubectl apply -f <gateway-manifest-directory> --recursive

テンプレートを使用する

helm template コマンドを使用して、パラメータをカスタマイズした独自のマニフェスト YAML ファイルを作成できます。

helm template --namespace default --set cloudProvider='aws' --set distribution='openshift' --set splunkObservability.accessToken='KUwtoXXXXXXXX' --set clusterName='my-openshift-EKS-dev-cluster' --set splunkObservability.realm='us1' --set gateway.enabled='false' --output-dir <rendered_manifests_dir> --generate-name splunk-otel-collector-chart/splunk-otel-collector

お望みなら、values.yamlファイルを先に更新することもできます。

helm template --namespace default --values values.yaml --output-dir <rendered_manifests_dir> --generate-name splunk-otel-collector-chart/splunk-otel-collector

マニフェスト・ファイルは、指定したフォルダ <rendered_manifests_dir> に作成されます。

マニフェストの例

セキュリティ制約を設定するには、次のマニフェストを参照してください：

次のステップ

Collectorをインストールしたら、次のことができます：

• Helmで Collector for Kubernetes を設定する

• Kubernetesの高度な設定

• Collector for Kubernetes のログとイベントを収集する

• Collector for Kubernetesの一般的なトラブルシューティング

• Splunk APMのセットアップ