Pantau eksekusi pipeline

Halaman ini membahas semua hal setelah sebuah eksekusi dimulai: menemukannya, membaca apa yang dilakukan setiap langkah, dan membuat eksekusi yang gagal berjalan lagi. Untuk memulainya, lihat Jalankan pipeline secara manual.

Menemukan eksekusi

Klik Pipeline di bilah sisi ruang kerja. Layar ini adalah antrean eksekusi ruang kerja — semua eksekusi, terbaru lebih dulu.
Gunakan rel kiri untuk memfilter. Ada tepat tiga filter, masing-masing dengan jumlah langsung: Semua, Berjalan, Gagal.
Telusuri tabel dengan ↑/↓ (atau j/k) dan tekan Enter untuk membuka eksekusi yang sedang difokuskan. Mengklik baris melakukan hal yang sama.

Setiap baris menampilkan glif tentang bagaimana eksekusi dimulai (ikon putar untuk manual; glif berkas untuk pemantauan graf kode; selain itu pemicu otomatis). Keterangan yang muncul saat kursor diarahkan menyebutkan pemicunya — Manual, PR dipublikasikan, Perubahan file, dan seterusnya — dan, untuk eksekusi pemantauan, berkas mana yang berubah. Lalu nama pipeline, lencana status, durasi aktif (atau posisi antrean untuk eksekusi queued) dan berapa lama sejak percobaan ini dimulai. Durasi aktif tidak menghitung jeda menganggur saat berhenti lalu mulai ulang, jadi bukan rentang waktu sebenarnya.

Tidak ada filter untuk eksekusi yang selesai, ditangguhkan, atau dibatalkan, tidak ada filter per templat, tidak ada jendela waktu, dan tidak ada tampilan riwayat eksekusi per templat. Membandingkan eksekusi dari satu templat berarti menelusuri antrean untuk mencari namanya.

Membaca detail eksekusi

Halaman sebuah eksekusi terdiri atas tiga bagian bertumpuk.

Strip meta memuat waktu mulai, durasi aktif, kemajuan langkah (“3 dari 7 langkah”), ringkasan kegagalan yang menyebutkan langkah yang gagal beserta alasannya, dan tindakan Coba lagi serta Hapus.

Waterfall waktu memberi satu batang per langkah, lengkap dengan durasinya dan — untuk langkah agen — biayanya dalam sen. Langkah yang dicoba ulang menampilkan akhiran ×N setelah durasinya; akhiran itu satu-satunya tempat jumlah percobaan muncul.

Kanvas graf menggambar templat dengan status langsung setiap node. Memilih sebuah node akan membuka panel langkahnya.

Status eksekusi dan langkah

Status	Arti
Menunggu	Dibuat, belum dimulai
Dalam antrean	Diterima tetapi ditahan: batas paralel maksimum templat ini penuh; belum ada baris langkah
Berjalan	Sedang dieksekusi
Ditangguhkan	Menunggu sesuatu dari luar — normal, bukan macet
Selesai	Selesai dengan sukses
Gagal	Berakhir dengan galat
Dibatalkan	Dihentikan oleh pengguna atau oleh sistem

Langkah memiliki status-status itu tanpa Dalam antrean, ditambah Dilewati, untuk cabang yang tidak diambil router (beserta keturunan yang karenanya tidak lagi terjangkau).

Ditangguhkan adalah tempat sebagian besar umur sebuah langkah agen dihabiskan: agen yang dikirim atau gerbang persetujuan menahan langkah itu sampai pekerjaannya selesai. Dua jaring pengaman mesin menggagalkan seluruh eksekusi alih-alih melanjutkannya: langkah yang ditangguhkan lebih lama daripada 24 jam (extras.awaitApproval — badan orchestration.awaitApproval — dikecualikan; human.gate tidak) dan langkah non-idempoten yang sedang berjalan ketika server berhenti.

Memeriksa sebuah langkah

