opentelemetry-ottl
Installation
SKILL.md
OTTL
OpenTelemetry Transformation Language (OTTL) transforms, filters, and routes telemetry inside an OTel Collector pipeline without modifying application code. Load this skill when writing or debugging OTTL statements in the transform processor, filter processor, or routing connector.
When to Use This Skill
| Use case | What to do |
|---|---|
| Change values or fields conditionally | transform processor with the correct context |
| Drop telemetry entirely (match = drop) | filter processor |
| Set static resource attributes everywhere | resource processor — simpler than OTTL |
| Copy a resource field down to spans or logs | transform with the correct context |
| Route telemetry to different pipelines | routing connector |
| Reduce metric or trace cardinality | transform with keep_keys / delete_matching_keys → references/cardinality.md |
| Extract histogram _sum/_count into standalone metrics, then drop the histogram | transform with extract_sum_metric / extract_count_metric in context: metric, then filter to drop the original |
| Redact or pseudonymize PII | transform with SHA256 / replace_all_patterns → references/redaction.md |
| Debug no data, DNS, receiver/exporter issues, or pipeline wiring | Not an OTTL problem — say so before going further |
Related skills