x-observability
OfficialBootstrap observability for every new operation.
System Documentation
What problem does it solve?
This Skill ensures consistent OpenTelemetry observability when you add new external operations, adapter packages, or server middleware, so traces and metrics are meaningful and middleware ordering doesn’t hide failures.
Core Features & Use Cases
- App-level monitoring bootstrap: initialize monitoring via monitoring.InitDefault with safe shutdown semantics.
- Package-level tracer/meter discipline: define one tracer and one meter per package and use consistent span naming like packageName.Operation.
- HTTP/gRPC/GraphQL observability ordering: set middleware/interceptors order so monitoring is outer to recovery, preserve parent spans for GraphQL, and follow the established gRPC middleware chain.
- Meaningful telemetry only: add spans and metrics only where they reflect real request/error/latency signals, avoiding sensitive data in span attributes.
Quick Start
Add observability for your new adapter or middleware by wiring monitoring.InitDefault at the application bootstrap, creating a package tracer/meter with consistent span names, and placing HTTP monitoring outside recovery while keeping GraphQL as a child of the HTTP monitoring span.
Dependency Matrix
Required Modules
None requiredComponents
Standard packageđź’» Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: x-observability Download link: https://github.com/pure-golang/level85/archive/main.zip#x-observability Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.