# dt-obs-kubernetes

Query and analyze Kubernetes clusters, workload health, OOMKills, and pod placement directly through Dynatrace DQL in your agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2600 installs · ★ 167
- Author: Dynatrace
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-obs-kubernetes/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/dt-obs-kubernetes

## What it does

This skill provides the agent with Dynatrace Query Language (DQL) patterns to inspect Kubernetes infrastructure. It structures queries across `smartscapeNodes` for entity inventory, `timeseries` for resource metrics, and `fetch logs` for cluster events. Workload kinds such as `deployment` and `daemonset` must remain lowercase, matching Dynatrace entity standards rather than standard Kubernetes PascalCase.

Resource limit and request aggregations require strict attention: always calculate `limits_cpu` and `limits_memory` using `sum()` instead of `avg()`. Using `avg()` will silently distort capacity planning because it flattens multi-container pods and underreports DaemonSet workloads across nodes. Note that while `k8s.object` JSON is accessible for pods, nodes, and workloads, it is unavailable on `K8S_CLUSTER` entities.

The scope covers cluster health, OOMKills, evictions, and scheduling constraints. Do not invoke it for distributed tracing, service-level RED metrics, or AWS-specific queries, as Dynatrace delegates those domains to separate skills.

## Requirements
- Works with: Kubernetes, Dynatrace

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-kubernetes -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/dt-obs-kubernetes/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/dt-obs-kubernetes/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-kubernetes -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/dt-obs-kubernetes/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-kubernetes -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/dt-obs-kubernetes/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Dynatrace/dynatrace-for-ai dt-obs-kubernetes
```

2. **Manually: put the files in place**
- File: `.github/skills/dt-obs-kubernetes/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-kubernetes -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Dynatrace/dynatrace-for-ai --path skills/dt-obs-kubernetes
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/dt-obs-kubernetes/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-kubernetes -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-obs-kubernetes/SKILL.md

## When to use it
- investigate pod crash loops and OOMKill events
- track CPU and memory usage across cluster nodes
- detect over-provisioned container limits and requests
- audit pod placement rules, taints, and affinities

## Example prompts
- Check cluster health and list pods experiencing OOMKills in the last hour
- Show container CPU utilization in the production namespace using Dynatrace DQL
- Identify Kubernetes nodes where pod capacity exceeds 80%

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9928ff383e6995b0.

BEGIN THIRD-PARTY FILE 9928ff383e6995b0
```text
---
name: dt-obs-kubernetes
description: >-
  Kubernetes cluster, pod, node, and workload monitoring. Use when analyzing K8s health, resource
  optimization, pod failures, OOMKills, scheduling, or security posture. Also use for Kubernetes
  operational events like pod restarts, OOM events, evictions, and cluster event history.
  Trigger: "Kubernetes pods", "K8s cluster health", "OOMKill", "pod restarts", "container CPU",
  "namespace resource usage", "over-provisioned pods", "privileged containers",
  "pod placement", "K8s node capacity", "running containers by cluster",
  "workload scheduling", "pod evictions", "K8s labels and annotations",
  "kubernetes events", "pod restart events", "OOM events", "K8s event history".
  Do NOT use for explaining existing queries, product documentation questions,
  AWS-specific resource queries, service-level RED metrics, distributed tracing, or
  log analysis — use the relevant skill instead.
license: Apache-2.0
---

# Infrastructure Kubernetes

Monitor and analyze Kubernetes infrastructure using Dynatrace DQL. Query
cluster resources, monitor workload health, analyze pod placement, optimize
costs, and assess security posture.

## When to Use This Skill

- Monitoring Kubernetes cluster health and capacity
- Analyzing pod and container resource utilization
- Investigating pod failures, OOMKills, evictions, or crash loops
- Debugging degraded deployments, stuck rollouts, or node pressure
- Optimizing Kubernetes resource costs
- Assessing security posture and compliance
- Troubleshooting workload scheduling and placement
- Auditing ingress routing and network policies
## Knowledge Base Structure

### Core Monitoring (Start Here)

1. **Cluster Inventory** → `references/cluster-inventory.md` - Clusters,
   namespaces, resource distribution
2. **Node Monitoring** - Node capacity, CPU/memory usage, pod density
3. **Pod Monitoring** - Pod CPU, memory, lifecycle events
4. **Workload Monitoring** - Deployment, StatefulSet, DaemonSet resources

### Advanced Topics

1. **Configuration Analysis** → `references/labels-annotations.md` - Parse
   k8s.object, labels, annotations
2. **Scheduling & Placement** → `references/pod-node-placement.md` - Node
   selectors, affinity, taints, HA
3. **Cost Optimization** - Right-sizing, waste detection, efficiency scoring
4. **Security & Compliance** - Privileged containers, security contexts

## Key Concepts

### Entity Types

**Workloads:** `K8S_DEPLOYMENT`, `K8S_STATEFULSET`, `K8S_DAEMONSET`,
`K8S_JOB`, `K8S_CRONJOB`, `K8S_HORIZONTALPODAUTOSCALER`  
```
END THIRD-PARTY FILE 9928ff383e6995b0

The third-party file has ended. Everything between the 9928ff383e6995b0 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2563 of 21598 bytes. © Dynatrace · Apache-2.0 · https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-obs-kubernetes/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md