@mobrienv/pi-otlp
为pi-coding-agent提供OpenTelemetry指标与事件追踪扩展
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@mobrienv/pi-otlp。 它的用途是：为pi-coding-agent提供OpenTelemetry指标与事件追踪扩展 完整的 Skill 内容见：https://321skill.com/skills/mobrienv-pi-otlp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“启用OTLP扩展并配置导出到jaeger-collector:4318”，它会在你后续使用pi-coding-agent进行代码生成或重构时，自动将耗时、步骤等指标发送到指定的Jaeger后端，方便你在仪表盘上查看和分析整个AI辅助编码过程。
介绍
这个Skill为pi-coding-agent集成了OpenTelemetry（OTLP）协议支持，解决了在AI驱动的编码过程中缺乏可观测性的问题。它允许开发者将Agent执行过程中的关键指标（如代码生成耗时、工具调用次数）和结构化事件（如任务开始、错误发生）导出到兼容OpenTelemetry的后端系统（如Jaeger、Prometheus），从而实现性能监控、问题诊断和流程分析。
使用方式非常简单，在pi-coding-agent的配置中引入此扩展并配置好OTLP Collector的端点即可。Skill会自动在Agent执行的关键节点注入遥测数据收集逻辑，无需修改核心业务代码。数据导出支持常见的HTTP/gRPC协议，并能与现有的可观测性技术栈无缝集成。
它非常适合追求研发效能和系统稳定性的技术团队、DevOps工程师以及对AI辅助编码过程有深度分析和优化需求的开发者。通过它，团队可以量化AI编码助手的工作效率，定位瓶颈，并建立更可靠的自动化开发流程。
建议在已经部署或计划部署OpenTelemetry技术栈的环境中使用。需要注意，此扩展主要提供数据导出能力，本身不包含数据存储、展示或告警功能，因此需要配合相应的后端服务使用。初次使用时，请确保网络能够访问配置的OTLP Collector，并注意导出数据量可能对网络和存储产生的开销。
核心特点
这是首个专为pi-coding-agent设计的OpenTelemetry扩展，将AI编码Agent的内部运作过程标准化为可观测性数据；它直接对接OTLP标准协议，而非私有格式，使得监控数据能立即融入企业现有的全链路追踪与指标监控体系。
注意事项
不适合没有部署或不愿维护OpenTelemetry后端（如Collector、Jaeger、Prometheus）的轻量级或个人简单使用场景。
常见问题
这个扩展支持导出哪些类型的遥测数据？
主要支持指标（Metrics）和事件（Events）的导出，例如任务执行时长、工具调用次数、错误事件等。
需要自己搭建OpenTelemetry后端吗？
是的，需要自行部署兼容OTLP协议的Collector以及如Jaeger、Prometheus等后端用于接收、存储和展示数据。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mobrienv-pi-otlp/raw/index.md 读取 @mobrienv/pi-otlp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mobrienv-pi-otlp/raw/index.md（查看排版版本）