Install Splunk OTel Collector Using kubectl CLI

  1. Install the Cluster Agent Operator using the cluster-agent-operator.yaml file.
    kubectl create -f cluster-agent-operator.yaml -n appdynamics

    If Cluster Agent is already installed, you can ignore this step.

  2. (Optional) If you do not require Cluster Agent to monitor the infrastructure along with the OTel collector, then set the value of disableClusterAgentMonitoring to true in the cluster-agent.yaml file. The value is set to false by default.

    This configuration allows infrastructure monitoring only through OTel collector. Also, if you have configured Cluster Agent to auto-instrument the supported agents, those will also get instrumented.

    This is an example yaml file:

    
    clusterAgent:
      appName: splunk-test-7
      logLevel: debug
      nsToMonitorRegex: "demo|fgh"
      enableAdditionalMetrics: true
      clusterMetricsSyncInterval: 60
      metadataSyncInterval: 60
      eventUploadInterval: 10
      httpClientTimeout: 30
      disableClusterAgentMonitoring: true
                
    Note: The disableClusterAgentMonitoring value takes precedence over sim.cluster.monitoring.enabled. Therefore, if you set the disableClusterAgentMonitoring value to true then Cluster Agent stops the infrastructure monitoring even when sim.cluster.monitoring.enabled is set to the default value, true.
  3. Install Cluster Agent.
    kubectl create -f cluster-agent-cli.yaml -n appdynamics
  4. Clone the Splunk OTel Collector repository from Github repository to the same location where you have installed Cluster Agent.
  5. Run the following command to create the required resources from the rendered_manifests directory:
    kubectl create -f ./rendered_manifests --recursive
  6. In the rendered_manifests directory, update the secret-splunk.yaml file with the base64 encoded value of splunk_observability_access_token.

    For details related to Splunk Observability access token, see Create and manage organization access tokens using Splunk Observability Cloud.

  7. In the rendered_manifests directory, update the configmap-cluster-receiver.yaml file with the following details:
    ParameterDescription
    k8s.cluster.nameThe name of the cluster.
    api_urlThe URL of the OTel Collector API endpoint.
    ingest_urlThe URL of the OTel Collector ingestion endpoint.
  8. In the rendered_manifests directory, update the configmap-agent.yaml file with the following API endpoint details:
    ParameterDescription
    metrics_endpointThe URL of the OTel Collector metrics endpoint.
    traces_endpointThe URL of the OTel Collector traces endpoint.
    logs_endpointThe URL of the OTel Collector logs endpoint.
    api_urlThe URL of the OTel Collector API endpoint.
    ingest_urlThe URL of the OTel Collector ingestion endpoint.