> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrik server

> Periksa memori proses GOWA, batas container, penggunaan disk, waktu aktif, dan jumlah perangkat.

`GET /app/metrics` mengembalikan snapshot JSON untuk memantau server GOWA. Rute ini menggunakan autentikasi yang dikonfigurasi pada server dan tidak memerlukan `X-Device-Id` atau perangkat terdaftar.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" "$GOWA_URL/app/metrics"
```

Respons menggunakan struktur standar `code`, `message`, dan `results`.

Tetapkan URL server dan kredensial sebelum menjalankan contoh curl. Gunakan URL HTTPS publik untuk server jarak jauh dan sertakan `APP_BASE_PATH` jika dikonfigurasi.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Hasil tingkat teratas

| Field | Arti |
| - | - |
| `version` | Versi kode sumber GOWA. |
| `session_store` | `sqlite` atau `postgres`, dipilih berdasarkan URI database sesi yang dikonfigurasi. |
| `devices.total` | Perangkat terdaftar. |
| `devices.logged_in` | Perangkat dengan sesi WhatsApp yang sudah login. |
| `devices.connected` | Perangkat yang saat ini terhubung ke WhatsApp. |
| `system` | Snapshot proses, memori, folder, dan sistem file. |

Jumlah perangkat yang login dan yang terhubung mengukur status yang berbeda. Sesi yang tersimpan dapat tetap login meskipun perangkatnya terputus.

## Field sistem

| Field di bawah `results.system` | Arti |
| - | - |
| `started_at` | Waktu dalam format RFC 3339 yang dicatat saat inisialisasi proses. |
| `uptime_seconds` | Jumlah detik sejak waktu tersebut, termasuk inisialisasi. |
| `go_version` | Versi runtime Go. |
| `cpu_seconds` | Akumulasi waktu CPU proses dalam detik, termasuk waktu pengguna dan sistem. Nilai ini bukan persentase penggunaan CPU. |
| `memory.heap_alloc_bytes` | Jumlah byte heap Go yang dialokasikan. |
| `memory.runtime_sys_bytes` | Jumlah byte yang diperoleh runtime Go dari sistem operasi. |
| `memory.process_rss_bytes` | Memori residen proses dari `/proc` Linux. |
| `memory.container_bytes` | Memori yang digunakan cgroup container. |
| `memory.container_limit_bytes` | Batas memori container. `null` dapat berarti tanpa batas atau tidak tersedia. |
| `memory.goroutines` | Jumlah goroutine saat ini. |
| `memory.gc_cycles` | Jumlah siklus pengumpulan sampah yang sudah selesai. |
| `folders.media.bytes` dan `.files` | Ukuran dan jumlah entri pada pohon direktori media yang dikonfigurasi. |
| `folders.storages.bytes` dan `.files` | Ukuran dan jumlah entri pada pohon direktori penyimpanan yang dikonfigurasi. |
| `filesystem.total_bytes` | Kapasitas total sistem file yang memuat direktori penyimpanan. |
| `filesystem.free_bytes` | Ruang yang tersedia pada sistem file tersebut. |

> [!NOTE]
>
> Perlakukan metrik bernilai null sebagai tidak diketahui, bukan nol. Waktu CPU dan memori residen proses bergantung pada `/proc` Linux. Memori container menggunakan mount standar `/sys/fs/cgroup`, dengan mencoba cgroup v2 sebelum v1. Field ini dapat bernilai `null` pada platform lain atau saat file terkait tidak tersedia.

Pengukuran folder di-cache selama satu menit. Pengukuran dilakukan sejauh memungkinkan dan mengabaikan entri yang tidak dapat dibaca. Target symlink direktori tidak ditelusuri. Jumlah byte folder tidak mencakup database PostgreSQL jarak jauh dan tidak menggantikan pengukuran ruang kosong sistem file.

## Mengambil snapshot secara berkala

Ambil snapshot dengan interval yang sesuai untuk sistem pemantauan Anda. Bandingkan nilai kumulatif `cpu_seconds` antarsnapshot untuk menghitung penggunaan CPU selama suatu interval. Perhitungkan restart proses dengan memeriksa `started_at` sebelum menghitung selisih.

Gunakan `/app/info` untuk melihat fitur yang diaktifkan, base path, dan batas media. Gunakan `/app/metrics` untuk penggunaan sumber daya. Kedua endpoint dapat digunakan sebelum ada perangkat.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/id/index.md)
- [Praktik Terbaik untuk Produksi](https://gowa-docs.mintlify.site/id/advanced/best-practices.md)
- [Ambil metrik kesehatan server](https://gowa-docs.mintlify.site/id/api-reference/app/ambil-metrik-kesehatan-server.md)
- [Server MCP](https://gowa-docs.mintlify.site/id/integrations/mcp.md)
- [Ambil metadata server](https://gowa-docs.mintlify.site/id/api-reference/app/ambil-metadata-server.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.