Splunk Distribution of the OpenTelemetry Collector as an AWS EKS Add-on

Deploy the Collector onto an Amazon EKS cluster through the AWS EKS add-on.

Amazon Elastic Kubernetes Service (EKS) is a managed container service that runs and scales Kubernetes applications in Amazon Web Services (AWS). Splunk Observability Cloud provides an EKS add-on in AWS Marketplace. Use this add-on to deploy the Splunk Distribution of the OpenTelemetry Collector onto Amazon EKS clusters and monitor EKS performance by namespace, cluster, pod, or organizational concepts such as team or application.

For more information, see Amazon EKS add-ons in the official AWS documentation.

Note: This add-on is different from the add-ons for the Splunk platform. See Splunk Supported Add-ons for more information.

Benefits

The Splunk Distribution of the OpenTelemetry Collector Amazon EKS add-on:

  • Simplifies installation, configuration, and management of Amazon EKS clusters.

  • Includes the latest security patches and bug fixes.

  • Is validated by AWS to work with Amazon EKS.

Limitations

The EKS add-on has the following limitations:

  • The EKS add-on integration doesn't support Helm hooks and Helm subcharts. Consequently, certain features that rely on these capabilities are unavailable, such as:

    • The Collector Secret Validation feature is unavailable because it uses a Helm hook.

    • Operator-based auto-instrumentation is unsupported because it relies on subcharts to deploy required components.

    • OpenTelemetry Target Allocator is unsupported because it relies on a Helm subchart.

    • OpenTelemetry eBPF Instrumentation (OBI) is unsupported because it relies on a Helm subchart.

  • With the EKS add-on, you can only deploy one instance of the Splunk Distribution of the OpenTelemetry Collector per EKS cluster. Consider this limitation when you plan for scale and redundancy.

Next steps

For production deployments, use Install the EKS add-on with secure token handling.

For non-production deployments, see Install the EKS add-on without secure token handling.

Upgrade the EKS add-on

Find an add-on version compatible with your cluster's Kubernetes version, and then update the managed add-on by using the Amazon EKS console or AWS CLI.

To update by using the AWS CLI, run the following command:

BASH 
aws eks update-addon \
  --cluster-name your-eks-cluster-name \
  --addon-name splunk_splunk-otel-collector-chart \
  --addon-version your-compatible-addon-version \
  --configuration-values file://values.yaml

The external splunk-otel-collector Secret isn't part of the add-on configuration and must remain in the splunk-monitoring namespace.