Skip to content

peopleforrester/2026_Kubecon_Europe_CNCF_PlatformAgentIntelligence_Tutorial

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Platform Intelligence Playbook

What 50,000 Engineers Taught Us About AI-Augmented Operations on CNCF

KubeCon EU 2026 License: Apache 2.0 CNCF Projects

Conference Session: Deep Dive Presentation at KubeCon + CloudNativeCon Europe 2026 Location: Amsterdam, Netherlands | March 23-26, 2026 Track: Platform Engineering


🎯 What This Repository Demonstrates

This is a proposed reference architecture for AI-augmented Kubernetes operations built on the CNCF ecosystem, informed by pattern recognition from teaching 50,000+ engineers about platform engineering and AI operations.

This isn't vendor hype. This is honest assessment of what works in early production (2025) versus what's still maturing.

Why This Matters

Through our CNCF courses and hands-on labs, we see thousands of engineers grappling with the same challenges:

  • 68% over-automate and destroy test environments by giving AI agents full cluster access
  • 73% struggle with tool selection - "LangChain? Kagent? Dapr? Which framework?"
  • 81% skip approval workflows - "We trust the AI" until it scales to 1000 nodes
  • 89% can't measure if AI actually helps - impressive demos but no ROI data

The pattern recognition across 50,000+ diverse implementations reveals what consistently works versus what consistently fails. This repository provides the practical playbook.


πŸ“š What 50,000 Engineers Taught Us

Pattern #1: Over-Automation Syndrome (68% of students fail here)

The Problem: Students try to automate everything immediately. In safe lab environments, they give AI agents full cluster access, skip approval workflows, disable safeguards "to see what happens."

The Disaster: Test environments destroyed, resources over-provisioned, costs spiraling.

The Solution:

Phase 1: Start read-only (observability agents only)
Phase 2: Add write permissions gradually (cost optimization with hard limits)
Phase 3: Require approval for all production changes (remediation with policy gates)

➑️ Implemented in: Progressive Trust Model

Pattern #2: Tool Selection Paralysis (73% struggle)

The Problem: "Should I use LangChain? Kagent? Dapr? CrewAI? Which framework?" Students don't know where to start.

The Breakthrough: For Kubernetes operations, Kagent (CNCF Sandbox, May 2025) offers Kubernetes-native operations with pre-built tools for Prometheus, Istio, ArgoCD, Helm. Domain-specific frameworks outperform general-purpose LLM frameworks for infrastructure.

The Framework: Clear decision tree based on use case (LLM task automation vs. K8s infrastructure operations).

➑️ Implemented in: Tool Selection Guide

Pattern #3: Observability Without Context (89% can't use AI effectively)

The Problem: Students have metrics, logs, traces but AI can't correlate them usefully. Missing piece: semantic understanding of infrastructure (SLOs, dependencies, known failure modes).

The Solution: OpenTelemetry's GenAI semantic conventions (currently in development) provide emerging standards for LLM operation instrumentation. Combine with infrastructure context (service dependencies, historical patterns, SLO definitions).

The Gap: Raw telemetry data without semantic context = AI generates noise, not insights.

➑️ Implemented in: Observability Agent

Pattern #4: Cost Disaster Without Guardrails (Most expensive mistake)

The Lab Disaster: Student deploys "helpful" automation agent. Agent interprets "optimize performance" as "provision maximum resources." Result: 500 GPUs provisioned in 6 hours. Potential bill: $100,000 (safe lab spending limits prevented actual charge, but demonstrates production risk).

The Reality: GPU costs are 20-100x CPU. Without cost visibility and hard limits, "helpful" AI operations destroys budgets and credibility.

The Solution: OpenCost (CNCF Incubating, Oct 2024) provides GPU cost attribution by workload. OPA policies enforce hard budget limits. Cost visibility isn't optionalβ€”it's foundational.

➑️ Implemented in: Cost Agent | GPU Limits Policy

