AutoObserve
Deploy

Kubernetes

How to deploy AutoObserve on Kubernetes and use cluster context in investigations.

Docs v1.0Updated Supported

When should I use this?

  • You run AutoObserve in production or design-partner environments on Kubernetes.
  • You need deployment, rollout, and pod restart context in investigations.
  • You already collect Kubernetes-aware OpenTelemetry telemetry.

Requirements

  • Kubernetes cluster with deploy permissionsRequired
  • Helm or operator install path (design-partner guided today)Required
  • OpenTelemetry pipelines exporting cluster-scoped attributesRequired

Steps

1. Deploy to your cluster

# Design-partner installs use guided Helm values — see Helm guide for commands
# helm upgrade --install autoobserve autoobserve/autoobserve -f values.yaml

Design Partners receive guided cluster setup against real workloads. See Deploy with Helm for the chart-based install path.

2. Understand what AutoObserve correlates

AutoObserve treats Kubernetes as first-class runtime context:

  • Deployments, rollouts, and image changes
  • Pod restarts, OOMKills, and scheduling events
  • Service topology and dependency edges
  • Resource saturation (CPU, memory, connection pools) when exposed via telemetry

3. Validate against the canonical demo

In the checkout latency demo, Kubernetes restarts appear as evidence alongside the deployment that changed the connection pool — supporting the causal chain without replacing your cluster tools.

Did it work?

Troubleshooting

What's happening?

Problem

Investigations lack Kubernetes deployment or pod context.

Symptoms

  • No rollout or restart evidence
  • Missing k8s.* attributes on telemetry

Likely causes

  • Cluster permissions insufficient
  • Kubernetes attributes not in resource attributes

Resolution

Confirm cluster RBAC for change sources and align k8s.namespace.name, k8s.pod.name, and k8s.deployment.name on telemetry.

Verify fix

Investigations show Kubernetes evidence alongside metrics and logs.

Continue

Connect OpenTelemetry

Docs v1.0 · Updated ReviewedExamples testedChangelog

On this page