skills.rest
vesviet
vesvietCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/vesviet/microservices-agent-skills --skill troubleshoot-service
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
lichong-alichong-a

ric-infra-safety

Manage RIC infrastructure services with non-destructive operations and namespace isolation.

Community
Advanced
William189189William189189

error-troubleshooting

Diagnoses and resolves common SDK error patterns in Nexus, DataFlow, and runtime.

Community
Advanced
Razaib-khanRazaib-khan

configuring-dapr-pubsub

Configure Dapr pub/sub components with Kafka or Redis for FastAPI services.

Community
Advanced
gil00pitagil00pita

debugging

Analyze stack traces, logs, and performance data to identify root causes.

Community
Advanced