본문으로 건너뛰기
cccskills
무료GitHub에 공개

logging-best-practices

Expert logging guidance based on Boris Tane's loggingsucks.com philosophy. Use when implementing logging, adding observability, debugging production issues, or reviewing code that includes log statements. Covers wide events architecture, structured logging, smart sampling, and high-cardinality field design.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(13)

  • SKILL.md2.7 KB
  • metadata.json695 B
  • rules/_sections.md910 B
  • rules/antipattern-otel-silver-bullet.md4.1 KB
  • rules/antipattern-scattered-logs.md3.7 KB
  • rules/antipattern-string-search.md3.6 KB
  • rules/architecture-event-lifecycle.md4.0 KB
  • rules/architecture-wide-events.md2.7 KB
  • rules/fields-business-context.md3.9 KB
  • rules/fields-high-cardinality.md3.5 KB
  • rules/fields-required-context.md3.5 KB
  • rules/sampling-always-keep.md3.9 KB
  • rules/sampling-tail-sampling.md3.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Logging Best Practices

Expert guidance for production-grade logging based on Boris Tane's loggingsucks.com philosophy.

Core Philosophy

Stop logging "what your code is doing." Start logging "what happened to this request."

Traditional logging is optimized for writing, not querying. Developers emit logs for immediate debugging convenience without considering how they'll be searched later. This creates massive signal-to-noise ratios at scale.

The Wide Events Architecture

Instead of scattered log statements throughout your code, build one comprehensive event per request per service:

// ❌ Traditional scattered logging
logger.info("Request started");
logger.info(`User ${userId} found`);
logger.info("Fetching cart");
logger.debug(`Cart has ${items.length} items`);
logger.info("Processing payment");
logger.error(`Payment failed: ${error.message}`);

// ✅ Wide event - build throughout request, emit once
const event = {
  request_id: req.id,
  timestamp: Date.now(),
  service: "checkout",
  version: "2.3.1",

  user: { id: userId, tier: "premium", account_age_days: 847 },
  cart: { id: cartId, item_count: 3, total_cents: 15999 },
  payment: { method: "card", provider: "stripe", latency_ms: 234 },

  outcome: "failure",
  error: { type: "PaymentDeclined", code: "card_declined", retriable: true }
};

logger.info(event);

Key Concepts

ConceptDefinition
Wide EventOne comprehensive, context-rich log per request per service
CardinalityNumber of unique values (user IDs = high, HTTP methods = low)
DimensionalityCount of fields per event (aim for 40+ meaningful fields)
Tail SamplingSample decisions after request completion based on outcomes

When to Apply This Skill

  • Implementing logging in new services
  • Reviewing code with log statements
  • Debugging production issues
  • Designing observability strategy
  • Migrating from printf-style to structured logging
  • Reducing log volume while improving queryability

What This Skill Provides

  1. Wide event patterns for different frameworks and languages
  2. Field design guidance for high-cardinality debugging
  3. Sampling strategies that preserve signal
  4. Anti-pattern detection in existing logging code
  5. Query-first thinking for log architecture

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Expert full-cycle enterprise sales strategist for B2B SaaS. Use when planning sales strategy, pipeline management, deal progression, account planning, competitive displacement, or territory optimization. Covers multi-threading, executive engagement, champion development, buying committee navigation, and complex deal orchestration. Use for enterprise selling, account expansion, land-and-expand, and quota attainment.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ncklrs/startup-os-skills522026년 2월 27일 업데이트

adr

무료

Expert Architecture Decision Record (ADR) creation and lifecycle management based on Olaf Zimmermann's methodology. Use when creating ADRs, reviewing architectural decisions, evaluating decision readiness, writing MADR templates, assessing decision quality, or managing ADR logs. Covers the full lifecycle from readiness (START criteria) through creation, MADR formatting, completion (ECADR criteria), and ongoing maintenance.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ncklrs/startup-os-skills522026년 2월 27일 업데이트

Hand off code review to OpenAI Codex CLI. Use when asked to "review code with codex", "codex review", "get a second opinion on code", "review my changes", "review this PR", or when you want AI-powered code review from a different model perspective.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ncklrs/startup-os-skills522026년 2월 27일 업데이트

Expert community-led growth and community management guidance. Use when building developer communities, Discord/Slack communities, online communities, managing community platforms, designing member onboarding, creating engagement programs, running ambassador programs, measuring community health, setting up moderation systems, or implementing DevRel strategies. Use for community-led growth, member activation, user-generated content programs, and community governance.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ncklrs/startup-os-skills522026년 2월 27일 업데이트

Expert competitive intelligence and strategy guidance for B2B/SaaS companies. Use when conducting competitive research, creating battlecards, analyzing win/loss data, building market landscape maps, positioning against alternatives, handling competitive objections, writing comparison pages, or developing sales enablement for competitive situations. Use for competitive monitoring, feature comparisons, and market intelligence gathering.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ncklrs/startup-os-skills522026년 2월 27일 업데이트

Master orchestrator that chains all Remotion video creation skills together in a single automated pipeline. Takes a creative brief and produces a complete, production-ready Remotion video project. Use when starting a new video from scratch, when asked to "create a video", "make a video", "build a complete video", or "video from idea to code".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ncklrs/startup-os-skills522026년 2월 27일 업데이트

ncklrs의 스킬 모두 보기

이 스킬의 문제 신고