Step 2: Deploy a supported OpenTelemetry Collector

Context

Deploy a supported OpenTelemetry collector if you haven't already, and upgrade it to a supported version.

Supported OpenTelemetry collectors

The following minimum versions are required for Secure Application functionality:

• Splunk Distribution of OpenTelemetry 1.40.0 and later. If you deploy the Splunk Distribution of OpenTelemetry Collector on Kubernetes with Helm, use Helm chart splunk-otel-collector-0.137.0 and later.

• Community (upstream) OpenTelemetry collector

Easiest deployment option

The easiest option is to deploy the Splunk Distribution of OpenTelemetry Collector on Kubernetes with Helm chart version splunk-otel-collector-0.137.0 or above. This Helm chart is preconfigured with everything you need for Secure Application.

1. Add the Helm repository:

   SHELLCopy

   helm repo add splunk-otel-collector-chart https://signalfx.github.io/splunk-otel-collector-chart

   helm repo add splunk-otel-collector-chart https://signalfx.github.io/splunk-otel-collector-chart

2. Ensure the repository is up to date:

   SHELLCopy

   helm repo update

   helm repo update

3. Install the collector, with splunkObservability.secureAppEnabled set to true on the helm install command:

   Install collector with zero-code instrumentation

   As of version 0.154.0, for easiest setup, you can use zero-code instrumentation with Secure Application enabled:

   SHELLCopy

   helm install my-splunk-otel-collector --set="splunkObservability.secureAppEnabled=true,splunkObservability.realm=<your-splunk-realm>,splunkObservability.accessToken=<your-access-token>,clusterName=<your-cluster-name>" splunk-otel-collector-chart/splunk-otel-collector

   helm install my-splunk-otel-collector --set="splunkObservability.secureAppEnabled=true,splunkObservability.realm=<your-splunk-realm>,splunkObservability.accessToken=<your-access-token>,clusterName=<your-cluster-name>" splunk-otel-collector-chart/splunk-otel-collector

   Skip Step 3: Instrument your application for Secure Application.

   Install collector and instrumentation agents separately

   As of version 0.137.0, you can install the collector with splunkObservability.secureAppEnabled set to true on the helm install command:

   SHELLCopy

   helm install my-splunk-otel-collector --set="splunkObservability.secureAppEnabled=true,splunkObservability.realm=<your-splunk-realm>,splunkObservability.accessToken=<your-access-token>,clusterName=<your-cluster-name>" splunk-otel-collector-chart/splunk-otel-collector

   helm install my-splunk-otel-collector --set="splunkObservability.secureAppEnabled=true,splunkObservability.realm=<your-splunk-realm>,splunkObservability.accessToken=<your-access-token>,clusterName=<your-cluster-name>" splunk-otel-collector-chart/splunk-otel-collector

   Proceed to Step 3: Instrument your application for Secure Application.

See Helm chart installation examples that have Secure Application enabled:

• https://github.com/signalfx/splunk-otel-collector-chart/tree/main/examples/secureapp-agent-mode

• https://github.com/signalfx/splunk-otel-collector-chart/tree/main/examples/secureapp-gateway-mode

Alternate deployment options

See Alternate deployment options.