什么是 PingPulse？

PingPulse 是一个专为复杂、分布式系统设计的专用监控平台，这些系统往往是传统监控工具所忽略的。其核心重点在于跟踪自主 AI 智能体、多步骤工作流（如 CI/CD 或 ETL 管道）和计划任务。通过使用简单的 HTTP Webhook（或“脉冲”），PingPulse 监控各个阶段之间的交接情况，确保您能立即知道某个步骤何时失败、停滞或执行顺序错误。

与通用监控解决方案不同，PingPulse 专为智能体系统的独特挑战而设计，例如跟踪 Token 使用量、工具调用以及确保人工干预（Human-in-the-Loop）审批得到正确处理。它消除了在每个组件上安装复杂 SDK 或代理的需求，提供了一种轻量级的、单行集成的方案，可在整个分布式过程中实现毫秒级的精确计时和全面的分阶段可见性。

核心特性

• 智能体可观测性： 针对 AI 智能体的专业跟踪，包括每个阶段的成本和 Token 跟踪、详细的工具调用追踪，以及敏感数据（PII、API 密钥）的有效载荷脱敏。
• 工作流可观测性（DAG 跟踪）： 监控跨任何系统的多步骤流程（CI/CD、ETL、分布式服务）。功能包括分阶段可见性、严格/灵活的顺序模式以及即时故障隔离。
• 无需 SDK： 集成通过简单的 HTTP 请求（Webhooks/Pulses）实现，使其与几乎任何系统、语言或计划作业（Cron、Airflow、GitHub Actions）兼容。
• 智能警报： 当某个步骤失败、停滞或错过计划作业时，立即收到通知。支持 11 种通知渠道，包括电子邮件、Slack、PagerDuty 和短信。
• 交接洞察仪表板： 通过彩色编码的智能体、清晰的交接箭头和毫秒级精度的时间数据，可视化智能体或进程之间的控制流。
• 人工干预（NEW）： API 支持允许 AI 智能体暂停执行并通过 API 调用请求人工批准，无缝集成到自动化工作流中。
• 流程钩子（Process Hooks）： 使用两个 Webhook（一个用于启动，一个用于确认完成）来触发和监控外部脚本（构建、部署、迁移），并提供内置的超时警报。

如何使用 PingPulse

开始使用 PingPulse 设计得非常快速，并且不需要复杂的设置：

1. 获取您的 API 密钥： 注册一个账户，并从仪表板中检索您的唯一 API 密钥（以 ppk_ 开头）。
2. 与您的系统集成： 对于工作流中的每个阶段（AI 智能体步骤、脚本执行或管道阶段），添加单行代码——通常是一个 curl 命令——向 PingPulse 端点发送 ping。此 ping 包含您的 API 密钥和一个阶段标识符（例如 stage=build）。
3. 配置通知： 在 PingPulse 仪表板中设置您首选的通知渠道（Slack、电子邮件等），以确保在任何阶段未能报告或顺序出错时立即收到警报。
4. 监控和分析： 在仪表板上查看实时状态、计时数据和交接可视化。对于 AI 智能体，请审查每个阶段的成本指标和工具使用情况，以优化性能和预算。

用例

1. 智能体工作流调试： 构建多智能体系统的团队（例如使用 CrewAI 或 AutoGen）使用 PingPulse 来追踪复杂的决策树，识别哪个智能体未能执行所需的工具调用，并监控昂贵 LLM 阶段的 Token 消耗。
2. CI/CD 管道监控： 通过跟踪 build、test 和 deploy 等阶段来确保部署的完整性。如果 test 阶段从未发送其 ping，PingPulse 会立即向团队发出警报，防止有缺陷的代码进入生产环境。
3. 数据工程 ETL 作业： 监控夜间或每小时的 ETL 流程。如果一个通常每小时运行的计划作业错过了预期的 ping，PingPulse 会在数据新鲜度 SLA 受到影响之前通知数据工程团队。
4. 人工干预审批： 对于受监管的行业，PingPulse 会跟踪 AI 智能体何时暂停以等待人工签署（例如，对于金融交易或关键基础设施变更），确保在收到明确的人工批准（通过 API）之前流程不会继续。
5. 分布式系统健康检查： 跟踪分散式组件中定期脚本或 IoT 设备签入的运行状况和执行时间，确保后台维护任务可靠运行。

常见问题 (FAQ)

问：我需要在我的服务器或容器上安装代理或 SDK 吗？ 答：不需要。PingPulse 完全通过简单的 HTTP 请求（Webhooks）运行。您只需要从希望监控的流程点能够发出 HTTP 调用（如 curl）即可。

问：PingPulse 如何处理阶段间传递的敏感数据？ 答：PingPulse 提供内置的有效载荷脱敏功能。您可以配置它自动从仪表板上记录的数据中删除电子邮件、API 密钥或 PII 等敏感信息，确保合规性和安全性。

问：工作流脉冲（Workflow Pulse）和心跳脉冲（Heartbeat Pulse）有什么区别？ 答：工作流脉冲（/shk/）用于跟踪定义流程（如管道）中的顺序阶段。心跳脉冲（/hbk/）通常用于监控应定期、按预期间隔报告的计划作业或服务。

问：是否有方法跟踪与我的 AI 智能体步骤相关的成本？ 答：是的。PingPulse 的智能体可观测性功能允许您在给定阶段的 POST 请求中传递 input_tokens、output_tokens 和计算出的 cost_usd 等指标，从而汇总工作流的总成本。

问：PingPulse 是否提供免费套餐用于测试？ 答：是的，PingPulse 提供免费套餐，包括 20 个脉冲、5 个流程监控器和 1 个工作流，无需信用卡即可开始使用。