---
name: docxology/telemetry
source: https://app.decimal.ai/s/docxology-telemetry@1/SKILL.md
source_sha256: 7b3192eb3e9e
---

# Telemetry SKILL

This module provides unified pipeline telemetry for the infrastructure layer. It bridges `StagePerformanceTracker` resource metrics with `DiagnosticReporter` validation events into a single `TelemetryCollector`.

## When to Use

- When you need to instrument pipeline stage execution with resource tracking
- When you want a structured end-of-run report combining performance + diagnostics
- When configuring telemetry thresholds for CI warning detection

## API Surface

| Symbol | Type | Purpose |
| --- | --- | --- |
| `TelemetryConfig` | dataclass | Configuration with YAML-loadable `from_dict()` |
| `TelemetryCollector` | class | Main lifecycle: `start_stage()` → `end_stage()` → `finalize()` |
| `StageTelemetry` | dataclass | Per-stage record |
| `PipelineTelemetry` | dataclass | Full report with warnings |
| `PerformanceWarning` | dataclass | Individual anomaly record |