troubleshoot-service

Diagnose and resolve Go Kratos microservice build, runtime, and connection issues.

Updated Feb 10, 2026

Search Tags:#debugging #troubleshooting #microservices #configuration #build errors #runtime errors #kratos

Ready to run

npx skills add https://github.com/vesviet/microservices-agent-skills --skill troubleshoot-service

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: troubleshoot-service
Source: https://github.com/vesviet/microservices-agent-skills/tree/main/skills/troubleshoot-service
Command: npx skills add https://github.com/vesviet/microservices-agent-skills --skill troubleshoot-service

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers quickly diagnose and fix common build errors, runtime crashes, connection failures, and configuration problems encountered when developing and operating microservices.

Core Features & Use Cases

Diagnostic Decision Tree: Guides users through common issues like build errors (proto, Go compile, Wire), startup crashes (DB, Redis, Consul), and runtime errors (migrations, data layer, Dapr, Elasticsearch).
Targeted Fixes: Provides specific commands and configuration examples for resolving issues related to proto generation, Wire, database connections, migrations, and accessing infrastructure.
Use Case: When a new microservice fails to start due to a database connection error, this Skill provides the exact commands to check credentials, ensure the database exists, and verify the PostgreSQL service is running.

Quick Start

Use the troubleshoot-service skill to fix a service that is crashing on startup due to a Redis connection failure.

Frequently Asked Questions about troubleshoot-service

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

FAQPage Schema

How do I troubleshoot microservice build errors related to proto generation and Wire in Go Kratos?▼

To troubleshoot microservice build errors in Go Kratos, use a structured decision tree to diagnose proto generation and Wire compilation issues, applying targeted command-line fixes to resolve the build failures.

Why does my Go Kratos microservice crash on startup with database, Redis, or Consul connection failures?▼

Startup crashes from database, Redis, or Consul connection failures are diagnosed by checking infrastructure connectivity and verifying credentials, ensuring the required external services are running and accessible.

What is the best way to fix runtime errors with Dapr and Elasticsearch in a microservices environment?▼

The best way to fix Dapr and Elasticsearch runtime errors is to follow a diagnostic decision tree that isolates configuration issues and provides specific commands to verify infrastructure access.

Can I use this troubleshooting process to resolve database migration issues in a Kratos microservice?▼

Yes, you can resolve database migration issues in a Kratos microservice by diagnosing the data layer and applying targeted command-line fixes to correct migration execution and configuration problems.

How do I check if my PostgreSQL service is running when a new microservice fails to start?▼

To check if PostgreSQL is running when a microservice fails to start, use specific diagnostic commands to verify the service status, confirm the database exists, and validate the connection credentials.