Panduan Developer untuk Mengintegrasikan Didit dengan Tumpukan Observabilitas Modern (ID)

Integrasi Tanpa HambatanAPI Didit yang bersih dan desain yang mengutamakan developer memungkinkan integrasi langsung dengan alat observabilitas terkemuka seperti Grafana, Loki, dan Tempo.

Pemantauan yang DitingkatkanDengan menginstrumentasi proses verifikasi identitas Didit, developer dapat memperoleh visibilitas real-time ke status sesi, tingkat keberhasilan, dan potensi hambatan.

Debugging ProaktifManfaatkan pelacakan terdistribusi dengan Tempo untuk menemukan masalah dalam alur kerja identitas yang kompleks, memastikan penyelesaian cepat dan dampak minimal bagi pengguna.

Performa yang DioptimalkanArsitektur modular dan AI-native Didit, dikombinasikan dengan observabilitas yang kuat, membantu mengoptimalkan performa dan keandalan layanan verifikasi identitas Anda, sambil menawarkan KYC Inti Gratis.

Pentingnya Observabilitas dalam Verifikasi Identitas

Dalam lanskap digital saat ini, verifikasi identitas bukan lagi sekadar centang; ini adalah pilar dasar kepercayaan dan keamanan. Seiring dengan pertumbuhan bisnis dan interaksi pengguna menjadi lebih kompleks, proses verifikasi identitas yang mendasarinya harus kuat, andal, dan transparan. Di sinilah tumpukan observabilitas modern berperan. Alat-alat seperti Grafana untuk visualisasi, Loki untuk log, dan Tempo untuk jejak memberikan pandangan komprehensif tentang kesehatan dan kinerja aplikasi Anda. Mengintegrasikan ini dengan platform verifikasi identitas Anda, seperti Didit, sangat penting untuk pemantauan proaktif, debugging cepat, dan memastikan pengalaman pengguna yang mulus.

Tanpa observabilitas yang tepat, masalah seperti kegagalan verifikasi, tantangan deteksi keaktifan, atau proses Verifikasi ID yang lambat dapat tidak terdeteksi, menyebabkan pengguna frustrasi, risiko kepatuhan, dan potensi penipuan. Dengan menginstrumentasi API Didit, developer dapat mengubah data verifikasi mentah menjadi wawasan yang dapat ditindaklanjuti, sehingga lebih mudah untuk mengidentifikasi tren, mendiagnosis masalah, dan terus meningkatkan alur kerja identitas mereka.

Menginstrumentasi Sesi Didit dengan Log (Loki) dan Metrik (Grafana)

Pendekatan API-first Didit membuatnya sangat mudah untuk mengintegrasikan pengumpulan log dan metrik ke dalam alur kerja verifikasi identitas Anda. Saat Anda membuat sesi verifikasi menggunakan API Didit, Anda menerima session_id dan status. Ini adalah titik data penting untuk observabilitas.

Logging dengan Loki

Untuk setiap panggilan ke API Didit, terutama saat membuat sesi atau menerima webhook, Anda harus mencatat detail yang relevan. Loki adalah pilihan yang sangat baik untuk ini karena pengindeksan berbasis labelnya, yang membuatnya efisien untuk kueri. Berikut adalah cara Anda dapat mendekatinya:

// Pseudocode untuk mencatat pembuatan sesi
const diditResponse = await didit.createSession({
  workflow_id: 'your-workflow-id',
  callback: 'https://yourapp.com/verification-complete',
  vendor_data: 'user-123'
});

logger.info('Sesi Didit dibuat', {
  session_id: diditResponse.session_id,
  workflow_id: diditResponse.workflow_id,
  status: diditResponse.status,
  vendor_data: diditResponse.vendor_data,
  service: 'identity-verification-service',
  component: 'didit-api-integration'
});

Ketika Didit mengirim webhook yang memberi tahu Anda tentang pembaruan sesi (misalnya, perubahan status, verifikasi berhasil, atau kegagalan), catat peristiwa ini dengan detail serupa. Ini memungkinkan Anda untuk mencari Loki untuk semua log yang terkait dengan session_id atau vendor_data tertentu untuk memahami siklus hidup lengkap dari upaya verifikasi. Misalnya, jika pengguna mengalami masalah dengan Verifikasi ID Didit yang gagal, Anda dapat dengan cepat memfilter log untuk melihat perubahan status yang tepat dan pesan kesalahan apa pun.

Metrik dengan Grafana

Untuk analisis kuantitatif, ekspos metrik dari aplikasi Anda yang berinteraksi dengan Didit. Metrik umum meliputi:

• didit_session_created_total: Penghitung untuk total sesi yang dimulai.
• didit_session_status_total{status="success"}: Penghitung untuk verifikasi yang berhasil.
• didit_session_status_total{status="failed"}: Penghitung untuk verifikasi yang gagal.
• didit_session_duration_seconds: Histogram atau ringkasan untuk waktu yang dibutuhkan dari pembuatan sesi hingga selesai.
• didit_api_request_duration_seconds: Histogram untuk waktu respons API.

