@datadog/pi-plugin

Datadog 官方 Pi 插件,通过预配置 Datadog MCP Server 让 Agent 在终端里直接查线上日志、指标与 Trace。

安装命令
pi install npm:@datadog/pi-plugin
临时试用 / 替代安装命令
pi -e npm:@datadog/pi-plugin
挂接事件钩子与注册入口
session_startbefore_agent_startsession_treesession_shutdown
预配置远程 Datadog MCP Server 注册pi.registerCommand("datadog")(组织连接与切换界面)pi.appendEntry()(保存会话上下文状态)

1. 是什么

@datadog/pi-plugin 是 Datadog Labs 官方开源的 Pi 集成插件。

与其他“把 Pi 执行轨迹向外上报”的扩展不同,它是把线上运维系统(Datadog)的实时观测能力接进 Pi 对话,用来辅助排障。

2. 解决什么问题

线上告警或接口报错时,开发者常要在浏览器里翻 Datadog 日志、切回代码库找对应 Handler、再回来看指标曲线。

该插件让 Pi 在排查 Bug 时自己去查指定服务最近一小时的错误日志、监控面板与告警状态,再结合本地源码给出定位结果。

3. 作用原理(事件钩子与工具注册层)

内置极简扩展入口与预配置 Datadog MCP 服务连接管理,完成多组织 OAuth 授权后向模型暴露 Datadog 查询工具。

  • 安装后输入 /datadog,选择目标 Datadog 站点(如 US1 / EU / US5 等)并拉起浏览器完成 OAuth 授权,首个组织自动设为默认连接,凭证跨项目持久化并静默刷新 Token。
  • 授权完成后,扩展通过内置的预配置 MCP 通道向模型提供查询日志、指标、Trace、Monitor 与 Dashboard 的工具。
  • 在排查生产问题时,可直接用自然语言提问(如“Show me error logs for the checkout service from the last hour”),若接有多个 Datadog 组织可通过 /datadog 的可搜索菜单切换。

4. 怎么装与基本配置

  • 运行 pi install npm:@datadog/pi-plugin 并重启 Pi,接着在会话中运行 /datadog 完成一次浏览器站点登录。
  • 普通查询不会再次弹窗,仅当授权过期或被吊销时,重开 /datadog 选择 Sign in again 即可。

5. 和同类怎么选

在可观测方向中,它代表“生产环境运维可观测性接入 Agent”这一条分支,用于接入业务系统生产监控,与记录 Agent 自身链路互补。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
@langchain/langsmith-pi-extension LangSmith 监控的是“Pi 自己跑得怎么样(每轮提示、工具耗时与 token)”;Datadog 插件是“让 Pi 去查你业务系统的线上监控数据”。 排错线上微服务故障选 @datadog/pi-plugin;调试和优化 Agent 自身行为选 LangSmith / Langfuse / Braintrust。
@agimon-ai/po-logsink po-logsink 是本地轻量 HTTP 日志摄入 MCP 服务,适合开发测试期在本地汇总应用日志给 Agent 看。 线上接 Datadog 集群选 @datadog/pi-plugin;本地开发接直出 HTTP 日志流选 @agimon-ai/po-logsink。

同方向对比包与顺序阅读

@langchain/langsmith-pi-extension

LangChain 官方出品的 Pi 链路追踪扩展,把会话轮次、模型请求、工具调用与 token 用量自动上报至 LangSmith。

阅读该包机制详评

@narumitw/pi-usage

在 Pi 内部查看各模型服务商订阅配额、重置倒计时、API 余额与 Codex Fast 模式开关的用量面板。

阅读该包机制详评

07 可观测与用量

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@datadog/pi-plugin」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)