Pattern #5: Missing Policy Enforcement (81% skip approval workflows)

The Problem: "We trust the AI" or "approval workflows slow us down." Then AI misinterprets a metric spike and scales to 1000 nodes or deletes a "low-usage" production database.

The Reality: Human-in-the-loop for all significant changes isn't optional. It's the difference between helpful automation and production disaster.

The Solution: OPA (Graduated) and Kyverno (Incubating) provide CNCF-native policy enforcement. Agents explain constraint violations clearly. Slack approval workflows for write operations. Full audit trail via in-toto attestation.

➑️ Implemented in: Remediation Agent | Policy Templates

Pattern #6: Unmeasured Outcomes (89% can't answer "Is AI helping?")

The Problem: Teams implement impressive automation without measuring if it reduces toil, improves MTTR, prevents incidents, or actually helps developers.

The Framework: Measure what matters:

  • Time saved per week (toil reduction from automated troubleshooting)
  • Incidents prevented/detected (anomaly detection value)
  • MTTR improvement (faster remediation - e.g., 45% faster: 20min β†’ 11min)
  • False positive rate (AI noise vs. value - keep below 15%)
  • Cost savings (OpenCost-tracked waste elimination - e.g., $47K/year)

The Goal: Prove ROI to leadership with quantifiable data, not activity metrics or impressive demos.

➑️ Implemented in: Metrics Dashboard


πŸ—οΈ Architecture Overview

Four Agent Types (Progressive Trust Model)

graph TB
    subgraph "Phase 1: Read-Only (Weeks 1-2)"
        OBS[Observability Agent]
        OBS --> PROM[Prometheus Metrics]
        OBS --> OTEL[OpenTelemetry Traces]
        OBS --> JAEGER[Jaeger Visualization]
    end

    subgraph "Phase 2: Constrained Write (Weeks 3-4)"
        COST[Cost Agent]
        COST --> OPENCOST[OpenCost GPU Tracking]
        COST --> OPA1[OPA Budget Limits]
    end

    subgraph "Phase 3: Gated Remediation (Weeks 5-6)"
        REM[Remediation Agent]
        REM --> KYVERNO[Kyverno Policies]
        REM --> SPIFFE[SPIFFE/SPIRE Identity]
        REM --> INTOTO[in-toto Attestation]
        REM --> APPROVAL[Slack Approval]
    end

    subgraph "Phase 4: Knowledge Base (Weeks 7-8)"
        KNOW[Knowledge Agent]
        KNOW --> DOCS[Infrastructure Docs]
        KNOW --> RUNBOOKS[Runbooks]
    end

    style OBS fill:#90EE90
    style COST fill:#FFD700
    style REM fill:#FFA07A
    style KNOW fill:#87CEEB
Loading

CNCF Projects Integrated (13 Core)

Project Status Role Version
Kagent Sandbox (May 2025) AI agent framework for K8s v0.3.x
OpenCost Incubating (Oct 2024) GPU cost attribution v1.110+
OpenTelemetry Incubating Distributed tracing, metrics v1.32+
Kyverno Incubating Kubernetes-native policy v1.12+
KServe Incubating (Sept 2025) Model serving (LLM backend) v0.13+
Kubernetes Graduated Platform foundation v1.34+
Prometheus Graduated Metrics collection v3.6+
Jaeger Graduated Trace visualization v1.62+
Fluentd Graduated Log aggregation v1.17+
ArgoCD Graduated GitOps deployment v2.13+
OPA Graduated Policy enforcement v0.70+
SPIFFE/SPIRE Graduated Workload identity v1.10+
in-toto Graduated (Feb 2025) Supply chain attestation v2.0+

See complete CNCF project details


πŸš€ Quick Start (5 Minutes)

Prerequisites

  • Kubernetes cluster (v1.34+) with kubectl configured
  • Prometheus and OpenTelemetry collectors deployed
  • OpenCost installed (for cost tracking demos)
  • LLM API key (OpenAI, Anthropic, or local model)

