log-design-guidelines

Standardize OTEL-compliant logging design for Go applications.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/taiga-K/awesome-backend-template --skill log-design-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: log-design-guidelines
Source: https://github.com/taiga-K/awesome-backend-template/tree/main/.cursor/skills/log-design-guidelines
Command: npx skills add https://github.com/taiga-K/awesome-backend-template --skill log-design-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes application logging design to ensure consistent, OTEL-compliant log messages across Go projects, enabling reliable observability and cost awareness in both cloud and local environments.

Core Features & Use Cases

  • OTEL-aligned keys using English dot.case for interoperability with tracing and metrics.
  • Go-friendly logging patterns focusing on log/slog, level handling, masking, and layout conventions.
  • Use Case: When adding a new Go API or background job, apply the guidelines to produce consistent, structured logs that facilitate analysis.

Quick Start

Follow the guidelines to implement OTEL-compliant logging in your next Go service task.

Frequently Asked Questions about log-design-guidelines

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

FAQPage Schema
What are OTEL-compliant logging guidelines for Go applications?

OTEL-aligned logging uses English dot.case keys for interoperability with tracing and metrics. This standardization ensures consistent, structured logs across Go projects, facilitating reliable observability and cost awareness in cloud and local environments.

How do I implement structured logging with slog in Go microservices?

Apply Go-friendly logging patterns focusing on log/slog, level handling, masking, and layout conventions. This produces consistent, structured logs for API services and background jobs across cloud environments that facilitate analysis.

When do I need standardized log design for Go background jobs?

You need standardized log design when adding a new Go API or background job to ensure consistent, OTEL-compliant log messages. This enables reliable observability and cost awareness across cloud environments and local development.

Does this logging approach work for both cloud environments and local development?

Yes, this logging approach works for both cloud environments and local development. The guidelines standardize OTEL-compliant logging design across Go applications to ensure consistent observability and cost awareness regardless of environment.

What is the best way to format log keys for OpenTelemetry interoperability in Go?

Use English dot.case for formatting log keys to achieve OpenTelemetry interoperability. This OTEL-aligned key format ensures logs work seamlessly with tracing and metrics across Go applications.

How do I mask sensitive data in Go application logs?

Mask sensitive data by following the guidelines' Go-friendly logging patterns, which include specific conventions for data masking. This ensures consistent, structured logs that protect sensitive information while maintaining observability.