Skip to main content
Flag diagnostik mengaktifkan pencatatan log tambahan untuk satu subsistem tanpa menaikkan logging.level secara global. Sebuah flag tidak berpengaruh kecuali jika diperiksa oleh subsistem.

​
Cara kerjanya

  • Flag adalah string yang tidak peka huruf besar-kecil, diambil dari diagnostics.flags dalam konfigurasi serta penimpaan env OPENCLAW_DIAGNOSTICS, lalu dideduplikasi dan diubah menjadi huruf kecil.
  • name.* cocok dengan name itu sendiri dan semua yang berada di bawah name. (misalnya, telegram.* cocok dengan telegram.http).
  • * atau all mengaktifkan setiap flag.
  • Mulai ulang Gateway setelah mengubah diagnostics.flags dalam konfigurasi; perubahan tersebut tidak dimuat ulang secara langsung.

​
Flag yang diketahui

​
Aktifkan melalui konfigurasi

Beberapa flag:

​
Penimpaan env (sekali pakai)

Nilai dipisahkan berdasarkan koma atau spasi. Nilai khusus: OPENCLAW_DIAGNOSTICS=0 menonaktifkan flag dari env dan konfigurasi untuk proses tersebut, yang berguna untuk membisukan sementara flag profiler yang dibiarkan aktif dalam konfigurasi tanpa mengedit berkas.

​
Flag profiler

Flag profiler mengendalikan rentang pengaturan waktu ringan; tidak menambah beban saat dinonaktifkan. Aktifkan semua rentang yang dikendalikan profiler untuk satu kali proses Gateway:
Aktifkan hanya rentang profiler pengiriman balasan:
Aktifkan hanya rentang profiler startup/alat/utas server aplikasi Codex:
profiler mengaktifkan profiler balasan dan profiler Codex; gunakan nama flag tercakup untuk mengaktifkan hanya salah satunya. Atau tetapkan dalam konfigurasi:
Mulai ulang Gateway setelah mengubah flag konfigurasi. Untuk menonaktifkan flag profiler, hapus flag tersebut dari diagnostics.flags dan mulai ulang, atau mulai proses dengan OPENCLAW_DIAGNOSTICS=0 untuk menimpa setiap flag diagnostik bagi proses tersebut.

​
Artefak lini masa

Flag timeline (alias: diagnostics.timeline) menulis peristiwa pengaturan waktu startup dan runtime terstruktur sebagai JSONL, untuk harness QA eksternal:
Atau aktifkan dalam konfigurasi:
Jalur keluaran selalu berasal dari OPENCLAW_DIAGNOSTICS_TIMELINE_PATH, bahkan saat flag itu sendiri ditetapkan dalam konfigurasi; tidak ada kunci konfigurasi untuk jalur tersebut. Saat timeline hanya diaktifkan dari konfigurasi, rentang pemuatan konfigurasi paling awal tidak tersedia karena OpenClaw belum membaca konfigurasi; rentang startup berikutnya direkam secara normal. OPENCLAW_DIAGNOSTICS=1, =all, dan =* juga mengaktifkan lini masa, karena ketiganya mengaktifkan setiap flag. Utamakan flag tercakup timeline jika Anda hanya menginginkan artefak JSONL dan bukan semua flag diagnostik lainnya. Sampel penundaan loop peristiwa dalam lini masa memerlukan satu persetujuan tambahan selain timeline: tetapkan OPENCLAW_DIAGNOSTICS_EVENT_LOOP=1 (atau on/true/yes) selain mengaktifkan lini masa. Rekaman lini masa menggunakan amplop openclaw.diagnostics.v1 dan dapat mencakup ID proses, nama fase, nama rentang, durasi, ID plugin, jumlah dependensi, sampel penundaan loop peristiwa, nama operasi penyedia, status keluar proses anak, serta nama/pesan kesalahan startup. Perlakukan berkas lini masa sebagai artefak diagnostik lokal; tinjau sebelum membagikannya ke luar mesin Anda.

​
Lokasi log

Flag mengirimkan log ke berkas log diagnostik standar. Secara default:
Jika Anda menetapkan logging.file, gunakan jalur tersebut sebagai gantinya. Log berformat JSONL (satu objek JSON per baris). Redaksi tetap diterapkan berdasarkan logging.redactSensitive. Lihat Pencatatan log untuk resolusi jalur log, rotasi, dan model redaksi selengkapnya.

​
Ekstrak log

Pilih berkas log terbaru:
Filter diagnostik HTTP Telegram:
Filter diagnostik HTTP Brave Search:
Atau pantau saat mereproduksi:
Untuk Gateway jarak jauh, gunakan openclaw logs --follow sebagai gantinya (lihat /cli/logs).

​
Catatan

  • Jika logging.level ditetapkan lebih tinggi daripada warn, log yang dikendalikan flag mungkin disembunyikan. Nilai default info sudah sesuai.
  • brave.http mencatat URL/parameter kueri permintaan Brave Search, status/pengaturan waktu respons, serta peristiwa hit/miss/penulisan cache. Flag ini tidak mencatat kunci API (yang dikirim sebagai header permintaan) atau isi respons, tetapi kueri pencarian dapat bersifat sensitif.
  • Flag aman dibiarkan aktif; flag tersebut hanya memengaruhi volume log untuk subsistem tertentu.
  • Gunakan /logging untuk mengubah tujuan, tingkat, dan redaksi log.

​
Terkait