什麼是 PingPulse？

PingPulse 是一個專門建置的監控平台，旨在提供對複雜、分散式系統的深入可視性，而這些系統往往是傳統監控工具所遺漏的。其核心重點在於追蹤自主 AI 代理、多步驟工作流程（如 CI/CD 或 ETL 管道）和排程任務。透過使用簡單的 HTTP 網路鉤子（或稱「脈衝/pulse」），PingPulse 會監控階段之間的交接，確保您能立即知道某個步驟何時失敗、停滯或執行順序錯誤。

與通用監控解決方案不同，PingPulse 專為代理系統的獨特挑戰而設計，例如追蹤 Token 使用量、工具呼叫以及確保人工介入（Human-in-the-Loop）批准得到正確處理。它消除了在每個元件上安裝複雜 SDK 或代理的需求，提供輕量級、單行整合方法，可在整個分散式過程中實現毫秒級的精確計時和全面的階段式可視性。

關鍵功能

• 代理可觀察性： 針對 AI 代理的專業追蹤，包括每個階段的成本和 Token 追蹤、詳細的工具呼叫追蹤，以及敏感資料（PII、API 金鑰）的負載資料隱藏。
• 工作流程可觀察性（DAG 追蹤）： 監控跨任何系統（CI/CD、ETL、分散式服務）的多步驟流程。功能包括階段式可視性、嚴格/彈性排序模式和即時故障隔離。
• 無需 SDK： 整合是透過簡單的 HTTP 請求（網路鉤子/pulses）實現的，使其與幾乎任何系統、語言或排程工作（Cron、Airflow、GitHub Actions）相容。
• 智慧警報： 在步驟失敗、停滯或錯過排程工作時立即收到通知。支援 11 個通知通道，包括電子郵件、Slack、PagerDuty 和簡訊。
• 交接洞察儀表板： 透過顏色編碼的代理、清晰的交接箭頭和毫秒級精確計時數據，可視化代理或程序之間的控制流程。
• 人工介入（NEW）： API 支援允許 AI 代理暫停執行並透過 API 呼叫請求人工批准，無縫整合到自動化工作流程中。
• 程序鉤子（Process Hooks）： 使用兩個網路鉤子（一個用於開始，一個用於確認完成）觸發和監控外部腳本（建置、部署、遷移），並提供內建的超時警報。

如何使用 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. 分散式系統健康檢查： 追蹤分散式元件的定期腳本或物聯網設備簽到（check-in）的健康狀況和執行計時，確保背景維護任務可靠運行。

常見問題 (FAQ)

問：我需要在我的伺服器或容器上安裝代理或 SDK 嗎？ 答：不需要。PingPulse 完全透過簡單的 HTTP 請求（網路鉤子）運行。您只需要能夠從您希望監控的流程點發出 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 個工作流程，無需信用卡即可開始使用。