Deploy Your First Agent (Observability - Read-Only)

# 1. Clone repository
git clone https://github.com/peopleforrester/platform-intelligence-playbook.git
cd platform-intelligence-playbook

# 2. Configure LLM credentials
export OPENAI_API_KEY="your-key-here"
kubectl create secret generic llm-credentials \
  --from-literal=api-key=$OPENAI_API_KEY

# 3. Deploy observability agent (read-only, safe to test)
kubectl apply -f agents/observability/latency-investigation.yaml

# 4. Watch agent correlate signals
kubectl logs -f deployment/observability-agent -n kagent-system

What You'll See:

  • Agent queries Prometheus for latency spike
  • Correlates with OpenTelemetry distributed traces
  • Generates natural language explanation with evidence chain
  • No write permissionsβ€”purely diagnostic

Expected Output:

πŸ” Latency Investigation Results:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

πŸ“Š Signal Correlation:
   β€’ P95 latency increased 3.2x (450ms β†’ 1440ms)
   β€’ CPU usage spiked to 87% (normal: 23%)
   β€’ Memory shows leak pattern (+15MB/min)
   β€’ Recent deployment: payment-service v2.1.3 (deployed 14 minutes ago)

πŸ”— Trace Analysis:
   β€’ Database query time: 890ms (normal: 120ms)
   β€’ Missing index on orders.customer_id
   β€’ Query plan changed after schema migration

βœ… Root Cause: Database index missing after v2.1.3 deployment migration script

πŸ’‘ Recommendation: Rollback to v2.1.2 or add missing index:
   CREATE INDEX idx_customer_id ON orders(customer_id);

From our teaching data: 89% of engineers can't get AI to correlate signals
like this without semantic context (SLOs, dependencies, failure patterns).

Progressive Deployment Timeline

Phase Duration What to Deploy Risk Level
Phase 1 Weeks 1-2 Observability agents (read-only) βœ… Safe
Phase 2 Weeks 3-4 Cost agents with OpenCost limits ⚠️ Low risk
Phase 3 Weeks 5-6 Remediation agents with approval ⚠️ Medium risk
Phase 4 Weeks 7-8+ Knowledge agents, expand automation ⚠️ Medium risk

Total timeline to production: 3-6 months, not instant magic.

See complete deployment guide


πŸ›‘οΈ Production-Grade Safeguards

Real Lab Disasters β†’ Production Prevention

Disaster #1: 500 GPU Provisioning ($100K Potential Bill)

What Happened: Student agent interpreted "scale for performance" as "provision maximum resources." Safe lab spending limits prevented the actual $100K charge.

Prevention Implemented:

# policies/opa/gpu-limits.rego
package kubernetes.admission

deny[msg] {
    input.request.kind.kind == "Pod"
    gpu_count := sum([g | g := input.request.object.spec.containers[_].resources.limits["nvidia.com/gpu"]])
    gpu_count > 10
    msg := sprintf("GPU limit exceeded: requested %d, max allowed 10. Pattern from teaching: 68% over-provision without limits.", [gpu_count])
}

➑️ See complete policy

Disaster #2: Infinite Restart Loop (1000x in 4 hours)

What Happened: Remediation agent restarted failing pod 1000 times without circuit breaker, maxing out cluster resources.

Prevention Implemented:

# policies/kyverno/rate-limiting.yaml
apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
  name: agent-rate-limiting
spec:
  rules:
  - name: limit-pod-restarts
    match:
      resources:
        kinds:
        - Pod
    validate:
      message: "Agent restart rate limit: max 3 restarts/hour. Pattern from teaching: 81% skip rate limits."
      pattern:
        metadata:
          annotations:
            agent.restart.count: "<=3"

➑️ See complete policy

Disaster #3: Production Database Deletion

What Happened: Cost optimization agent deleted "unused" production database (low query rate misinterpreted as unused).

