Skip to main content
Sumo Logic

Kubernetes Quickstart

Get started with our Kubernetes solution in minutes.

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

Installation

Helm

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.

1. If this is your 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. Items in bold are required.

helm upgrade --install my-release sumologic/sumologic \
--namespace=my-namespace \
--create-namespace \
--set sumologic.accessId=SUMO_ACCESS_ID \
--set sumologic.accessKey=SUMO_ACCESS_KEY \
--set sumologic.clusterName=Kubernetes_cluster \
--set sumologic.collectorName=kubernetes \
--set "sumologic.setup.monitors.notificationEmails={EMAIL ADDRESS}"

YAML

1. Get your Sumo Logic Access ID and Access Key and run the following command to generate the YAML. Items in bold are required.

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' \
--set sumologic.collectorName=kubernetes-2022-06-25T20:21:06.131Z \
--set "sumologic.setup.monitors.notificationEmails={EMAIL ADDRESS}"
| 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

Next Steps

Once you have completed the above steps, you'll have installed the collection, as well as the core Kubernetes Dashboards and alerts. To get started, open a new Explore tab in Sumo Logic and view your Kubernetes App Dashboards.

If you don't see data in Sumo Logic, you can review our troubleshooting guide.