Skip to content

📘 Modul 11: Observabilitas & Pakem Telescope ​

Pakem Telescope adalah dasbor debug dan observabilitas bawaan yang terinspirasi oleh Laravel Telescope. Dashboard ini memberikan visibilitas penuh terhadap semua request HTTP, query database, background job, event siaran, log error, dan konsumsi memori sandbox WebAssembly secara real-time.


1. Mengakses Dashboard Telescope ​

Dashboard Telescope dapat diakses langsung melalui browser Anda di rute:

👉 http://localhost:8000/pakem/telescope

Tampilan dasbor dibuat sangat modern dengan dark mode, indikator status berwarna, dan integrasi HTMX untuk pembaruan data instan tanpa me-refresh halaman.


2. Kategori Pemantauan ​

Telescope mengelompokkan data ke dalam beberapa tab inspeksi:

TabDeskripsi
RequestsMelacak method HTTP, URL path, status code (200, 404, 500), durasi eksekusi dalam milidetik, dan IP pengunjung.
QueriesMenampilkan query SQL yang dieksekusi, parameter query, serta waktu eksekusi database.
JobsMemantau antrean background jobs (status: pending, running, completed, failed).
EventsDaftar event real-time yang disiarkan melalui Pakem Echo.
LogsLog level info, warning, dan error yang dihasilkan oleh sistem.
SandboxTab baru untuk memantau performa dan konsumsi memori plugin WebAssembly & Indonesian Script.

3. Tab Sandbox & Metrics ​

Dengan kehadiran arsitektur WASM Native Hybrid di Pakem v0.2.0, Telescope menyertakan panel khusus Sandbox Monitor:

  • Loaded WASM Plugins: Daftar biner .wasm aktif yang dimuat ke dalam memori.
  • Cached Indonesian Scripts: Skrip .is yang terkompilasi dalam AST runner cache.
  • Memory Allocation: Halaman memori virtual WebAssembly yang dialokasikan per fungsi guest.
  • Execution Latency: Durasi eksekusi transformasi string dan evaluasi skrip dalam skala mikrodetik (Ξs).

Data ini otomatis disuntikkan oleh PakemPluginManager::get_metrics() dan dapat diinspeksi secara detail per request.


4. Health Checks Endpoint ​

Pakem juga menyediakan endpoint pemeriksaan kesehatan (health check) standar untuk Kubernetes, Docker, dan load balancer:

  • GET /up: Mengembalikan status HTTP 200 jika server aktif dan siap menerima lalu lintas.
  • GET /health: Mengembalikan payload JSON diagnostik (status database pool, penggunaan memori, dan uptime server).

Dirilis di bawah Lisensi MIT. Look like Laravel, Run at Rust Speed.