Python Observability

Use when instrumenting Python services with structured logs, metrics, traces, correlation IDs, dashboards, or production diagnostics.

9 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill python-observability
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/python-observability ~/.claude/skills/python-observability

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Python Observability

让服务在出问题时回答“发生了什么、影响在哪里、证据有多可靠”,同时控制隐私、成本和噪声。可观测性代码应独立于业务逻辑、可测试、可降级,不能因为 telemetry 失败而阻断业务。

## 使用边界

- 开始前确认 Python/SDK 版本、服务边界、环境、数据分类、日志/指标/trace 后端、保留周期、owner、SLO 和访问权限。
- 默认只读检查现有日志、指标、trace、配置和错误;先在本地/预发布用合成或脱敏流量验证。
- 不擅自修改生产采样、路由、告警、保留策略、网络或服务重启;这些变更需要授权、变更记录和回滚方案。
- 禁止记录 token、密码、cookie、完整请求/响应、原始 prompt、支付数据、邮箱/手机号和稳定用户标识。关联用户时使用短期、不可逆、低基数的受控 ID。

## 观测契约

统一 `service.name`、环境、版本、区域、operation 和 correlation/trace ID。日志使用 JSON 和稳定字段,指标 label 只使用有限枚举(method、route template、status class、dependency),绝不使用 user ID、request ID、URL 原文或任意输入作为 label。

四大黄金信号分别是 latency、traffic、errors、saturation;每个服务边界说明单位、窗口、聚合、采样和告警阈值。日志、metrics 和 traces 各自回答不同问题:不要用日志计数替代可靠指标,也不要把一条 trace 当作全局结论。
Read the full skill on GitHub

Details

Skill name
python-observability
Path
skills/python-observability/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Python Observability skill do?

Use when instrumenting Python services with structured logs, metrics, traces, correlation IDs, dashboards, or production diagnostics.

How do I install the Python Observability skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill python-observability. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Python Observability popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.