Anthropic bổ sung khả năng xuất trace OpenTelemetry lên Claude Platform

Ngày 14 tháng 10 năm 2026, Anthropic thông báo đã bổ sung khả năng xuất trace OpenTelemetry lên Claude Platform. Giờ đây, nhà phát triển có thể gửi trace từ Claude Managed Agents, Messages API và Claude SDK đến bất kỳ công cụ giám sát nào chấp nhận tiêu chuẩn này; tính năng hiện có trong bản beta công khai.

Trong thông báo của Anthropic, công ty cho biết việc thêm một đích đến trong Claude Console sẽ gửi mọi lượt hoạt động của tác tử, lời gọi mô hình và lần sử dụng công cụ đến công cụ giám sát của người dùng dưới dạng trace OpenTelemetry tiêu chuẩn, kèm độ trễ, số lượng token và mã định danh. Managed Agents và Messages API yêu cầu phải thiết lập đích đến đó trong Console, trong khi Claude SDK tự động xuất trace. Các nhà phát triển vốn đã gửi trace từ Claude Code hoặc Cowork đến một công cụ giám sát có thể xem các tác tử được xây dựng trên Claude Platform tại cùng một nơi.

Anthropic cho biết trace của Claude tuân theo các quy ước ngữ nghĩa GenAI của OpenTelemetry, nhờ đó dữ liệu từ Claude và các nhà cung cấp khác có thể hoạt động trên cùng công cụ và bảng điều khiển. Trace cũng tương thích với mọi công cụ OpenTelemetry chấp nhận điểm cuối OTLP tiêu chuẩn.

Hai cách thiết lập, một mô hình trace

Tài liệu Claude Platform định nghĩa trace là bản ghi đầy đủ về một yêu cầu đi qua hệ thống, còn span là một bước trong trace, chẳng hạn như yêu cầu gửi đến mô hình hoặc lần sử dụng công cụ. Tài liệu mô tả hai cách thiết lập. Có thể cấu hình tính năng ghi trace của SDK trong mã bằng cách cài đặt SDK và đăng ký một nhà cung cấp tracer; cách này không yêu cầu quyền đặc biệt. Có thể cấu hình tính năng ghi trace của API bằng cách thêm một đích đến trong Claude Console; cách này yêu cầu quyền Quản trị viên.

Phạm vi dữ liệu thu thập khác nhau giữa hai cách. Ghi trace qua API thu thập từng lần chạy mô hình trong một yêu cầu, từng lượt của Managed Agents và các công cụ phía máy chủ do API chạy. Ghi trace qua SDK bổ sung dữ liệu về các công cụ phía máy khách do bộ chạy công cụ thực thi, các công cụ trong môi trường sandbox tự lưu trữ và những yêu cầu API khác, chẳng hạn như tải tệp lên. Khi thiết lập cả hai, các span SDK và API của một yêu cầu sẽ nằm trong cùng một trace; riêng với các yêu cầu đến Claude Platform trên AWS, các span API sẽ xuất hiện trong những trace riêng.

Với Managed Agents, mỗi phiên tạo ra một span cho từng yêu cầu Sessions API và một span lượt cho từng lượt của tác tử. Mỗi lượt bao gồm các span cho từng yêu cầu gửi đến mô hình, từng công cụ do API chạy và từng lần đánh giá kết quả. Tài liệu hướng người dùng Claude Code, Agent SDK và Cowork đến tài liệu riêng về giám sát và khả năng quan sát của các sản phẩm đó.

Chế độ nội dung, giới hạn và cách xử lý tuân thủ

Mỗi đích đến và mỗi ứng dụng khách SDK đều có chế độ nội dung, quyết định liệu các span có bao gồm lời nhắc gửi đến mô hình và phản hồi của mô hình hay không. Chế độ Chỉ siêu dữ liệu, được bật mặc định, ghi lại mã định danh, thời gian, trạng thái, số lượng token và nội dung văn bản do người dùng chọn, chẳng hạn như tên và mô tả của tác tử, công cụ và máy chủ MCP. Chế độ Toàn bộ nội dung bổ sung lời nhắc gửi đến mô hình và phản hồi của mô hình.

Ở chế độ Toàn bộ nội dung, theo mặc định, mỗi span chứa tối đa 0.75 MB nội dung. Theo tài liệu, dung lượng này đủ cho cửa sổ ngữ cảnh 200k token bằng tiếng Anh và thấp hơn giới hạn yêu cầu 1 MB của nhiều nền tảng giám sát và máy chủ proxy; cửa sổ ngữ cảnh 1M token đầy đủ cần khoảng 4 MB. Khi nội dung vượt quá giới hạn, SDK hoặc API sẽ rút ngắn nội dung và đặt thuộc tính anthropic.content.truncated thành true. Các span yêu cầu sẽ loại bỏ lời nhắc hệ thống và những tin nhắn cũ nhất trước; hình ảnh và tài liệu chỉ được thể hiện bằng loại nội dung tương ứng.