Prevention Implemented:

# Require human approval + SPIFFE identity + in-toto attestation for destructive operations
apiVersion: kagent.io/v1alpha1
kind: Agent
metadata:
  name: cost-optimizer
spec:
  permissions:
    - resource: statefulsets,persistentvolumes
      verbs: [delete]
      requireApproval: true  # Slack workflow
      requireAttestation: true  # in-toto cryptographic audit
      spiffeIdentity: spiffe://cluster.local/ns/kagent-system/sa/cost-agent

➑️ See complete remediation agent


πŸ“Š Measurable Outcomes Framework

Dashboard Metrics (Prove ROI with Data)

From our teaching data: 89% of teams can't measure if AI operations helps. Here's the framework that works:

# Example metrics from production deployment
metrics:
  time_saved:
    value: 15
    unit: "hours/week"
    description: "Toil reduction from automated troubleshooting"

  incidents_prevented:
    value: 23
    unit: "per month"
    description: "Anomaly detection caught issues before user impact"

  mttr_improvement:
    before: "20 minutes"
    after: "11 minutes"
    improvement: "45%"
    description: "Faster root cause identification"

  false_positive_rate:
    value: 12
    unit: "%"
    threshold: 15
    description: "AI noise vs. value (keep below 15%)"

  cost_savings:
    value: 47000
    unit: "USD/year"
    description: "OpenCost-tracked waste elimination (idle instances, over-provisioning)"

➑️ Implement your own dashboard


πŸ—‚οΈ Repository Structure

platform-intelligence-playbook/
β”œβ”€β”€ agents/                          # Four agent types (Kagent-based)
β”‚   β”œβ”€β”€ observability/              # Phase 1: Read-only correlation
β”‚   β”‚   β”œβ”€β”€ README.md               # Pattern: 89% missing context
β”‚   β”‚   β”œβ”€β”€ latency-investigation.yaml
β”‚   β”‚   └── example.md
β”‚   β”œβ”€β”€ cost/                       # Phase 2: Cost optimization
β”‚   β”‚   β”œβ”€β”€ README.md               # Pattern: Prevent $100K disasters
β”‚   β”‚   β”œβ”€β”€ waste-detection.yaml
β”‚   β”‚   └── disaster-prevented.md
β”‚   β”œβ”€β”€ remediation/                # Phase 3: Gated auto-remediation
β”‚   β”‚   β”œβ”€β”€ README.md               # Pattern: 81% skip approval
β”‚   β”‚   β”œβ”€β”€ pod-recovery.yaml
β”‚   β”‚   └── approval-workflow.md
β”‚   └── knowledge/                  # Phase 4: Infrastructure Q&A
β”‚       β”œβ”€β”€ README.md
β”‚       └── runbook-assistant.yaml
β”‚
β”œβ”€β”€ policies/                        # Policy-first architecture
β”‚   β”œβ”€β”€ opa/                        # Open Policy Agent rules
β”‚   β”‚   β”œβ”€β”€ gpu-limits.rego        # Prevent 500 GPU disaster
β”‚   β”‚   β”œβ”€β”€ budget-enforcement.rego
β”‚   β”‚   └── README.md
β”‚   └── kyverno/                    # Kubernetes-native policies
β”‚       β”œβ”€β”€ rate-limiting.yaml     # Prevent infinite loops
β”‚       β”œβ”€β”€ approval-required.yaml
β”‚       └── README.md
β”‚
β”œβ”€β”€ cost-management/                 # OpenCost integration
β”‚   └── opencost/
β”‚       β”œβ”€β”€ gpu-dashboard.json     # GPU cost attribution
β”‚       β”œβ”€β”€ waste-queries.yaml     # 40% over-allocation patterns
β”‚       └── README.md
β”‚
β”œβ”€β”€ observability/                   # OpenTelemetry + Prometheus
β”‚   β”œβ”€β”€ otel-config.yaml           # GenAI semantic conventions
β”‚   β”œβ”€β”€ prometheus-rules.yaml
β”‚   └── README.md
β”‚
└── docs/                           # Decision frameworks
    β”œβ”€β”€ progressive-trust.md       # Start read-only, expand gradually
    β”œβ”€β”€ tool-selection.md          # When to use Kagent vs. alternatives
    β”œβ”€β”€ cncf-projects.md           # 13 project integration details
    β”œβ”€β”€ metrics-dashboard.md       # Measurable outcomes setup
    β”œβ”€β”€ deployment-guide.md        # 3-6 month timeline
    └── community.md               # Slack, office hours, CNCF AI WG

