Trace

Một trace là một yêu cầu, được theo dõi qua mọi dịch vụ mà nó đi qua. Mỗi bước là một span: một lệnh gọi HTTP, một truy vấn cơ sở dữ liệu, một lệnh gọi đến dịch vụ khác. Trace cho bạn thấy yêu cầu chậm tốn thời gian ở đâu và yêu cầu lỗi hỏng ở đâu.

Mở Observability → Trace trên trang trạng thái của bạn. Mỗi dòng là một yêu cầu.

Trình khám phá trace với thời lượng yêu cầu theo thời gian và mỗi yêu cầu một dòng

Trace sẽ đến khi ứng dụng của bạn gửi chúng: đánh dấu Trace khi sao chép prompt thiết lập, hoặc dùng tính năng tự động đo đạc.

Đọc biểu đồ

Mỗi chấm là một yêu cầu, đặt theo thời điểm và thời lượng. Chấm đỏ là yêu cầu lỗi. Phía trên biểu đồ:

  • Trace: số yêu cầu mà tìm kiếm tìm thấy.
  • Lỗi: số yêu cầu lỗi và tỷ lệ của chúng.
  • p50, p95, p99: một nửa, 95% và 99% yêu cầu nhanh hơn giá trị này.

Kéo trên biểu đồ để phóng to một khung thời gian.

Tìm yêu cầu chậm và lỗi

Dùng ô tìm kiếm như trên trang Log. Các bộ lọc sau dành cho trace:

Bộ lọcTìm thấy
status:errorCác yêu cầu bị lỗi
duration:>1sYêu cầu chậm hơn một giây. Cũng có >500ms, <100ms
service:apiYêu cầu do một dịch vụ xử lý
span.name:Span có tên cụ thể, như GET /v1/users
Bất kỳ thuộc tính nàoNhư http.route: hoặc http.response.status_code:

Văn bản tự do tìm trong tên span. Span gốc bật sẵn, nên mỗi yêu cầu hiện một lần. Tắt nó để liệt kê từng span riêng.

Nút tải xuống xuất danh sách dưới dạng CSV.

Mở một trace

Nhấp vào một dòng. Trace mở ra với mọi span trên dòng thời gian, lồng dưới span đã gọi nó. Thanh dài là nơi tốn thời gian.

Một trace đi qua ba dịch vụ, với lệnh gọi chậm đến Okta ở cuối biểu đồ thác

Trong ví dụ này, tải một trang mất 842 ms. Biểu đồ thác cho thấy lý do: web gọi api, api gọi sso, và sso chờ Okta 468 ms.

  • Nhấp vào một span để xem thuộc tính, như route, mã trạng thái hoặc truy vấn cơ sở dữ liệu.
  • N log từ span này mở các log được ghi trong span đó.
  • N log ở trên cùng mở mọi log của yêu cầu, trên tất cả dịch vụ.
  • Sao chép ID trace sao chép ID để chia sẻ hoặc tìm bằng trace_id:.
  • Dùng ↑ ↓ hoặc J K để chuyển sang trace trước hoặc sau, và Esc để đóng.

Sửa một yêu cầu lỗi

Span lỗi có màu đỏ. Chỉ lỗi ẩn các span chạy tốt, để lỗi nổi bật trong một trace dài.

Một yêu cầu lỗi, với các span lỗi màu đỏ và nút sao chép prompt sửa lỗi

Sao chép prompt để sửa sao chép mô tả của yêu cầu lỗi: các span, lỗi và thuộc tính của chúng. Dán vào agent lập trình trong dự án ứng dụng, và agent sẽ có đủ thông tin để tìm nguyên nhân.