Metrik ini, yang diekspos melalui Prometheus dan divisualisasikan di Grafana, menyediakan dasbor yang menunjukkan kesehatan dan kinerja keseluruhan sistem verifikasi identitas Anda. Anda dapat mengatur peringatan untuk penurunan tiba-tiba dalam tingkat keberhasilan atau peningkatan latensi, yang menunjukkan potensi masalah dengan Deteksi Keaktifan Didit atau komponen lainnya.

Pelacakan Terdistribusi untuk Alur Kerja Kompleks (Tempo)

Aplikasi modern sering melibatkan beberapa layanan mikro yang berkomunikasi untuk menyelesaikan satu permintaan pengguna. Verifikasi identitas tidak terkecuali, terutama saat mengorkestrasi berbagai pemeriksaan seperti Penyaringan AML, Bukti Alamat, dan Verifikasi Telepon & Email. Pelacakan terdistribusi, yang didukung oleh alat seperti Tempo, menjadi sangat diperlukan di sini.

Ketika pengguna memulai alur verifikasi identitas, Anda dapat memulai jejak baru. Saat aplikasi Anda melakukan panggilan ke API Didit, dan saat webhook Didit memicu tindakan selanjutnya dalam sistem Anda, Anda harus menyebarkan konteks jejak (misalnya, ID jejak OpenTelemetry). Ini memungkinkan Anda untuk melihat seluruh perjalanan permintaan verifikasi di semua layanan yang terlibat, dari inisiasi frontend hingga keputusan verifikasi akhir.

// Pseudocode untuk menggunakan OpenTelemetry dengan panggilan API Didit
import { trace } from '@opentelemetry/api';

const tracer = trace.getTracer('my-app-didit-integration');

async function verifyUser(userData) {
  const span = tracer.startSpan('didit.createSession');
  try {
    // Tambahkan atribut yang relevan ke span
    span.setAttribute('user.id', userData.id);
    span.setAttribute('workflow.id', 'your-workflow-id');

    const diditResponse = await didit.createSession({
      workflow_id: 'your-workflow-id',
      callback: 'https://yourapp.com/verification-complete',
      vendor_data: userData.id
    });

    span.setAttribute('didit.session_id', diditResponse.session_id);
    span.setAttribute('didit.status', diditResponse.status);
    span.setStatus({ code: SpanStatusCode.OK });
    return diditResponse;
  } catch (error) {
    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
    span.recordException(error);
    throw error;
  } finally {
    span.end();
  }
}

Jika pengguna melaporkan masalah dengan Estimasi Usia atau proses Verifikasi NFC mereka, Anda dapat menggunakan ID pengguna atau ID sesi untuk mencari Tempo. Jejak akan menunjukkan dengan tepat layanan atau panggilan API eksternal mana (seperti API Didit) yang menyebabkan latensi atau gagal, memberikan wawasan yang tak ternilai untuk debugging dan optimasi kinerja.

Bagaimana Didit Membantu

Didit dirancang dari awal untuk mengutamakan developer, membuat integrasi dengan tumpukan observabilitas modern tidak hanya mungkin, tetapi juga mulus. Arsitektur modular kami memungkinkan Anda untuk memasang dan menjalankan pemeriksaan identitas, yang masing-masing dapat diinstrumentasi secara individual untuk pemantauan yang unggul. Platform AI-native Didit memastikan bahwa proses inti seperti Verifikasi ID, Liveness Pasif & Aktif, dan Pencocokan Wajah 1:1 & Pencarian Wajah memiliki kinerja tinggi dan andal, dan desain API kami yang kuat menyediakan titik masuk dan keluar yang jelas untuk data observabilitas Anda.

Kami menawarkan KYC Inti Gratis, menghilangkan hambatan finansial untuk memulai dengan verifikasi identitas penting. Platform kami menghasilkan data identitas terstruktur, yang ideal untuk dimasukkan ke dalam sistem logging dan metrik Anda. Baik Anda melacak tingkat keberhasilan Estimasi Usia Didit untuk kepatuhan atau memantau kinerja Verifikasi NFC kami untuk aplikasi keamanan tinggi, Didit menyediakan transparansi yang Anda butuhkan. Tidak ada biaya pengaturan, dan model pembayaran per pemeriksaan berhasil kami memastikan Anda hanya membayar untuk apa yang Anda gunakan, membuatnya mudah untuk menskalakan upaya observabilitas Anda seiring dengan pertumbuhan bisnis Anda.

Siap Memulai?

Siap melihat Didit beraksi? Dapatkan demo gratis hari ini.

Mulai verifikasi identitas secara gratis dengan tingkat gratis Didit.