ð 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:
| Tab | Deskripsi |
|---|---|
| Requests | Melacak method HTTP, URL path, status code (200, 404, 500), durasi eksekusi dalam milidetik, dan IP pengunjung. |
| Queries | Menampilkan query SQL yang dieksekusi, parameter query, serta waktu eksekusi database. |
| Jobs | Memantau antrean background jobs (status: pending, running, completed, failed). |
| Events | Daftar event real-time yang disiarkan melalui Pakem Echo. |
| Logs | Log level info, warning, dan error yang dihasilkan oleh sistem. |
| Sandbox | Tab 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
.wasmaktif yang dimuat ke dalam memori. - Cached Indonesian Scripts: Skrip
.isyang 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).
Navigasi Modul: â
- Sebelumnya: Modul 10: Queue, Jobs & Scheduler
- Berikutnya: Modul 12: Deployment & DevOps â
- Kembali ke: Daftar Isi Dokumentasi