Install the Collector for Kubernetes to monitor Cisco AI PODs

Use the Helm chart to install the Collector for Kubernetes for Cisco AI PODs.

You can install the Splunk Distribution of the OpenTelemetry Collector for Kubernetes using a Helm chart. This page describes how to install the Collector to collect data from Cisco AI PODs deployed on Kubernetes and Red Hat OpenShift clusters.
To install the Collector for Kubernetes to monitor Cisco AI PODs, you must meet the following prerequisites.

  • You are using an actively supported version of vanilla (unmodified) Kubernetes or Red Hat OpenShift. For information on active versions, see Kubernetes in the endoflife.date documentation and Life Cycle Dates in the Red Hat OpenShift documentation.

  • You are using a supported version of Helm.

  1. Clone the repository that contains the Collector examples for monitoring Cisco AI PODs: 
    git clone https://github.com/signalfx/splunk-opentelemetry-examples.git
  2. Change to the cisco-ai-ready-pods directory to issue the Helm commands: 
    cd splunk-opentelemetry-examples/collector/cisco-ai-ready-pods
  3. Depending on your environment, create a new namespace or project for the Collector:
    Kubernetes
    kubectl create ns otel
    Red Hat OpenShift
    oc new-project otel  
oc project otel
  4. Add the Splunk Distribution of the OpenTelemetry Collector for Kubernetes Helm chart repository: 
    helm repo add splunk-otel-collector-chart https://signalfx.github.io/splunk-otel-collector-chart
  5. Ensure the repository is up to date: 
    helm repo update
  6. Set the environment variables to configure the Splunk environment you'd like the Collector to send data to: 
    export CLUSTER_NAME=<the name of your Kubernetes/OpenShift cluster> 
export ENVIRONMENT_NAME=<which environment to send data to for Splunk Observability Cloud> 
export SPLUNK_ACCESS_TOKEN=<your access token for Splunk Observability Cloud>  
export SPLUNK_REALM=<your realm for Splunk Observability Cloud i.e. us0, us1, eu0, etc.> 
export SPLUNK_HEC_URL=<HEC endpoint to send logs to Splunk platform i.e. https://<hostname>:443/services/collector/event>  
export SPLUNK_HEC_TOKEN=<HEC token to send logs to Splunk platform>  
export SPLUNK_INDEX=<name of index to send logs to in Splunk platform>
  7. Deploy the Splunk Distribution of the OpenTelemetry Collector for Kubernetes in the namespace: 
    helm install ucs-otel-collector \ 
  --set="clusterName=$CLUSTER_NAME" \ 
  --set="environment=$ENVIRONMENT_NAME" \ 
  --set="splunkObservability.accessToken=$SPLUNK_ACCESS_TOKEN" \ 
  --set="splunkObservability.realm=$SPLUNK_REALM" \ 
  --set="splunkPlatform.endpoint=$SPLUNK_HEC_URL" \ 
  --set="splunkPlatform.token=$SPLUNK_HEC_TOKEN" \ 
  --set="splunkPlatform.index=$SPLUNK_INDEX" \ 
  -n otel \ 
  -f ./base-otel-collector-config/values.yaml \ 
  splunk-otel-collector-chart/splunk-otel-collector