mirror of
https://github.com/katanemo/plano.git
synced 2026-05-01 11:56:29 +02:00
34 lines
967 B
Markdown
34 lines
967 B
Markdown
|
---
|
||
|
|
name: plano-observability-debugging
|
||
|
|
description: Improve Plano tracing and debugging workflows. Use for sampling strategy, span attributes, and trace query-based root-cause analysis.
|
||
|
|
license: Apache-2.0
|
||
|
|
metadata:
|
||
|
|
author: katanemo
|
||
|
|
version: "1.0.0"
|
||
|
|
---
|
||
|
|
|
||
|
|
# Plano Observability and Debugging
|
||
|
|
|
||
|
|
Use this skill to make routing and latency behavior inspectable and debuggable.
|
||
|
|
|
||
|
|
## When To Use
|
||
|
|
|
||
|
|
- "Enable tracing correctly"
|
||
|
|
- "Add useful span attributes"
|
||
|
|
- "Debug why a request routed incorrectly"
|
||
|
|
- "Inspect filter/model latency from traces"
|
||
|
|
|
||
|
|
## Apply These Rules
|
||
|
|
|
||
|
|
- `observe-tracing`
|
||
|
|
- `observe-span-attributes`
|
||
|
|
- `observe-trace-query`
|
||
|
|
|
||
|
|
## Execution Checklist
|
||
|
|
|
||
|
|
1. Enable tracing with environment-appropriate sampling.
|
||
|
|
2. Add useful static and header-derived span attributes.
|
||
|
|
3. Use `planoai trace` filters to isolate route and latency issues.
|
||
|
|
4. Prefer trace evidence over assumptions in recommendations.
|
||
|
|
5. Return exact commands to reproduce and validate findings.
|