Use Sensu to monitor Kubernetes

[hillaryfraley]

Description

We should document how to use Sensu to monitor Kubernetes.

Category

This is an issue with:

• [ ] errata (error in doc content)
• [x] new doc (requires a completely new doc)
• [ ] update (add missing or refresh existing content)
• [ ] improvement (improve docs content or format)

Affected pages

N/a - new doc

Expected behavior

The docs include a guide for using Sensu to monitor Kubernetes

Current behavior

Docs do not include content that covers monitoring Kubernetes with Sensu

Corrections needed

Add a doc that covers monitoring Kubernetes with Sensu

Additional context

Background and starter info:

• https://github.com/sensu/sensu-docs/issues/851
• https://github.com/sensu/sensu-docs/issues/2027
• https://github.com/sensu/sensu-docs/blob/65e0bf6394428fccabcb9abc8cbe68931671b7d6/archived/sensu-go/5.12/getting-started/sample-app.md
• https://sensu.io/blog/monitoring-kubernetes-docker-part-3-sensu-prometheus
• https://sensu.io/blog/monitoring-kubernetes-part-4-the-sensu-native-approach
• https://github.com/sensu/sensu-k8s-quick-start
• https://sensu.io/blog/minikube-tutorial
• https://sensu.io/blog/filling-gaps-in-kubernetes-observability-with-the-sensu-kubernetes-events-integration
• https://sensu.io/blog/kubernetes-101
• https://sensu.io/blog/our-journey-implementing-sensu-to-monitor-kubernetes-in-production-5764aff2dd50
• https://bonsai.sensu.io/assets/sensu/sensu-kubernetes-events
• https://bonsai.sensu.io/assets/sensu-plugins/sensu-plugins-kubernetes

Discourse: https://discourse.sensu.io/search?q=kubernetes%20category%3A8

[hillaryfraley]

Introduction to kube monitoring concepts and let the other resources fill in the gaps vs. a proscriptive guide.

Start with a high-level overview to get a skeleton started and then review to discuss what's next.

How proscriptive should we be in terms of suggesting which check to use?

What pattern do we use? agent, sidecar, etc.

[hillaryfraley]

Mtg w/ Jef and Troy:

• Jef will experiment with the Kubernetes events check with some of the cloud services and add some notes based on his testing to #3292 .

[hillaryfraley]

Closing this associated PR: https://github.com/sensu/sensu-docs/pull/3628