Kubernetes Quickstart

This guide will walk you through setting up Sumo Logic's Kubernetes solution. If you don't have a Sumo Logic account, sign up for a free trial.

Installation

Helm

1. If this is the first time installing our helm chart, add the Sumo Logic Helm repo:

   helm repo add sumologic https://sumologic.github.io/sumologic-kubernetes-collection
   helm repo update

2. Get your Sumo Logic Access ID and Access Key and run the following command:

   helm upgrade --install <HELM_RELEASE_NAME> sumologic/sumologic \
       --set sumologic.accessId="<SUMO_ACCESS_ID>" \
       --set sumologic.accessKey="<SUMO_ACCESS_KEY>" 

3. Once you have completed installation, you can install the Kubernetes App and view the dashboards and open a new Explore tab in Sumo Logic. If you don't see data in Sumo Logic, you can review our troubleshooting guide.

Helm Values File

As a best practice, we recommend using helm values files when adding additional configuration. The values file should only contain properties you want to change from the default values.yaml to ensure upgrades behave properly.

YAML

1. Get your Sumo Logic Access ID and Access Key and run the following command to generate the YAML:

   kubectl run tools \
     -i --quiet --rm \
     --restart=Never \
     --image sumologic/kubernetes-tools:2.9.0 -- \
     template \
     --name-template 'collection' \
     --set sumologic.accessId='<SUMO_ACCESS_ID>' \
     --set sumologic.accessKey='<SUMO_ACCESS_KEY>' \
     | tee sumologic.yaml

2. Install the required CRDs and apply the generated YAML:

   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_probes.yaml
   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_alertmanagers.yaml
   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_prometheuses.yaml
   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_prometheusrules.yaml
   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml
   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_podmonitors.yaml
   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_thanosrulers.yaml
   kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.43.2/example/prometheus-operator-crd/monitoring.coreos.com_alertmanagerconfigs.yaml
   kubectl apply -f sumologic.yaml

3. Once you have completed installation, you can install the Kubernetes App and view the dashboards and open a new Explore tab in Sumo Logic. If you don't see data in Sumo Logic, you can review our troubleshooting guide.

Additional Reading

• Full List of Configuration Options.
• Sumo Logic Helm Chart Troubleshooting Guide