AWS X-Ray

追蹤 API 或 Lambda 處理在何處變慢的服務。

AWS X-Ray 是將分散式應用程式的請求路徑與處理時間視覺化的追蹤服務。

• 無伺服器 API 的追蹤
• 微服務的延遲調查
• 故障時的根因分析

• 屬於分散式追蹤服務
• 用於效能問題的調查
• 與 CloudWatch Logs 的角色不同

• 可與 API Gateway 及 Lambda 整合
• 可將服務之間的瓶頸視覺化
• MVP 階段多半使用 CloudWatch Logs 即足夠

AWS X-Ray 是將分散式應用程式的請求路徑與處理時間視覺化的分散式追蹤服務。在 API Gateway → Lambda → DynamoDB 的無伺服器構成,或 ALB → ECS → RDS 的微服務構成中,記錄 1 個請求通過各元件的路徑,以及各元件的處理時間(延遲)、錯誤資訊。在 X-Ray 主控台可將整體圖像以服務地圖視覺化,以請求單位追蹤哪個服務間呼叫較慢、何處發生錯誤。 啟用 X-Ray 需在應用程式程式碼端納入 X-Ray SDK,或啟用對象服務的 X-Ray 追蹤功能。Lambda、API Gateway、ALB、SQS、SNS 等主要服務僅需在主控台端啟用追蹤,資料即會送至 X-Ray。納入 SDK 時,可記錄獨自的子區段(外部 API 呼叫或 DB 查詢等),以更細緻粒度找出瓶頸。透過設定取樣率,可控制作為追蹤對象的請求比例,抑制成本。 需整理與 CloudWatch Logs 角色的差異。CloudWatch Logs 彙整「各別服務的文字日誌」,X-Ray 則將「跨多個服務的請求執行路徑與處理時間」視覺化。故障調查時兩者並用,以 X-Ray 找出何處較慢、何處失敗,以 CloudWatch Logs 確認對應位置的詳細日誌的流程很常見。費用為記錄追蹤數與取得追蹤數的從量計費,每月有一定量的免費使用額度。CLF-C02 中,「X-Ray = 分散式追蹤」「用於 Lambda 或 API Gateway 的延遲調查」「與 CloudWatch Logs 角色不同」的整理為常見論點。

• 什麼是 AWS X-Ray (AWS 官方文件)
• AWS X-Ray 的概念 (AWS 官方文件)

最後更新日: 2026-06-07