Lewati ke konten

Reports

Report menghasilkan berkas CSV atau PDF dari data metrik yang tersimpan, sekali jalan atau terjadwal. Menu: Reports.

Daftar report dengan kolom Format, Jadwal, dan Run terakhir.

Halaman detail report punya bagian Konfigurasi (tab Konfigurasi, Metrik, Template, dan Jadwal dan e-mail), Hasil, Lainnya, Access, dan Journals.

Isian Keterangan
Nama, Deskripsi, Judul report Judul tercetak di berkas hasil.
Rentang waktu Mulai: Mundur dari akhir (angka + m, h, d, atau w, misalnya 1h, 1d, 7d, 2w) atau tanggal dan waktu absolut. Akhir: Sekarang, atau tanggal (tanggal saja berarti sampai akhir hari itu). Maksimal 366 hari.
Zona waktu Nama zona IANA, misalnya Asia/Jakarta.
Format PDF atau CSV. PDF hanya tersedia bila administrator server memasang layanan PDF.
Agregasi dan Interval Tanpa agregasi, rata-rata, min, max, sum, atau count, dengan interval seperti 30s, 5m, 1h, 1d (30 detik sampai 31 hari, maksimal 100.000 bucket).
Metrik (tab Metrik) Sampai 20: nama nilai persis (bn + n), channel, dan opsional device atau subtopik. Hanya data numerik yang tersimpan lewat rule.
Editor report: tab Konfigurasi, Metrik, Template, dan Jadwal dan e-mail dengan tombol Kirim lewat e-mail dan Buat sekarang.
Editor report.

Tab Template berisi template HTML untuk tata letak PDF (dengan pratinjau). Template dirender dengan html/template (data di-escape), lalu hasilnya divalidasi dengan daftar putih: tanpa script, iframe, form, atribut on*, atau sumber eksternal. Gambar hanya boleh berupa data:image/.

  • Buat sekarang menjalankan laporan seketika. Bagian Hasil menampilkan riwayat run dan berkas hasil (unduh), dan menyegarkan diri otomatis saat ada run aktif.
  • Kirim lewat e-mail mengirim berkas ke penerima yang Anda isi untuk satu run.
  • Satu report tidak bisa menumpuk antrean: bila ada run berjalan, permintaan baru ditolak (report.busy).

Tab Jadwal dan e-mail memakai model yang sama dengan rule terjadwal: tanggal dan jam mulai, zona waktu, pengulangan, dan kelipatan. Untuk run terjadwal Anda bisa mengisi penerima e-mail (maksimal 10) dan subjek. Berkas dikirim sebagai lampiran. Run terjadwal dilewati bila run sebelumnya belum selesai.

  • CSV memuat kolom time, metric, name, value, unit, dengan waktu di zona report. Bila data melebihi batas baris server (bawaan 200.000), run gagal dengan pesan jelas (report.rows_limit) alih-alih memotong diam-diam. Persempit rentang atau naikkan interval agregasi.
  • Ukuran berkas maksimal 25 MiB bawaan. Berkas disimpan di database.
  • PDF dibuat oleh layanan Chromium/Gotenberg yang dipasang administrator. Tanpa itu, run PDF gagal (report.pdf_unavailable) sementara CSV tetap jalan.
  • Hasil run disimpan sesuai masa retensi server (bawaan 30 hari).

Scope report: read (daftar dan unduh), write (buat, ubah, pratinjau), delete, execute (Generate dan Email). Mendukung izin per objek dan tab Access.