Belajar Groovy - Operational Readiness & Runbooks

#Pendahuluan

Aplikasi yang sudah dideploy belum berarti selesai. Yang membedakan aplikasi andal dari aplikasi rapuh adalah kesiapan operasional — dokumen runbook, metrik, dan observability yang memadai.

Episode 19 membahas penyiapan runbook untuk deployment dan incident response, metrik operasional, logging dan runtime observability, serta upgrade path dan compatibility check untuk versi Groovy dan JVM.

#Menyiapkan Runbook

#Apa Itu Runbook

Runbook adalah dokumen langkah-demi-langkah untuk menjalankan operasi rutin dan menangani insiden. Runbook yang baik mencakup:

• Deployment: langkah release, rollback, dan verifikasi.
• Incident response: gejala, diagnosis, dan pemulihan.
• Maintenance: backup, rotasi log, dan pembersihan cache.

Tujuan utama runbook: siapa pun bisa mengeksekusi langkah tanpa pengetahuan sebelumnya.

#Deployment Runbook

Deployment runbook untuk aplikasi Groovy berbasis container:

docker pull myapp:1.2.0
docker run -d --name app -p 8080:8080 myapp:1.2.0
curl -f http://localhost:8080/health

docker pull myapp:1.2.0 mengambil image versi tertentu, dan curl -f http://localhost:8080/health memverifikasi aplikasi sehat setelah start. curl -f http://localhost:8080/health menghentikan script dengan kode error jika health check gagal — langkah verifikasi wajib di runbook.

#Incident Response Runbook

Untuk insiden, runbook memberi langkah diagnosis yang terurut:

• Cek dashboard dan alert untuk gejala awal.
• Periksa log aplikasi dan error rate.
• Pindai metrik CPU, memory, dan GC.
• Tentukan apakah perlu rollback atau scale-out.

#Metrik Operasional

#Metrik yang Wajib Dipantau

Aplikasi JVM perlu memantau metrik berikut:

• Latency: waktu respons endpoint.
• Error rate: persentase request yang gagal.
• Traffic: jumlah request per detik.
• Heap usage: penggunaan memory JVM.
• GC pauses: jeda garbage collection.

#Ekspos Metrik dengan Micrometer

Micrometer adalah standar metrik di ekosistem JVM. Contoh sederhana mengekspos metrik dari aplikasi Groovy:

import io.micrometer.core.instrument.MeterRegistry
 
class SapaService {
    final MeterRegistry registry
 
    String sapa(String nama) {
        registry.counter("sapa.requests").increment()
        "Halo, ${nama}"
    }
}

registry.counter("sapa.requests").increment() mencatat setiap pemanggilan. MeterRegistry registry adalah titik masuk Micrometer, yang bisa diekspor ke Prometheus, Datadog, atau platform observability lain.

#Logging dan Observability

#Structured Logging

Log terstruktur memudahkan mesin memproses data:

import groovy.json.JsonOutput
 
def logJson = { level, pesan, extra = [:] ->
    def data = [level: level, pesan: pesan] + extra
    println JsonOutput.toJson(data)
}
 
logJson("info", "Request masuk", [path: "/api/sapa", durasi: 42])

logJson("info", "Request masuk", [path: "/api/sapa", durasi: 42]) menghasilkan satu baris JSON yang bisa diparsing. [level: level, pesan: pesan] + extra menggabungkan map utama dengan field tambahan — log terstruktur seperti ini dipakai tool seperti Loki dan Elasticsearch.

#Runtime Observability

Untuk observability runtime JVM, aktifkan Java Flight Recorder dan pantau melalui JMX:

java -XX:StartFlightRecording=filename=app.jfr,duration=120s -jar app.jar

java -XX:StartFlightRecording=filename=app.jfr,duration=120s -jar app.jar merekam profil aplikasi selama dua menit ke file JFR. File ini bisa dianalisis di JDK Mission Control untuk menemukan bottleneck dan perilaku abnormal.

#Upgrade Path dan Compatibility

#Memeriksa Kompatibilitas

Sebelum upgrade Groovy atau JDK, periksa kompatibilitas:

groovy --version
java -version

groovy --version menampilkan versi Groovy, dan java -version menampilkan versi JDK. java -version penting karena setiap versi Groovy punya jangkauan JDK yang didukung — misalnya Groovy 4.x mendukung JDK 8 hingga 23.

#Strategi Upgrade Bertahap

Upgrade yang aman dilakukan bertahap:

1. Buat branch upgrade dan jalankan seluruh test.
2. Periksa changelog untuk breaking changes.
3. Uji di environment staging terlebih dahulu.
4. Lakukan canary release sebelum full deployment.
5. Siapkan rollback bila terjadi regresi.

#Uji Kompatibilitas Otomatis

Jalankan matriks test terhadap beberapa versi JDK:

JAVA_HOME=/opt/jdk17 gradle test
JAVA_HOME=/opt/jdk21 gradle test

JAVA_HOME=/opt/jdk17 gradle test menjalankan test dengan JDK 17, dan JAVA_HOME=/opt/jdk21 gradle test dengan JDK 21. JAVA_HOME=/opt/jdk21 gradle test memastikan aplikasi bekerja di seluruh versi yang kalian dukung.

#Penutup

Episode 19 membawa aplikasi Groovy kalian menuju kesiapan produksi: runbook untuk deployment dan insiden, metrik operasional, structured logging dan observability, serta strategi upgrade yang aman.

Inti yang harus dibawa pulang:

• Runbook mendokumentasikan deployment dan incident response.
• Pantau latency, error rate, traffic, heap, dan GC pauses.
• Micrometer mengekspos metrik ke platform observability.
• Structured logging menghasilkan baris yang mudah diparsing mesin.
• Periksa kompatibilitas Groovy dan JDK sebelum upgrade.
• Upgrade bertahap dengan test di beberapa versi JDK.

Di episode 20 selanjutnya kita akan membahas security dan compliance — safe execution of dynamic scripts, input validation, sandboxing, pencegahan code injection, serta secure dependency management dan supply chain awareness.