# Trace

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

Trace adalah satu permintaan yang diikuti melalui setiap layanan yang dilewatinya. Setiap langkah adalah span: panggilan HTTP, kueri database, panggilan ke layanan lain. Trace menunjukkan ke mana permintaan lambat menghabiskan waktunya dan di mana permintaan yang gagal rusak.

Buka **Observability** → **Trace** di halaman status Anda. Setiap baris adalah satu permintaan.

![Penjelajah trace dengan durasi permintaan dari waktu ke waktu dan satu baris per permintaan](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Temukan](https://instatus.com/help/id/observability/traces#temukan-permintaan-lambat-dan-gagal) | status:error, duration:>1s, service: |
| [Buka](https://instatus.com/help/id/observability/traces#buka-trace) | Klik baris untuk melihat waterfall-nya |
| [Perbaiki](https://instatus.com/help/id/observability/traces#perbaiki-permintaan-yang-gagal) | Salin prompt perbaikan untuk agen coding Anda |
| [Log](https://instatus.com/help/id/observability/traces#buka-trace) | Lompat ke log permintaan |

Trace tiba setelah aplikasi Anda mengirimnya: centang **Trace** saat [menyalin prompt penyiapan](https://instatus.com/help/id/observability/send-logs#opsi-1-salin-prompt), atau gunakan instrumentasi otomatis.

## Baca grafik

Setiap titik adalah satu permintaan, ditempatkan menurut waktu dan durasinya. Titik merah berarti gagal. Di atas grafik:

- **Trace**: berapa banyak permintaan yang ditemukan pencarian.
- **Error**: berapa yang gagal, dan porsinya.
- **p50**, **p95**, **p99**: setengah, 95%, dan 99% permintaan lebih cepat dari nilai ini.

Seret di grafik untuk memperbesar jendela waktu.

## Temukan permintaan lambat dan gagal

Gunakan kotak pencarian seperti di halaman [Log](https://instatus.com/help/id/observability/logs#filter). Filter berikut dibuat untuk trace:

| Filter          | Menemukan                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | Permintaan yang gagal                                |
| `duration:>1s`  | Permintaan yang lebih lambat dari satu detik. Juga `>500ms`, `<100ms` |
| `service:api`   | Permintaan yang ditangani satu layanan                     |
| `span.name:`    | Span dengan nama tertentu, seperti `GET /v1/users`    |
| Atribut apa pun   | Seperti `http.route:` atau `http.response.status_code:` |

Teks bebas mencari di nama span. **Span root** aktif secara default, jadi setiap permintaan muncul sekali. Matikan untuk menampilkan setiap span secara terpisah.

Tombol unduh mengekspor daftar sebagai CSV.

## Buka trace

Klik sebuah baris. Trace terbuka dengan setiap span di linimasa, bersarang di bawah span yang memanggilnya. Batang panjang menunjukkan ke mana waktu habis.

![Trace yang melintasi tiga layanan, dengan panggilan lambat ke Okta di bagian bawah waterfall](https://instatus.com/help/observability/trace-waterfall.png)

Dalam contoh ini, memuat halaman butuh 842 ms. Waterfall menunjukkan alasannya: `web` memanggil `api`, `api` memanggil `sso`, dan `sso` menunggu Okta selama 468 ms.

- Klik span untuk melihat atributnya, seperti rute, kode status, atau kueri database.
- **N log dari span ini** membuka log yang ditulis selama span itu.
- **N log** di bagian atas membuka setiap log permintaan, di semua layanan.
- **Salin ID trace** menyalin ID, untuk dibagikan atau dicari dengan `trace_id:`.
- Gunakan **↑** **↓** atau **J** **K** untuk pindah ke trace sebelumnya atau berikutnya, dan **Esc** untuk menutup.

## Perbaiki permintaan yang gagal

Span yang gagal berwarna merah. **Hanya error** menyembunyikan span yang berhasil, agar kegagalan menonjol di trace yang panjang.

![Permintaan yang gagal, dengan span error berwarna merah dan tombol untuk menyalin prompt perbaikan](https://instatus.com/help/observability/trace-error.png)

**Salin prompt untuk memperbaiki** menyalin deskripsi permintaan yang gagal: span, error, dan atributnya. Tempelkan ke agen coding Anda di proyek aplikasi, dan agen akan punya semua yang dibutuhkan untuk menemukan penyebabnya.

- [Metrik](https://instatus.com/help/id/observability/metrics): Temukan yang berubah, perubahan terbesar lebih dulu
- [Log](https://instatus.com/help/id/observability/logs): Cari, filter, dan pantau log secara langsung