Pilih node di kanvas. Panel langkah menampilkan, secara berurutan:

Kotak Error saat langkah gagal, atau kotak Dilewati beserta alasannya saat langkah dilewati.
Dimulai, Selesai, dan durasi.
Branch — indeks cabang, untuk cabang paralel.
Lihat percakapan — melompat ke percakapan tempat langkah dijalankan. Percakapan pipeline disembunyikan dari bilah sisi, jadi ini satu-satunya cara masuk.
Input dan Output, sebagai JSON yang dapat dilipat.
Aktivitas agen — satu ubin per eksekusi agen yang dikirim langkah tersebut, dengan status, ringkasan, durasi, dan biayanya.

Untuk langkah agen, Output adalah payload terstruktur yang dikirim agen melalui submit_output, bukan prosanya. Jejak penalaran berada di Aktivitas agen dan di percakapan yang ada di balik Lihat percakapan.

Untuk langkah bash, Output adalah stdout yang telah dipangkas dan ditulis skrip saat keluar dengan kode 0. Keluar dengan kode bukan nol menggagalkan langkah dengan ekor stderr sebagai pesan galatnya.

Memulihkan eksekusi yang gagal

Baca ringkasan kegagalan di strip meta; ringkasan itu menyebutkan langkah yang gagal. Kotak Error di panel langkah memuat pesannya.
Periksa Input langkah — kunci state yang hilang atau salah ejaan adalah penyebab paling umum. Langkah prompt-agent langsung gagal dan menyebutkan placeholder yang belum terselesaikan; langkah bash merendernya sebagai string kosong dan tetap berjalan, yang biasanya baru muncul satu langkah kemudian.
Untuk langkah agen, buka Lihat percakapan dan baca apa yang sebenarnya dilakukan agen.
Tekan Coba lagi di strip meta. Langkah yang selesai dan dilewati mempertahankan outputnya; semua yang lain dihapus lalu dieksekusi ulang, dan eksekusi kembali berjalan. Penghitung durasi dimulai ulang untuk percobaan ini.

Penyebab umum yang layak diperiksa lebih dahulu:

Batas waktu — langkah melewati Batas waktu (ms)-nya. Ingat, kolom itu dalam milidetik.
Kesalahan skrip — perintah bash keluar dengan kode bukan nol, atau bash tidak ada di PATH host server.
Validasi skema — payload submit_output milik agen tidak memenuhi skema output langkah.
Placeholder yang belum terselesaikan — {{key}} yang dirujuk langkah prompt-agent tidak pernah ditulis di hulu. Pesan galatnya menyebutkan setiap kunci yang belum terselesaikan.
Badan yang tidak terdaftar — langkah yang kunci badannya tidak terdaftar memberi peringatan saat templat dimuat lalu tidak pernah dieksekusi.

Menghentikan langkah yang macet

Pilih langkah yang sedang berjalan dan tekan tombol Hentikan yang berjalan di header panel langkah. Ini mematikan proses langkah tersebut, menandai langkah gagal sehingga menggagalkan seluruh eksekusi — setiap cabang saudara yang masih terbuka ditutup bersamanya.

Tidak ada kontrol pembatalan eksekusi di layar ini. pipeline.cancel ada sebagai operasi RPC dan mesin mengimplementasikannya, tetapi tidak ada apa pun di UI pipeline yang memanggilnya; Hentikan yang berjalan pada sebuah langkah, atau Hapus pada eksekusinya, adalah satu-satunya cara menghentikan yang tersedia.

Melacak biaya

Biaya dilaporkan per langkah, di kolom kanan waterfall dan pada setiap ubin di bawah Aktivitas agen. Tidak ada total eksekusi di halaman detail dan tidak ada kolom biaya di antrean eksekusi, jadi membandingkan biaya dua eksekusi berarti menjumlahkan langkah-langkahnya.

Panduan terkait

Konsep terkait

Pipeline