# kratos | Kratos | Knowledge Base | Instagit

Your ultimate Go microservices framework for the cloud-native era.

GitHub Stars: 25.5k

Repository: https://github.com/go-kratos/kratos

---

## Articles

### [Deploying Kratos Services in Production: Best Practices and Patterns](/go-kratos/kratos/kratos-production-deployment-patterns)

Learn best practices for deploying Kratos services in production. Utilize App lifecycle, service discovery, and OpenTelemetry for robust, observable applications.

- Tags: best-practices
- Published: 2026-03-02

### [How to Configure Retry Logic and Timeouts for gRPC Client Calls in Kratos Services](/go-kratos/kratos/kratos-configure-grpc-client-retries-timeouts)

Master gRPC client call retry logic and timeouts in Kratos services. Learn to use grpcWithTimeout, native retry policies, or custom interceptors for robust communication.

- Tags: how-to-guide
- Published: 2026-03-02

### [Testing Strategies for Kratos Middleware Components and Applications](/go-kratos/kratos/kratos-testing-strategies-middleware-applications)

Master Kratos middleware testing. Explore unit tests, mock handlers, integration, and end-to-end strategies for robust applications. Ensure reliability with Kratos.

- Tags: testing
- Published: 2026-03-02

### [How to Implement Custom Codec Serializers in Kratos for Non-Standard Formats](/go-kratos/kratos/kratos-custom-codec-serializers)

Implement custom Kratos codec serializers to support non-standard formats like applicationvndmyappprotobuf. Register your codec for automatic content negotiation.

- Tags: how-to-guide
- Published: 2026-03-02

### [How to Integrate Kratos Services with Modern Service Mesh Platforms Like Istio and Linkerd](/go-kratos/kratos/kratos-integrate-with-service-mesh)

Integrate Kratos services with Istio and Linkerd. Learn how to enable distributed tracing, mTLS, and observability with your service mesh for enhanced control and insights.

- Tags: how-to-guide
- Published: 2026-03-02

### [7 Common Pitfalls When Defining Protobuf Errors in Kratos](/go-kratos/kratos/kratos-protobuf-errors-common-pitfalls)

Avoid common protobuf error definition pitfalls in Kratos. Learn to correctly annotate enums, use valid HTTP codes, and ensure the protoc-gen-go-errors plugin runs for seamless error handling.

- Tags: best-practices
- Published: 2026-03-02

### [How the Graceful Shutdown Mechanism Works in Kratos Application Lifecycle](/go-kratos/kratos/kratos-graceful-shutdown-mechanism)

Understand Kratos graceful shutdown. Learn how Kratos orchestrates signal handling pre-stop hooks deregistration context cancellation post-stop hooks and server stops.

- Tags: internals
- Published: 2026-03-02

### [Performance Implications of Using a Kratos Middleware Chain: Optimization Guide](/go-kratos/kratos/kratos-middleware-chain-performance-optimization)

Explore Kratos middleware chain performance implications. Learn optimization techniques like zero-allocation patterns to minimize latency and boost your go-kratos application.

- Tags: performance
- Published: 2026-03-02

### [What Are the Key Differences Between gRPC and HTTP Server Implementations in Kratos?](/go-kratos/kratos/kratos-grpc-vs-http-server-differences)

Explore Kratos gRPC vs HTTP server differences. Understand routing, middleware patterns, and protocol features for robust Go applications. Learn key implementation distinctions.

- Tags: deep-dive
- Published: 2026-03-02

### [How Kratos Manages and Propagates Metadata Across Microservices: Context Flow Explained](/go-kratos/kratos/kratos-manage-metadata-propagation)

Discover how Kratos manages and propagates metadata across microservices using context flow. Learn to bind request-level key-value pairs via HTTP/gRPC headers for efficient interservice communication.

- Tags: internals
- Published: 2026-03-02

### [How to Integrate Third-Party Logging Libraries (Zap, Zerolog) with Kratos](/go-kratos/kratos/kratos-integrate-third-party-logging-libraries)

Integrate third-party logging libraries like Zap or Zerolog with Kratos. Implement Kratos's logger interface using contrib adapters for seamless integration. Optimize your Kratos application logging.

- Tags: how-to-guide
- Published: 2026-03-02

