How does this skill help with OpenTelemetry?

It provides specific patterns and mental models for span annotations, helping you determine which attributes to attach to OTel spans to ensure they are useful for future debugging.

What are wide events in observability?

Wide events, or canonical log lines, are single, comprehensive records containing all relevant context—such as user identity, business state, and technical performance—for an operation, optimized for querying rather than just writing.

What is the benefit of high dimensionality?

High dimensionality allows you to add numerous fields to a single event. This enables you to 'slice and dice' your data by any attribute, such as account tier or feature flags, to find specific patterns during an incident.

When should I use the wide-events skill?

Use it when planning new service instrumentation, reviewing code for telemetry coverage, or when you find yourself unable to answer specific questions during a production incident.

Wide Events Observability

Name: Wide Events Observability
Author: front-depiction

byfront-depiction

•

分析と監視

Guides the implementation of high-dimensionality instrumentation and canonical log lines for superior system observability.

This skill provides a conceptual framework and implementation strategy for 'wide events'—comprehensive, structured records that capture full context (business, user, technical, and outcome) within a single span. It helps Claude assist developers in moving away from scattered, low-context logging toward a query-optimized observability strategy using OpenTelemetry. It is particularly useful when designing instrumentation schemas, reviewing span annotations, or debugging complex production incidents where traditional logs fail to provide the necessary context for root cause analysis.

主な機能

01Framework for high-dimensionality span annotations including business and user context

02Identification of common anti-patterns like technical-only or low-dimensionality logging

03Queryability testing to ensure instrumentation answers critical production questions

04Strategies for moving from scattered console logs to canonical log lines

057 GitHub stars

06Guidance on tail sampling and retention for cost-effective observability

ユースケース

01Refactoring existing OpenTelemetry spans to include high-cardinality metadata like User IDs

02Auditing observability coverage to ensure incidents are debuggable without code changes

03Designing a structured logging and instrumentation strategy for new microservices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add front-depiction/claude-setup wide-events

For use in Claude.ai and ChatGPT

Download Skill