Skip to content

sb-dev/openquant / .agents/skills/otel-instrumentation

otel-instrumentation

Verified

Configures trace spans, defines custom metrics, sets up log exporters, and optimizes sampling strategies for OpenTelemetry instrumentation. Use when instrumenting applications with traces, metrics, or logs. Triggers on requests for observability, telemetry, tracing, metrics collection, logging integration, or OTel setup.

FileKindSize
README.mdmarkdown4.8 KB
SKILL.mdskill md6.0 KB
rules/capture-database-query-parameters.mdmarkdown4.9 KB
rules/logs.mdmarkdown10.1 KB
rules/metrics.mdmarkdown22.7 KB
rules/platforms/k8s.mdmarkdown7.7 KB
rules/resolve-values.mdmarkdown11.3 KB
rules/resources.mdmarkdown10.9 KB
rules/sdks/browser.mdmarkdown5.2 KB
rules/sdks/dotnet.mdmarkdown20.6 KB
rules/sdks/go.mdmarkdown29.9 KB
rules/sdks/java.mdmarkdown17.2 KB
rules/sdks/nextjs.mdmarkdown16.2 KB
rules/sdks/nodejs.mdmarkdown24.7 KB
rules/sdks/php.mdmarkdown16.2 KB
rules/sdks/python.mdmarkdown18.4 KB
rules/sdks/ruby.mdmarkdown15.1 KB
rules/sdks/scala.mdmarkdown23.6 KB
rules/sensitive-data.mdmarkdown16.2 KB
rules/spans.mdmarkdown32.0 KB
rules/telemetry.mdmarkdown2.1 KB
rules/validation.mdmarkdown8.9 KB
rules/verify-dependencies.mdmarkdown6.6 KB

rules/telemetry.md

View on GitHub
---
title: 'Telemetry overview'
impact: CRITICAL
tags:
  - telemetry
  - overview
---

# Telemetry overview

This is the entrypoint for the OpenTelemetry instrumentation skill.
Start here, then follow the links below to the relevant rule files.

## Before you instrument

**[Resolve configuration values](./resolve-values.md) first.**
Every instrumentation setup requires project-specific values (`service.name`, `service.version`, `deployment.environment.name`, OTLP endpoint, auth token).
Use the ordered lookup strategies in that file to infer them from the codebase before writing any instrumentation code.

**[Resource attributes](./resources.md) identify what produces telemetry.**
They are attached to every signal automatically and must be set correctly before any other instrumentation work.

## Signals

Telemetry consists of three core signal types: **Metrics**, **Traces**, and **Logs**.
Each serves a distinct purpose in understanding system behavior.

| Signal  | When to use                                                         | Reference |
| ------- | ------------------------------------------------------------------- | --------- |
| Metrics | Alerting, SLOs, dashboards, trend analysis, capacity planning       | [metrics](./metrics.md) |
| Traces  | Request flow, latency breakdown, dependency mapping, error locality | [spans](./spans.md) |
| Logs    | Audit trails, event detail, causation after traces localize a fault | [logs](./logs.md) |

**Symptom-to-cause workflow:** Metrics surface problems → Traces pinpoint location → Logs explain causation.

**Correlation is essential.**
Link signals through shared context (trace IDs, span IDs) so you can navigate from an alert to the exact log line that explains the failure.

## Platforms

| Platform   | Reference |
| ---------- | --------- |
| Kubernetes | [Kubernetes deployment](./platforms/k8s.md) |

## References

- [Metrics](https://opentelemetry.io/docs/concepts/signals/metrics/)
- [Traces](https://opentelemetry.io/docs/concepts/signals/traces/)
- [Logs](https://opentelemetry.io/docs/concepts/signals/logs/)
- [Semantic Conventions](https://opentelemetry.io/docs/specs/semconv/)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall