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

1

Buka menu Manajemen Integrasi

Masuk ke menu Instansi → Integrasi. Halaman ini menampilkan daftar semua integrasi yang telah dikonfigurasi.Kolom yang tersedia:
KolomKeterangan
Nama IntegrasiNama integrasi yang diberikan saat konfigurasi
DeskripsiCatatan tambahan tentang integrasi
Tanggal DibuatWaktu integrasi pertama kali dibuat
Pengiriman TerakhirTimestamp pengiriman data terakhir ke server tujuan
2

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

KolomKeterangan
Waktu Record DataTimestamp data dari device — kapan data tersebut dicatat oleh sensor
Created atWaktu pertama kali sistem mencoba mengirim data ke server tujuan
Updated atWaktu terakhir sistem memperbarui status pengiriman (termasuk setelah retry)
Jumlah RetryBerapa kali sistem mencoba ulang pengiriman setelah gagal
StatusStatus akhir pengiriman: Berhasil atau Gagal
DetailTombol 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 ... }
BagianKeterangan
Method & URLMetode HTTP dan endpoint server tujuan yang menerima data
HeadersHeader request yang dikirim (termasuk content-type)
BodyPayload data sensor dalam format JSON yang dikirimkan
ResultResponse 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

ParameterNilai
Maksimal percobaan10x retry
Pola intervalExponential backoff (interval bertambah secara eksponensial setiap retry)
Perilaku setelah retry ke-10Sistem 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 RetryInterpretasi
- atau 0Pengiriman berhasil di percobaan pertama
19Sempat gagal, berhasil setelah beberapa percobaan ulang
10 + status GagalSemua 10 percobaan gagal — sistem telah berhenti mencoba
1–9 + status GagalMasih dalam proses retry atau baru saja gagal

Kemungkinan Penyebab Kegagalan

KondisiKemungkinan penyebab
Retry tinggi, akhirnya BerhasilServer tujuan sempat tidak stabil tetapi pulih sebelum retry ke-10
Retry 10x, tetap GagalServer down dalam waktu lama, endpoint salah, atau timeout konsisten
Gagal tanpa retryKegagalan 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.

Referensi Terkait

Webhook API

Panduan konfigurasi endpoint untuk menerima data push dari Mertani

Integration Method

Perbandingan REST API vs Webhook untuk kebutuhan integrasi