Add OpenTelemetry tracing spans to Clojure backend code following Metabase conventions.
npx skills add https://github.com/metabase/metabase --skill add-tracing
Please help me install this Agent Skill. Skill: add-tracing Source: https://github.com/metabase/metabase/tree/main/.claude/skills/add-tracing Command: npx skills add https://github.com/metabase/metabase --skill add-tracing
Instrumenting a large Clojure codebase with OpenTelemetry tracing requires consistent span naming, attribute conventions, module boundary rules, and cyclic dependency avoidance. This Skill codifies Metabase's tracing conventions so spans are added correctly the first time.
tracing/with-span macro using correct groups, dot-notation span names, and namespaced keyword attributes.metabase.tracing.core namespace is required, prevents new tracing namespaces, and avoids cyclic load dependencies via requiring-resolve with literal quoted symbols.best-effort-sanitize-sql so HoneySQL queries appear in traces as parameterized statements without leaking data.:uses config, adding the require, wrapping the I/O boundary, writing enabled/disabled tests, and running clj-kondo lint checks.Add OpenTelemetry tracing spans to my Clojure namespace following the Metabase tracing conventions, then lint and test the changes.
High-intent search queries and answers about installing and using this skill.
Wrap I/O-boundary code with the tracing/with-span macro, passing a group keyword, a dot-notation span name string, an attribute map, and the body. Require only metabase.tracing.core and register new groups with register-group! in tracing/core.clj.
Trace meaningful I/O boundaries: external API calls, database queries, network requests, heavy batch processing, and top-level orchestration functions. Do not trace pure computation, trivial single-row lookups, or every function in a call chain.
Always use tracing/best-effort-sanitize-sql, which converts HoneySQL maps into parameterized SQL strings with ? placeholders so no data leaks. Never put raw SQL strings or user-provided values into span attributes.
tracing/core.clj is required by many modules, so a compile-time require of tracing.settings creates transitive load cycles. Use (requiring-resolve 'metabase.tracing.settings/tracing-enabled) with a literal quoted symbol instead.
No. The defjob macro in metabase.task.impl automatically wraps every Quartz job with a :tasks root span. Only add child spans for I/O operations inside the job body; plain Threads need a manual root span.
octave-commonsStandardize REPL workflows, deps.edn dependencies, testing, and clj-kondo linting for Clojure projects.
Rust-sohamExport TypeScript Golem agent telemetry to an OTLP-compatible collector.
saintgo7Integrate metrics, logs, traces, and error tracking for FastAPI services.
zach-sourceInstruments Python applications with OpenTelemetry for distributed tracing, metrics, and logging.