Bug dalam integrasi model post-trained ke CLI Argus-Red menimbulkan hasil pen-testing yang tidak konsisten dan kadang menggagalkan sesi otomatis. Dalam artikel ini kami langsung menelusuri gejala yang muncul pada layanan backend, sekaligus memaparkan akar penyebab teknis dan langkah perbaikan praktis agar CLI Argus-Red kembali stabil.

Gejala dan Dampak

Tim backend menerima laporan sesi pen-testing Argus-Red CLI tiba-tiba menampilkan status "queued" selamanya, lalu, setelah timeout, mengirimkan beberapa laporan duplikat dengan level keparahan berbeda-beda. Beberapa log tambahan menunjukkan bahwa entri komando yang sama dikirim berulang, dan konsol backend memicu permintaan ke model post-trained yang sama dalam rentang waktu sangat singkat.

Dampaknya adalah penundaan dalam pipeline otomatis, konsumsi sumber daya berlebih pada model post-trained, serta hasil pen-testing yang tidak dapat dipercaya karena data input tidak tersinkronisasi antar retries.

Investigasi Root Cause

Log dan Observasi Awal

Pemeriksaan observability menunjukkan pola berikut:

  • Argus-Red CLI mengirim permintaan via webhook ke endpoint backend setiap kali user menekan Enter dua kali saat berada di daftar target.
  • Backend menerima permintaan dengan payload yang hampir identik sebanyak tiga kali dalam waktu kurang dari 200 ms.
  • Model post-trained tercatat memproses permintaan kedua sebelum respons pertama dikirimkan, memicu dependency race pada penyimpanan sesi.

Log sample dari aplikasi Node.js backend terlihat seperti berikut:

2024-10-XXT12:01:05.123Z INFO Received CLI event { target: '10.0.0.5', action: 'scan', sessionId: 'argus-123' }
2024-10-XXT12:01:05.324Z INFO Received CLI event { target: '10.0.0.5', action: 'scan', sessionId: 'argus-123' }
2024-10-XXT12:01:05.345Z ERROR Model queue busy for session argus-123

Durasi antara permintaan terlalu pendek untuk create session baru, sementara sistem masih menganggap sesi lama aktif.

Akar Masalah Teknikal

Akar masalah teridentifikasi sebagai gabungan dari:

  • Input tidak tervalidasi: CLI Argus-Red mengirimkan event saat Enter ditekan, tanpa memastikan payload berbeda atau jeda minimal.
  • Retry control lemah: Backend langsung mem-forward permintaan ke model post-trained tanpa batasan concurrency per session.
  • Race condition dependency: Penjadwalan session di database Redis tidak memakai locking atau tokenisasi unik, sehingga beberapa proses menulis state "pending" bersamaan.

Karena Argus-Red CLI mengandalkan pengalaman pengguna interaktif, backlog event kecil dapat menumpuk dan menyebabkan kondisi-kondisi tersebut muncul berulang.

Perbaikan Praktis

Observability yang Lebih Tajam

Tambahkan label session di seluruh log dan gunakan tracing header dari Argus-Red CLI agar setiap permintaan dapat ditelusuri dari webhook sampai model post-trained. Gunakan grafana atau Sentry untuk melihat distribusi waktu antar event.

Sanitasi Input dan Debouncing

Perkenalkan middleware validasi sebelum meneruskan permintaan ke model post-trained:

function sanitizeArgusPayload(payload) {
  if (!payload.sessionId || !payload.target) {
    throw new Error('Payload Argus-Red tidak lengkap');
  }
  payload.target = payload.target.trim();
  payload.eventHash = `${payload.sessionId}:${payload.target}:${payload.action}`;
  return payload;
}

Gunakan eventHash untuk mendeteksi duplikasi dalam jangka pendek dan tolak permintaan jika hash sama sudah diterima dalam 500 ms terakhir. Debouncing ini menjaga agar CLI yang mengirimkan entri beruntun tidak memicu pemrosesan ganda.

Kontrol Retry dan Tokenisasi Concurrency

Penerapan token khusus per session membantu mencegah race condition:

const sessionLockKey = `lock:${payload.sessionId}`;
const acquired = await redis.set(sessionLockKey, '1', { NX: true, PX: 2000 });
if (!acquired) {
  throw new Error('Sesi masih diproses, coba beberapa detik lagi');
}
try {
  await processPostTrainedModel(payload);
} finally {
  await redis.del(sessionLockKey);
}

Pemblokiran sementara ini memberikan ruang antar permintaan dan memastikan proses model selesai sebelum entri berikutnya dijalankan.

Regression Test dan CI

Tambahkan pengujian otomatis yang mensimulasikan tiga permintaan Argus-Red CLI dalam waktu singkat, memastikan hanya satu request yang dieksekusi. Gunakan mocking module untuk model post-trained agar pengujian tetap cepat.

Dalam pipeline CI, sertakan langkah observability smoke test yang memeriksa apakah log session ID keluar saat permintaan diteruskan.

Pelajaran untuk Tim Backend

Perbaikan ini memberi beberapa pelajaran:

  • Jangan anggap CLI interaktif selalu rapi: Event ganda atau tekanan tombol berulang akan terjadi. Luangkan waktu untuk *rate-limiting* lokal atau debouncing.
  • Observability lebih awal mencegah spekulasi: Tracing session ID membantu memastikan kita tahu persis permintaan mana yang menyebabkan race.
  • Retry control penting untuk integrasi model berbiaya tinggi: Kontrol concurrency memastikan model tidak dipaksa menangani banyak event serupa sekaligus.
  • Regression test harus mensimulasikan kebiasaan pengguna nyata: UI CLI dapat menghasilkan pola permintaan yang tidak intuitif, jadi tes harus menggambarkan sensornya.

Dengan observability, sanitasi input, retry control, dan regression test yang tepat, tim backend bisa memastikan CLI Argus-Red tetap dapat diandalkan dan aman dalam pen-testing otomatis di masa mendatang.