Belajar SOAP - Logging, Monitoring & Troubleshooting

#Pendahuluan

Setelah di episode 12 kita mempertahankan performansi, sekarang kita bahas kemampuan bertahan hidup yang sesungguhnya: logging, monitoring, dan troubleshooting. Service SOAP enterprise adalah kotak hitam — request masuk, response keluar, dan ketika ada yang salah, satu-satunya jalan keluar adalah data yang kita catat.

Mengapa penting? Coba bayangkan: klaim asuransi gagal diproses, tetapi service berjalan normal dan tidak ada error. Tanpa log payload, tanpa correlation ID, kalian tidak punya cara membuktikan request mana yang bermasalah dan di titik mana gagalnya. Observability SOAP adalah disiplin yang menyelamatkan kalian dari investigasi berhari-hari.

#Logging Payload dan Header

SOAP adalah XML lengkap yang bisa dicatat — tapi apa yang dicatat harus disaring. Ada tiga level:

#Log yang Wajib

#Header Logging di CXF

Apache CXF menyediakan log interceptor bawaan — aktifkan di fase in dan out:

<bean id="loggingInInterceptor"
  class="org.apache.cxf.interceptor.LoggingInInterceptor"/>
<bean id="loggingOutInterceptor"
  class="org.apache.cxf.interceptor.LoggingOutInterceptor"/>
 
<jaxws:endpoint address="/bank" serviceName="bank">
  <jaxws:inInterceptors>
    <ref bean="loggingInInterceptor"/>
  </jaxws:inInterceptors>
  <jaxws:outInterceptors>
    <ref bean="loggingOutInterceptor"/>
  </jaxws:outInterceptors>
</jaxws:endpoint>

#Jangan Log Semua — Filter

Strategi umum di produksi:

1. Default: log metadata (header, ukuran, durasi, fault), tanpa body.
2. Debug mode per-konsumen: aktifkan log body hanya untuk mitra tertentu selama investigasi.
3. Sampling: log body penuh untuk sebagian kecil request (mis. 1%), cukup untuk inspeksi tanpa banjir storage.

#Tracing dengan Correlation ID

Di arsitektur yang melibatkan gateway, ESB, dan beberapa service, satu transaksi bisnis melewati banyak sistem. Correlation ID mengikat semua pesan itu dalam satu benang:

Implementasinya sederhana: buat ID unik (UUID atau format TX-<timestamp>-<seq>), bawa di header SOAP (atau header WS-Addressing), dan log ID yang sama di setiap hop:

<soap:Header xmlns:tx="urn:example:tx">
  <tx:correlationId>TX-20260816-0001</tx:correlationId>
</soap:Header>

Saat ada keluhan "transfer tidak masuk", kalian cari TX-20260816-0001 di log semua service — dan perjalanan transaksi terlihat dalam satu query. Ini wajib untuk produksi.

#Troubleshooting: TCP/IP Monitor

TCP/IP Monitor di SoapUI menangkap request dan response HTTP mentah — berguna saat client dan server berjalan di mesin yang sama dan kalian ingin melihat apa yang benar-benar dikirim:

Local Port : 9999
Server     : localhost
Server Port: 8080

Arahkan client ke http://localhost:9999/bank, monitor menampilkan request HTTP mentah yang diteruskan ke 8080 dan response dari server. Ini membuktikan apakah masalah ada di pembuatan pesan client atau di pemrosesan server.

#Troubleshooting TLS dengan -Djavax.net.debug

Ketika koneksi HTTPS gagal dengan error TLS yang samar, Java menyediakan debug log TLS lengkap:

java -Djavax.net.debug=ssl:handshake:verbose -jar app.jar

Outputnya menampilkan detail handshake: cipher suite yang dinegosiasikan, sertifikat yang dikirim, dan alasan kegagalan (mis. unknown certificate atau certificate expired). Untuk masalah yang lebih umum — truststore yang salah — cek dengan:

keytool -list -keystore $JAVA_HOME/lib/security/cacerts
openssl s_client -connect bank.example.com:443 -showcerts

#Validasi WS-I Compliance

Sebagian besar masalah interoperabilitas SOAP (Java ke .NET ke PHP) sebenarnya adalah pelanggaran WS-I Basic Profile — misalnya memakai rpc/encoded atau pola encoding yang tidak distandarkan. Alat verifikasinya:

• WS-I Test Tools (validator lama, masih relevan untuk audit kepatuhan).
• WS-I Analyzer bawaan di beberapa IDE.
• Pengecekan manual checklist dasar: document-literal, namespace benar, SOAP 1.1/1.2 konsisten, tidak memakai soap:encoding.

Kita bedah WS-I Basic Profile secara penuh di episode 18 — di episode ini, ingat saja: jika dua stack tidak saling bicara dan tidak ada error yang jelas, curigai pelanggaran WS-I.

#Checklist Troubleshooting

Urutan langkah saat service SOAP bermasalah:

1. Buka TCP/IP Monitor — apa yang benar-benar dikirim/diterima?
2. Cek namespace SOAP 1.1 vs 1.2 dan namespace bisnis.
3. Baca Fault — faultcode menentukan arah investigasi (Sender = cek request; Receiver = cek server).
4. Lacak correlation ID di log semua service.
5. Jika HTTPS: openssl s_client + -Djavax.net.debug.
6. Jika lintas stack: validasi WS-I Basic Profile.

#Penutup

Inti yang harus dibawa pulang:

• Log metadata selalu; log body dengan filtering dan masking (regulasi data pribadi).
• Correlation ID di header mengikat transaksi lintas service — wajib untuk produksi.
• TCP/IP Monitor memperlihatkan pesan mentah; openssl s_client dan -Djavax.net.debug untuk TLS.
• Masalah lintas stack yang misterius = curiga pelanggaran WS-I Basic Profile.
• Urutan diagnosis yang jelas menyelamatkan waktu investigasi.

Di episode 14 selanjutnya kita akan membahas WS-Security: konsep & token — OASIS SOAP Message Security 1.1, UsernameToken, X.509 Token, timestamp, header Security, dan alasan message-level signing & encryption tak tergantikan oleh TLS. Sampai jumpa di episode 14!