Diagnostik sistem dan analitik penggunaan
Sistem menampilkan host/runtime, sedangkan Penggunaan menampilkan model dan penyedia. Buka melalui /system dan /usage; keduanya hanya untuk peran admin. Data tetap di dalam instance; telemetri eksternal dijelaskan di Observability.
Diagnostik
/system menampilkan host, platform, kernel, arsitektur, uptime, CPU/load, containerization, versi, PID, direktori, memori, filesystem / dan DATA_DIR, jaringan, serta Docker.
Refresh setiap 30 detik. GET /api/system memerlukan autentikasi dan administrator, dibatasi 120 permintaan per pengguna per 15 menit, dengan Cache-Control: no-store.
Ketergantungan socket
Urutannya WORK_DOCKER_SOCKET, DOCKER_HOST unix:// atau HTTP tcp://, lalu /var/run/docker.sock. ssh://, npipe://, dan TLS tcp:// tidak ditanyakan. Hanya GET, 4 detik, respons terbatas, maksimum 100 kontainer.
Tanpa socket, bagian lain tetap bekerja dan menjelaskan penyebabnya.
Data yang terlihat
ID pendek, nama, image, status, dan waktu. Environment, label, mount, command, payload inspect, dan credentials tidak ditampilkan. Host, direktori, IP, dan semua kontainer asli terlihat; peran Libre admin pada deployment Docker secara efektif adalah administrator host.
Analitik penggunaan
Halaman penggunaan (/usage) memetakan kerja model dan penyedia berdasarkan pengguna. Pengukuran dilakukan pada batas eksekusi yang didukung dan meliputi:
- Chat Ollama lokal dan Work berbasis Ollama;
- panggilan chat CLI agen terpasang dan panggilan mesin Strands;
- chat plugin streaming dan nonstreaming;
- embeddings, gambar, pengenalan dan sintesis suara, audio, serta video plugin;
- panggilan Work berbasis plugin.
Operasi latar belakang tanpa pengguna pemilik sengaja tidak diberikan akun buatan dan tidak diukur. Panggilan gagal atau dibatalkan tetap dicatat.
Setiap event mencatat:
- ID penyedia/plugin dan snapshot nama (
ollamadanagent-cli:*memakai ledger yang sama dengan penyedia plugin) - kemampuan (
chat,embedding,image,stt,tts,audio,video) - model
- status
success,error, ataucancelled(stream terhenti dihitung dibatalkan) - token hanya jika penyedia mengembalikan metadata penggunaan
- unit kemampuan: karakter TTS, gambar, input embeddings, pekerjaan video, byte audio
- durasi menyeluruh dan timestamp
- ID pengguna peminta
Tidak ada data lain yang disimpan. Prompt, respons, endpoint, kredensial, dan isi kesalahan penyedia tidak pernah ditulis ke tabel penggunaan. Kegagalan hanya dicatat sebagai status = 'error'. Event berada dalam SQLite untuk solo atau PostgreSQL untuk team selama 400 hari. Baris lama dibersihkan saat penulisan bila memungkinkan, paling banyak sekali sehari. Pengukuran bersifat best-effort dan tidak boleh membuat permintaan model atau penyedia gagal.
Halaman menyediakan rentang 7, 30, dan 90 hari melalui endpoint administrator GET /api/plugins/usage?days=<1..365> (default 30). Tampil total panggilan, token terlapor, tingkat keberhasilan, latensi rata-rata, serta porsi panggilan dengan token. Pembacaan tidak mengubah state dan memakai ledger yang sudah ada.
Penggunaan agen
Bagian Agen di atas (Panggilan ke agen CLI dan mesin Strands) memisahkan Claude Code, Codex, OpenCode, Pi, dan Strands. Ditampilkan panggilan, token, kegagalan atau pembatalan, durasi rata-rata, serta hingga 20 model teratas. Total agen mencakup semua panggilan periode tersebut, terlepas dari batas tampilan tabel penyedia dan model. Ini bagian dari total halaman, bukan event tagihan tambahan.
Agen tanpa catatan menunjukkan Tidak ada panggilan tercatat dalam periode ini. Itu tidak menjelaskan apakah CLI terpasang atau masuk. Tanpa metadata token, tampil Token tidak dilaporkan; nilai tidak diperkirakan. Halaman yang terlihat menyegarkan setiap 20 detik dan mendukung penyegaran manual.
Penggunaan CLI mencatat satu pemanggilan dan penghitung dari CLI. Snapshot kumulatif menggantikan yang lama, sementara laporan langkah berulang dideduplikasi. Cache dan penalaran digabung menurut protokol CLI tanpa menghitung subset dua kali. Pembatalan serta jawaban parsial dengan exit gagal tetap mempertahankan hasil sebenarnya.
Panggilan Strands dicatat atas nama agen Strands. Mesin ini tidak memiliki penyedia model sendiri; setiap panggilan model yang dilakukannya melewati penyedia Ollama atau plugin milik Libre WebUI. Panggilan luar LWUI tidak diimpor, dan catatan lama tanpa token tetap tidak terukur.
Endpoint menyediakan rincian terbatas dalam agents, termasuk kelima nama walaupun penghitungnya nol. Membacanya tidak menemukan model CLI, memulai agen, atau menghubungi penyedia. Server lama tanpa kolom ini dapat menampilkan catatan agen dari rincian penyedia, tetapi entri yang hilang tidak dianggap penggunaan nol yang pasti.
Menjelajahi model dan penyedia
Warna model menghubungkan grafik harian, kalender aktivitas tahunan, tabel model, dan bar penyedia; nama model, nilai, serta penanda pilihan menyertai warna tersebut. Kalender aktivitas selalu mencakup 365 hari terakhir, terlepas dari rentang yang dipilih, dan warna setiap hari menandai model yang paling banyak dipakai hari itu.
Grafik harian beralih antara Panggilan dan Token. Arahkan pointer ke sebuah model di legenda atau pindahkan fokus keyboard ke sana untuk menelusuri garis model itu. Pilih model agar sorotannya bertahan, pilih lagi untuk melepasnya, atau pilih Tampilkan semua model untuk mengatur ulang. Tabel model juga menyediakan aksi sorot. Menyorot hanya mengubah penekanan; total harian, nilai tabel, dan total penyedia tetap sama. Gerakkan pointer di grafik atau gunakan Jelajahi penggunaan harian untuk memeriksa total satu hari beserta rinciannya per model; penggeser harian mendukung keyboard (tombol panah berpindah antarhari, Home/End menuju hari pertama/terakhir). Bucket harian dan labelnya memakai UTC.
Secara bawaan grafik menampilkan 12 nama model teratas berdasarkan jumlah panggilan pada periode terpilih, termasuk saat melihat token. Setiap model tetap dapat diperiksa sendiri: fokuskan atau pilih model di tabel atau di detail penyedia untuk memuat garis hariannya yang tepat, bahkan jika model itu di luar 12 tersebut; pesan pemuatan menyebut nama model yang diminta. Garis model tambahan dipisahkan dari Model lainnya, dan grup sisanya tidak lagi memuat panggilan, token yang dilaporkan, serta kegagalan model itu. Grafik berisi paling banyak 13 garis model bernama ditambah grup sisa, dan nilai hariannya tetap cocok dengan total yang sama; pilih Tampilkan semua model untuk kembali ke tampilan bawaan.
Garis harian menggabungkan panggilan dengan nama model tercatat yang sama lintas penyedia, sedangkan tabel model mempertahankan entri penyedia/model terpisah sehingga satu model bisa muncul di lebih dari satu penyedia. Model bernama mempertahankan warnanya sendiri di tabel dan bar penyedia, termasuk model di luar grafik bawaan. Detail penyedia menampilkan porsi permintaan tiap penyedia, bar yang terbagi per model, token yang dilaporkan, panggilan gagal atau dibatalkan, dan waktu respons rata-rata; komposisi kapabilitas tetap tersedia di bawahnya.
Total token hanya mencakup panggilan yang metadata penggunaannya dilaporkan penyedia. Persentase cakupan membuat pelaporan parsial terlihat; jumlah token yang hilang tidak pernah diperkirakan dari permintaan atau dari model lain. Periode tanpa token yang dilaporkan menampilkan penjelasan pada tampilan token, sementara riwayat permintaannya tetap tersedia pada tampilan panggilan.
Endpoint menyertakan titik model harian dalam modelSeries. Parameter kueri opsional model meminta satu nama model tercatat yang persis bersama 12 teratas bawaan, misalnya GET /api/plugins/usage?days=30&model=<encoded-model-name>. Ini endpoint yang sama, khusus administrator dan hanya baca: ia mengueri ledger penggunaan lokal dan tidak pernah memanggil penyedia model untuk mengambil riwayat.
Parameter opsional to mengunci batas akhir permintaan ke timestamp Unix dalam milidetik. Parameter ini memerlukan model dan hanya menerima bilangan bulat aman non-negatif yang tidak lebih baru dari waktu server saat ini. Saat memuat satu model, peramban mengirim range.to milik ikhtisar sehingga batas hari dan tahun UTC-nya terjaga dan panggilan setelah timestamp itu dikecualikan. Tanpa to, endpoint memakai waktu saat ini.
Memuat sebuah model membiarkan kartu, tabel, total penyedia, dan warna ikhtisar tetap di tempatnya. Garis hariannya baru ditambahkan bila batas waktu dan total harian pada respons cocok dengan ikhtisar tersebut. Batas waktu tidak membekukan basis data: jika backfill historis atau penghapusan mengubah total itu, peramban menyegarkan ikhtisar sebelum menampilkan garis model. Jika server lama tidak mengirim modelSeries, grafik menampilkan seri agregat Semua model disertai penjelasan bahwa rincian per model tidak tersedia; tabel model tetap tersedia dan peramban tidak menyimpulkan riwayat model harian dari total periode atau kalender tahunan.
Untuk pricing dan budget, lihat Tata kelola biaya. Event tanpa harga tetap tidak dinilai.
Atribusi OpenRouter
Sejak 0.18.0, HTTP-Referer: https://librewebui.org, title, dan category hanya dikirim ke https://openrouter.ai, bukan ke custom/self-hosted.