Mertani Documentation

Log Integrasi digunakan untuk memonitor dan mengaudit seluruh aktivitas pengiriman data dari Mertani ke server eksternal (push-based / webhook). Setiap pengiriman dicatat secara otomatis, termasuk pengiriman yang berhasil, gagal, maupun yang melalui proses retry.

Cara Mengakses Log Integrasi

Buka menu Manajemen Integrasi

Masuk ke menu Instansi → Integrasi. Halaman ini menampilkan daftar semua integrasi yang telah dikonfigurasi.Kolom yang tersedia:

Kolom	Keterangan
Nama Integrasi	Nama integrasi yang diberikan saat konfigurasi
Deskripsi	Catatan tambahan tentang integrasi
Tanggal Dibuat	Waktu integrasi pertama kali dibuat
Pengiriman Terakhir	Timestamp pengiriman data terakhir ke server tujuan

Pilih integrasi

Klik baris integrasi yang ingin diperiksa. Halaman log integrasi akan terbuka.

Tampilan Matriks Log

Setelah memilih integrasi, log ditampilkan dalam bentuk matriks Device × Tanggal:

Baris -> daftar device yang tergabung dalam integrasi
Kolom -> tanggal dalam bulan yang dipilih
Isi sel -> jumlah pengiriman pada hari tersebut, ditampilkan sebagai:
- Angka hijau -> jumlah pengiriman berhasil
- Angka merah -> jumlah pengiriman gagal
- - -> tidak ada pengiriman / tidak ada gagal / tidak ada berhasil

Gunakan filter bulan/tahun di pojok kanan atas untuk berpindah antar periode.

Gunakan kolom pencarian “Cari device id” di kiri atas untuk menemukan device tertentu jika daftar device sangat panjang.

Melihat Detail Log per Device

Klik sel pada matriks (kombinasi device + tanggal) untuk membuka halaman detail log pengiriman.

Kolom Tabel Detail Log

Kolom	Keterangan
Waktu Record Data	Timestamp data dari device, kapan data tersebut dicatat oleh sensor
Created at	Waktu pertama kali sistem mencoba mengirim data ke server tujuan
Updated at	Waktu terakhir sistem memperbarui status pengiriman (termasuk setelah retry)
Jumlah Retry	Berapa kali sistem mencoba ulang pengiriman setelah gagal
Status	Status akhir pengiriman: Berhasil atau Gagal
Detail	Tombol untuk melihat isi lengkap HTTP request yang dikirim

Filter Status

Gunakan dropdown “Semua Status” di kanan atas untuk menyaring tampilan:

Semua Status -> tampilkan semua log
Berhasil -> hanya pengiriman yang sukses
Gagal -> hanya pengiriman yang gagal (berguna untuk troubleshooting)

Detail Pesan (Message Log)

Klik tombol “Detail” pada baris log untuk melihat isi lengkap HTTP request yang dikirimkan sistem ke server tujuan. Informasi yang ditampilkan:

POST https://[endpoint-server-tujuan]

Headers {"content-type":"application/json"}

Body
{ ... payload data sensor ... }

Result
{ ... response dari server tujuan ... }

Bagian	Keterangan
Method & URL	Metode HTTP dan endpoint server tujuan yang menerima data
Headers	Header request yang dikirim (termasuk content-type)
Body	Payload data sensor dalam format JSON yang dikirimkan
Result	Response dari server tujuan, digunakan untuk memverifikasi apakah server berhasil menerima data (HTTP 200/201) atau mengembalikan error

Detail pesan ini berguna untuk memverifikasi bahwa format data yang dikirim sudah sesuai dengan yang diharapkan oleh server tujuan.

Memahami Retry Mechanism

Jika pengiriman pertama gagal, sistem akan mencoba mengirim ulang secara otomatis menggunakan pola Exponential Backoff interval antar percobaan semakin lama semakin panjang untuk menghindari beban berlebih pada server tujuan.

Spesifikasi Retry

Parameter	Nilai
Maksimal percobaan	10x retry
Pola interval	Exponential backoff (interval bertambah secara eksponensial setiap retry)
Perilaku setelah retry ke-10	Sistem berhenti mencoba, status pengiriman menjadi Gagal secara permanen

Ilustrasi Pola Backoff

Setiap kali retry gagal, sistem menunggu lebih lama sebelum mencoba kembali:

Percobaan 1  → langsung setelah gagal
Percobaan 2  → menunggu lebih lama
Percobaan 3  → menunggu lebih lama lagi
...
Percobaan 10 → percobaan terakhir
Setelah itu  → sistem berhenti, status = Gagal permanen

Pendekatan ini mencegah sistem membanjiri server tujuan yang sedang bermasalah dengan request berulang dalam waktu singkat.

Membaca Kolom Jumlah Retry

Nilai Retry	Interpretasi
`-` atau `0`	Pengiriman berhasil di percobaan pertama
`1` – `9`	Sempat gagal, berhasil setelah beberapa percobaan ulang
`10` + status Gagal	Semua 10 percobaan gagal — sistem telah berhenti mencoba
`1–9` + status Gagal	Masih dalam proses retry atau baru saja gagal

Kemungkinan Penyebab Kegagalan

Kondisi	Kemungkinan penyebab
Retry tinggi, akhirnya Berhasil	Server tujuan sempat tidak stabil tetapi pulih sebelum retry ke-10
Retry 10x, tetap Gagal	Server down dalam waktu lama, endpoint salah, atau timeout konsisten
Gagal tanpa retry	Kegagalan pada percobaan pertama yang tidak memicu retry (misalnya error konfigurasi)

Data yang mencapai retry ke-10 dan tetap gagal tidak akan dikirim ulang secara otomatis. Jika data tersebut penting, hubungi tim Mertani untuk penanganan lebih lanjut.

Getting Started

Monitoring & Data

Devies

Configuration

Access Control

Log Integration (Push-Based)

Cara Mengakses Log Integrasi

Tampilan Matriks Log

Melihat Detail Log per Device

Kolom Tabel Detail Log

Filter Status

Detail Pesan (Message Log)

Memahami Retry Mechanism

Spesifikasi Retry

Ilustrasi Pola Backoff

Membaca Kolom Jumlah Retry

Kemungkinan Penyebab Kegagalan

Referensi Terkait

Webhook API

Integration Method

​Cara Mengakses Log Integrasi

​Tampilan Matriks Log

​Melihat Detail Log per Device

​Kolom Tabel Detail Log

​Filter Status

​Detail Pesan (Message Log)

​Memahami Retry Mechanism

​Spesifikasi Retry

​Ilustrasi Pola Backoff

​Membaca Kolom Jumlah Retry

​Kemungkinan Penyebab Kegagalan

​Referensi Terkait

Webhook API

Integration Method

Cara Mengakses Log Integrasi

Tampilan Matriks Log

Melihat Detail Log per Device

Kolom Tabel Detail Log

Filter Status

Detail Pesan (Message Log)

Memahami Retry Mechanism

Spesifikasi Retry

Ilustrasi Pola Backoff

Membaca Kolom Jumlah Retry

Kemungkinan Penyebab Kegagalan

Referensi Terkait