k8s-microservices-debug

Correlate pod logs across Kubernetes services and validate FluxCD GitOps state.

Updated May 7, 2025
One-click install
npx skills add https://github.com/enchantednatures/.dotfiles --skill k8s-microservices-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-microservices-debug
Source: https://github.com/enchantednatures/.dotfiles/tree/main/.config/opencode/skills/k8s-microservices-debug
Command: npx skills add https://github.com/enchantednatures/.dotfiles --skill k8s-microservices-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kubernetes microservice debugging becomes complex when failures span multiple pods and repositories. This Skill enables you to correlate logs across services, verify FluxCD GitOps state, and distinguish code bugs from deployment/config drift.

Core Features & Use Cases

  • Cross-service log correlation across pods and namespaces to identify root causes.
  • FluxCD state verification by comparing deployed revisions with git history across multiple repos.
  • Multi-repo debugging workflows that separate concerns between app, infra, and config repos.

Quick Start

Begin a cross-repo debugging session by following the workflow checks and commands described.

Frequently Asked Questions about k8s-microservices-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug Kubernetes microservice failures spanning multiple pods?

Debug Kubernetes microservice failures by correlating pod logs across services and namespaces to pinpoint root causes. This approach identifies cascading failures by tracing error patterns across distributed services instead of isolating logs to a single pod.

How does FluxCD GitOps state verification help diagnose deployment issues?

FluxCD GitOps state verification diagnoses deployment issues by comparing deployed cluster revisions against git history across repositories. This reveals configuration drift and separates code bugs from sync failures or uncommitted infrastructure changes.

Do I need cluster and git access to troubleshoot microservices across repos?

You need Kubernetes cluster access, FluxCD tooling, and read access to all relevant git repositories to troubleshoot microservices across repos. These permissions enable cross-repo log correlation and state verification required to distinguish config drift from application bugs.

What is the best way to distinguish code bugs from configuration drift in Kubernetes?

The best way to distinguish code bugs from configuration drift in Kubernetes is comparing FluxCD deployed revisions with multi-repo git history. Analyzing cross-service pod logs alongside git state confirms whether failures stem from application logic or uncommitted infrastructure changes.

Why are my microservices failing across multiple namespaces after a FluxCD sync?

Microservices failing across multiple namespaces after a FluxCD sync often indicate configuration drift or cascading errors from a misconfigured upstream service. Correlating pod logs across affected namespaces and verifying the synced git revisions isolates the failing component.