otel-observability-mindset

Review .NET 10.0 code for OpenTelemetry instrumentation and Serilog logging consistency.

3|2|Updated Aug 1, 2025
One-click install
npx skills add https://github.com/ClearMeasureLabs/bootcamp-palermo-workorders --skill otel-observability-mindset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: otel-observability-mindset
Source: https://github.com/ClearMeasureLabs/bootcamp-palermo-workorders/tree/main/.claude/skills/otel-observability-mindset
Command: npx skills add https://github.com/ClearMeasureLabs/bootcamp-palermo-workorders --skill otel-observability-mindset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents observability gaps by ensuring new code consistently integrates with the existing OpenTelemetry infrastructure rather than creating fragmented or missing telemetry.

Core Features & Use Cases

  • Standardized Instrumentation: Provides a mental model and checklist for extending existing ActivitySources, Meters, and Serilog-based logging.
  • Boundary Enforcement: Guides developers on how to instrument external dependencies (HTTP, SQL, LLM) and MediatR handlers using the established decorator and tagging patterns.
  • Use Case: When adding a new external API client, use this skill to ensure the client is properly wrapped for tracing, registered in ServiceDefaults, and equipped with appropriate health checks.

Quick Start

Apply the otel-observability-mindset skill to review the proposed changes for a new MediatR handler and verify that all telemetry boundaries are correctly instrumented.

Frequently Asked Questions about otel-observability-mindset

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

FAQPage Schema
How do I add OpenTelemetry tracing to MediatR handlers in .NET?

OpenTelemetry tracing for MediatR handlers in .NET requires using established decorator and tagging patterns to ensure consistent ActivitySource instrumentation. This skill guides developers to verify telemetry boundaries are correctly applied during handler development and code review.

What's the best way to instrument external HTTP and SQL dependencies for observability in .NET?

Instrumenting external dependencies for observability in .NET involves wrapping clients for tracing and registering them in ServiceDefaults with appropriate health checks. This skill provides a checklist to ensure HTTP, SQL, and LLM integrations adhere to existing telemetry patterns.

Why does my .NET application have missing telemetry data in production?

Missing telemetry data in production often occurs when new code fails to integrate with existing OpenTelemetry infrastructure, creating fragmented observability gaps. This skill prevents these gaps by enforcing consistent ActivitySource, Meter, and Serilog logging patterns.

Does this observability skill work with .NET 10.0 and Serilog logging?

Yes, this observability skill is designed specifically for .NET 10.0 applications and requires adherence to established ActivitySource, Meter, and Serilog patterns defined in the repository's ServiceDefaults. It ensures consistent OpenTelemetry-driven operability across the application.

How do I extend existing ActivitySources and Meters without fragmenting OpenTelemetry instrumentation?

Extending existing ActivitySources and Meters without fragmentation requires following the repository's established ServiceDefaults patterns rather than creating new telemetry instances. This skill provides a mental model and checklist for standardized instrumentation across new code.

When should I use OpenTelemetry boundary enforcement for background services?

OpenTelemetry boundary enforcement for background services should be applied whenever developing or reviewing code that interacts with external dependencies or processes asynchronous tasks. This skill ensures background services maintain consistent tracing and logging standards.