### [Default Content Encoding Formats in Kratos and How to Add Custom Codecs](/go-kratos/kratos/kratos-content-encoding-formats-customization)

Explore Kratos default content encoding formats JSON Proto YAML XML Form and learn how to add custom codecs by implementing the Codec interface in Go

- Tags: how-to-guide
- Published: 2026-03-02

### [How the Ratelimit Middleware in Kratos Enforces Request Throttling](/go-kratos/kratos/kratos-ratelimit-middleware-enforcement)

Discover how Kratos ratelimit middleware enforces request throttling and limits. Learn about its pluggable limiter interface and HTTP 429 responses for denied requests.

- Tags: how-to-guide
- Published: 2026-03-02

### [How to Implement JWT Authentication Middleware in Kratos](/go-kratos/kratos/kratos-implement-jwt-authentication-middleware)

Implement JWT authentication middleware in Kratos easily. Discover Kratos advanced JWT middleware for secure server-side token validation and client-side generation.

- Tags: how-to-guide
- Published: 2026-03-02

### [Recommended Project Structure and Layout for a Kratos Microservice](/go-kratos/kratos/kratos-microservice-project-structure)

Discover the recommended Kratos microservice project structure. Utilize kratos new for a layered layout with distinct biz data and service directories, optimizing your development with go-kratos.

- Tags: best-practices
- Published: 2026-03-02

### [How to Use and Configure the Circuit Breaker Middleware in Kratos](/go-kratos/kratos/kratos-circuit-breaker-middleware-configuration)

Learn how Kratos circuit breaker middleware protects services from cascading failures. Discover configuration options WithGroup and WithCircuitBreaker for optimal performance.

- Tags: how-to-guide
- Published: 2026-03-02

### [Kratos Protobuf Error Handling: Defining Typed Errors for gRPC and HTTP Services](/go-kratos/kratos/kratos-handle-errors-protobuf-definitions)

Learn Kratos Protobuf error handling. Define typed errors for gRPC and HTTP services, coupling status codes with machine-readable reasons for type-safe error propagation.

- Tags: how-to-guide
- Published: 2026-03-02

### [How to Implement Distributed Tracing with OpenTelemetry in Kratos](/go-kratos/kratos/kratos-implement-distributed-tracing-otel)

Learn how to implement distributed tracing with OpenTelemetry in Kratos. Kratos middleware automatically creates spans, propagates context, and injects trace IDs into logs for seamless observability.

- Tags: how-to-guide
- Published: 2026-03-02

### [How to Configure Dynamic Configuration Sources in Kratos: File, Etcd, Consul, and Apollo](/go-kratos/kratos/kratos-configure-dynamic-configuration-sources)

Learn to configure dynamic configuration sources like file, etcd, consul, and Apollo in Kratos. Hot-reload your application settings without restarts using Kratos's config.Source interface and Watch method.

- Tags: how-to-guide
- Published: 2026-03-02

### [How Kratos Supports HTTP and gRPC Transports Simultaneously in a Single Service](/go-kratos/kratos/kratos-dual-http-grpc-transport-support)

Learn how Kratos enables simultaneous HTTP and gRPC support within a single service. Discover the unified transport interface that aggregates and manages multiple listeners efficiently.

- Tags: internals
- Published: 2026-03-02

### [How to Define and Apply Custom Middleware Chains in Kratos: A Complete Guide](/go-kratos/kratos/kratos-custom-middleware-chains)

Master Kratos middleware chains. Implement custom MWs, chain them with middleware.Chain, and apply globally or selectively. Enhance your Kratos app now.

- Tags: how-to-guide
- Published: 2026-03-02

### [Load Balancing Strategies in the Kratos Selector Package: A Complete Guide](/go-kratos/kratos/kratos-selector-load-balancing-strategies)

Explore Kratos selector package load balancing strategies: Random, WRR, and Pick-Two-Choices. Distribute RPC calls efficiently across service instances with this comprehensive guide.

- Tags: deep-dive
- Published: 2026-03-02

### [How Kratos Integrates with Service Discovery and Registry Patterns (etcd, Consul)](/go-kratos/kratos/kratos-service-discovery-registry-integration)

Learn how Kratos uses pluggable components for service discovery and registry integration with etcd and Consul. Discover seamless backend implementation.

- Tags: deep-dive
- Published: 2026-03-02