Đối với các tổ chức có hạn chế về xử lý dữ liệu theo HIPAA, FERPA hoặc K-12 với Anthropic, các đích đến chỉ xuất siêu dữ liệu, bất kể chế độ nội dung đã cấu hình; tuy nhiên, các span SDK không bị ảnh hưởng. Trong chế độ lưu giữ dữ liệu bằng không, chế độ Toàn bộ nội dung vẫn sử dụng được vì API chỉ giữ nội dung được xuất trong bộ nhớ cho đến khi chuyển nội dung đó đến đích đến. Claude Managed Agents không đủ điều kiện áp dụng chế độ lưu giữ dữ liệu bằng không, và các điều khoản lưu giữ dữ liệu của dịch vụ này không thay đổi khi sử dụng OpenTelemetry.

Về việc tính toán token, tài liệu hướng dẫn người dùng chỉ tính mỗi token một lần bằng cách cộng các span từ một nguồn duy nhất cho mỗi yêu cầu; nếu một yêu cầu có cả span SDK lẫn API thì dùng các span API. Tài liệu cũng lưu ý rằng span có thể được gửi đến nhiều lần khi hệ thống thử gửi lại.

Các tích hợp được nêu tên và chia sẻ ban đầu từ khách hàng

Thông báo phân nhóm các nền tảng giám sát được hỗ trợ theo trường hợp sử dụng. Để gỡ lỗi tác tử cùng với các thành phần còn lại trong ngăn xếp phần mềm, thông báo nêu tên Grafana Cloud, Honeycomb, Sentry và Splunk. Tại đây, trace của tác tử nằm cạnh nhật ký và chỉ số, giúp nhà phát triển xác định dịch vụ nào gây ra một bước xử lý chậm hoặc thất bại. Để cải thiện tác tử bằng dữ liệu trong môi trường thực tế, thông báo nêu tên Arize AI, Braintrust, Datadog, Langfuse, LangSmith của LangChain, New Relic và PostHog; các ứng dụng được mô tả gồm chuyển trace thực tế thành các bài đánh giá và phát hiện vấn đề về chất lượng. Để theo dõi mức sử dụng trong toàn tổ chức, thông báo nêu tên Databricks Unity Gateway, nơi các nhóm nền tảng và bảo mật có thể xem mức sử dụng token theo nhóm và cảnh báo hoạt động bất thường.

Một số khách hàng đầu tiên đã chia sẻ về cách triển khai trong thông báo. Roman Shtylman, đồng sáng lập kiêm CTO của Foxglove, cho biết công ty xây dựng các tác tử giúp các nhóm robot gỡ lỗi robot của họ. Ông nói thêm rằng khả năng xuất OpenTelemetry tích hợp sẵn từ Claude Platform cho phép công ty phân tích các tương tác của tác tử trong PostHog bên cạnh dữ liệu sử dụng sản phẩm, qua đó đánh giá hiệu suất của tác tử trong thực tế và ưu tiên các cải tiến cho những nhóm robot.

Kỹ sư phần mềm cấp cao của Ramp, David Traina, cho biết công ty đã xây dựng Reflect, một hệ thống tác tử chấm điểm các trace trong Langfuse, tìm ra những lỗi lặp lại và đề xuất cách khắc phục. “Với một số tác tử, chúng tôi đã giảm mức sử dụng token từ 10–20% và giúp các phiên chạy nhanh hơn 30%,” Traina nói, đồng thời cho biết tính năng xuất OpenTelemetry tích hợp sẵn từ Claude API có thể đưa dữ liệu đo đạc trực tiếp vào vòng lặp cải tiến đó mà không cần thêm bước nào.

Giám đốc công nghệ của Sterling Labs, Hyon Lee, cho biết tính năng xuất tích hợp sẵn truyền mọi trace vào Langfuse mà không cần đo đạc tùy chỉnh cho các tác tử của công ty đang phân tích thị trường trực tiếp. Trưởng bộ phận hạ tầng của FloQast, Ankush Sharma, cho biết các tác tử của công ty phần mềm kế toán này chạy trên Claude Platform, với dữ liệu đo đạc được ghi nhận trong Grafana Cloud. Nhờ vậy, mỗi lệnh gọi mô hình nằm trong cùng một trace với quy trình đối chiếu hoặc quy trình ghi sổ bút toán mà tác tử thực hiện, giúp công ty có thể trả lời câu hỏi của kiểm toán viên về những gì một tác tử đã làm dựa trên một dòng thời gian duy nhất.