# Trace

Source: https://instatus.com/help/vi/observability/traces

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](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Tìm](https://instatus.com/help/vi/observability/traces#tìm-yêu-cầu-chậm-và-lỗi) | status:error, duration:>1s, service: |
| [Mở](https://instatus.com/help/vi/observability/traces#mở-một-trace) | Nhấp vào một dòng để xem biểu đồ thác |
| [Sửa](https://instatus.com/help/vi/observability/traces#sửa-một-yêu-cầu-lỗi) | Sao chép prompt sửa lỗi cho agent lập trình |
| [Log](https://instatus.com/help/vi/observability/traces#mở-một-trace) | Chuyển đến log của một yêu cầu |

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](https://instatus.com/help/vi/observability/send-logs#cách-1-sao-chép-prompt), 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](https://instatus.com/help/vi/observability/logs#lọc). Các bộ lọc sau dành cho trace:

| Bộ lọc          | Tìm thấy                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | Các yêu cầu bị lỗi                                |
| `duration:>1s`  | Yêu cầu chậm hơn một giây. Cũng có `>500ms`, `<100ms` |
| `service:api`   | Yê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ào   | Như `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](https://instatus.com/help/observability/trace-waterfall.png)

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](https://instatus.com/help/observability/trace-error.png)

**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.

- [Chỉ số](https://instatus.com/help/vi/observability/metrics): Phát hiện thay đổi, thay đổi lớn nhất lên đầu
- [Log](https://instatus.com/help/vi/observability/logs): Tìm kiếm, lọc và theo dõi log trực tiếp
