logging-tracing-design

Define logging and tracing design with structured JSON logs and OpenTelemetry integration.

1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/SSiertsema/claude-code-plugins --skill logging-tracing-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: logging-tracing-design
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/logging-tracing-design/skills/logging-tracing-design
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill logging-tracing-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Logging and tracing design standardizes how services emit logs and traces to enable incident investigation and user journey tracking, reducing guesswork and firefighting.

Core Features & Use Cases

  • Structured JSON logs with trace correlation, OpenTelemetry spans, and proper data governance
  • W3C Trace Context propagation across service boundaries and async boundaries
  • Tailored sampling strategies for errors and latency, plus log↔trace linking
  • PII redaction and retention policies to meet compliance
  • End-to-end observability across components, runtimes, and backends

Quick Start

Configure a service to emit JSON logs with trace_id and span_id on every log line, integrate OpenTelemetry, and apply a PII redaction policy with a defined retention policy.

Frequently Asked Questions about logging-tracing-design

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

FAQPage Schema
How do I design structured JSON logging with OpenTelemetry trace correlation for a service?

Structured logging with OpenTelemetry trace correlation is designed by emitting JSON logs containing trace_id and span_id on every log line, integrating OpenTelemetry spans, and propagating W3C Trace Context across service and async boundaries for end-to-end traceability.

What is the best way to propagate W3C Trace Context across async boundaries in microservices?

W3C Trace Context propagation across async boundaries is handled by defining a comprehensive tracing design that applies OpenTelemetry integration across components and runtime environments, ensuring traceability and correlation throughout real deployments.

How do I implement PII redaction and retention policies for log aggregation?

PII redaction and retention policies for log aggregation are implemented by applying compliant data handling rules within the logging design, ensuring deterministic log schemas meet governance requirements across all emitted JSON logs.

How do I set up sampling strategies for errors and latency in tracing?

Sampling strategies for errors and latency are configured by defining tailored sampling rules within the tracing design, linking logs to traces to enable quick incident investigation and user journey tracking without guesswork.

Do I need OpenTelemetry to achieve end-to-end observability across multiple runtime environments?

OpenTelemetry is needed to achieve end-to-end observability across multiple runtime environments because it provides the span integration and W3C Trace Context propagation required to correlate logs and traces across service boundaries and backends.

Why does my logging and tracing design lack traceability across service boundaries?

Your logging and tracing design lacks traceability across service boundaries because it needs a deterministic log schema with trace_id and span_id correlation, W3C Trace Context propagation, and consistent OpenTelemetry integration across all components.