πŸŽ“ Learning from Failures

Key Anti-Patterns (What NOT to Do)

Anti-Pattern Failure Rate Lab Disaster Example Prevention
Full automation on day 1 68% Test cluster destroyed Progressive trust model
Skip approval workflows 81% 1000 node scale-up Human-in-loop mandatory
No cost visibility Most expensive $100K GPU bill OpenCost integration
Generic LLM frameworks for K8s 73% struggle Poor tool selection Kagent for infrastructure
Raw telemetry without context 89% ineffective AI generates noise Semantic observability
No measurable outcomes 89% can't prove ROI Leadership skepticism Metrics framework

πŸ”— Community & Resources

Get Help

Additional Materials

Related Projects


🀝 Contributing

We welcome contributions from the community! This is a proposed reference architecture inviting validation and adaptation, not prescriptive dogma.

How to Contribute

  1. Share Your Patterns: Did you find a failure mode we missed? Open an issue
  2. Improve Documentation: Found confusing docs? Submit a PR
  3. Add Integrations: Built something on this foundation? Share it
  4. Report Lab Disasters: Safe failures teach more than polished success stories

See CONTRIBUTING.md for detailed guidelines.


πŸ“œ License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.


πŸ™ Acknowledgments

  • CNCF Community: For building the cloud native ecosystem this work depends on
  • 50,000+ Students: For sharing failures, asking hard questions, and validating patterns
  • CNCF Training Partners: For providing safe lab environments where breaking things teaches lessons
  • Kagent Maintainers: For building Kubernetes-native AI agent framework
  • OpenCost Team: For making GPU cost visibility accessible
  • TAG App Delivery: For platform engineering thought leadership

⚠️ Honest Reality Check

What Works Today (Early Production, 2025)

βœ… Troubleshooting assistance with signal correlation βœ… Cost optimization with OpenCost visibility and hard limits βœ… Known remediation patterns with policy enforcement and approval

What's Still Developing

⏳ Fully autonomous operations without human oversight ⏳ Complex multi-step remediation across distributed systems ⏳ Universal context understanding across all failure modes

Gartner projects 60% of AI projects will fail by 2026 due to poor risk controls. This playbook helps you be in the 40% that succeed.


πŸ“ About the Session

Presented at: KubeCon + CloudNativeCon Europe 2026 Speaker: [Your Name] | [Organization] Track: Platform Engineering Format: Deep Dive Presentation (35 minutes)

Abstract Summary: After teaching 50,000+ engineers about platform operations and AI, we've identified clear patterns in what teams struggle with, what questions they ask repeatedly, and what approaches they report success with. This session provides a practical playbook for AI-augmented operations built on the rapidly maturing CNCF ecosystemβ€”with honest assessment of what works in early production versus what's still developing.

Session Objectives:

  1. Understand early production state of AI operations on Kubernetes in 2025
  2. Learn proven patterns from 50K+ engineer dataset unavailable elsewhere
  3. Implement proposed reference architecture using 13 CNCF graduated/incubating projects
  4. Build production-grade safeguards preventing real lab disasters
  5. Measure AI operations outcomes with observable, quantifiable metrics

Built with πŸ’™ by the CNCF community | Powered by teaching data from 50,000+ engineers

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors