dns-debug

Diagnose DNS resolution failures in Kubernetes clusters using kubectl.

225|28|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/scitix/siclaw --skill dns-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dns-debug
Source: https://github.com/scitix/siclaw/tree/main/skills/core/dns-debug
Command: npx skills add https://github.com/scitix/siclaw --skill dns-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and troubleshoot common DNS resolution failures within a Kubernetes cluster, such as NXDOMAIN errors, timeouts, and SERVFAIL responses.

Core Features & Use Cases

  • CoreDNS Health Check: Verifies the status and logs of CoreDNS pods.
  • Service Resolution Testing: Tests DNS resolution from within specific pods.
  • Error Analysis: Provides guidance on common DNS errors and their potential causes.
  • Use Case: When pods cannot reach other services due to DNS issues, this skill helps pinpoint whether the problem lies with CoreDNS, network policies, or service misconfiguration.

Quick Start

Diagnose DNS resolution failures for the service 'my-service' in the 'default' namespace.

Frequently Asked Questions about dns-debug

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

FAQPage Schema
Why am I getting NXDOMAIN errors for Kubernetes services and how do I diagnose them?

To diagnose NXDOMAIN errors in Kubernetes, you need to analyze CoreDNS health, service endpoints, and DNS configurations. This process pinpoints whether the failure stems from CoreDNS issues, network policies, or service misconfigurations.

How do I troubleshoot CoreDNS timeouts and SERVFAIL responses in my cluster?

Troubleshooting CoreDNS timeouts and SERVFAIL responses involves verifying the status and logs of CoreDNS pods. This process tests service resolution from within specific pods to identify the root cause of the DNS failures.

How do I test DNS resolution from within a specific Kubernetes pod?

Testing DNS resolution from within a specific pod requires checking CoreDNS health and analyzing service endpoints. This action performs service resolution testing to determine if pods cannot reach other services due to DNS issues.

Do I need kubectl to troubleshoot Kubernetes cluster DNS failures?

Yes, you need kubectl to troubleshoot Kubernetes cluster DNS failures. Diagnosing DNS resolution failures requires kubectl for cluster interaction to analyze CoreDNS health, service endpoints, and DNS configurations.

What is the best way to check CoreDNS health when pods cannot reach other services?

The best way to check CoreDNS health when pods cannot reach services is to verify the status and logs of CoreDNS pods. This action analyzes CoreDNS health and DNS configurations to identify the root cause of resolution failures.